> ## Documentation Index
> Fetch the complete documentation index at: https://docs.jelou.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Workflows como MCP

> Exponha os workflows do seu projeto como ferramentas MCP para que agentes de IA externos possam descobri-los e invocá-los.

**MCP** (Model Context Protocol) é o padrão aberto que clientes como Claude Desktop, Cursor e os agentes de IA modernos usam para descobrir e invocar ferramentas externas. Com **Workflows como MCP**, cada projeto do Brain Studio vira um servidor MCP: o agente lê os workflows que você habilitou, invoca-os quando precisa e recebe a resposta em tempo real.

É só execução. Você continua construindo e publicando workflows no Brain Studio como sempre — o MCP apenas os expõe para que outros agentes os consumam, sem escrever uma integração sob medida para cada cliente.

<Note>
  Esta capacidade é ativada no nível da organização. Se você não vê o toggle **Habilitar MCP** no nó **Start**, fale com a sua equipe de conta para liberá-la.
</Note>

## Como funciona

| Passo | O que acontece |
| - | - |
| **1. Configuração** | Você liga o toggle **Habilitar MCP** no nó **Start** de cada workflow que quer expor. |
| **2. Conexão** | O cliente MCP se autentica no projeto com uma chave de API e abre uma sessão isolada por projeto. |
| **3. Descoberta** | O agente chama `skill_list` e recebe os workflows habilitados como ferramentas, cada um com nome, descrição e inputs. |
| **4. Execução** | O agente chama `skill_execute` com o contexto do usuário. O servidor mantém a thread ativa e emite as mensagens em streaming. |
| **5. Estado** | `execution_status` e `execution_cancel` fecham o ciclo quando é preciso consultar ou cancelar uma execução em andamento. |

## Habilitar um workflow como MCP

<Steps>
  <Step title="Abra o nó Start">
    No canvas do workflow, clique no nó **Start** para abrir seu painel de configuração.
  </Step>

  <Step title="Vá até a aba Avançado">
    Selecione a aba **Avançado**. Logo abaixo de **Ocultar workflow** está **Habilitar MCP**.

    <Frame caption="Toggle Habilitar MCP na aba Avançado do nó Start">
      <img src="https://mintcdn.com/jelouai/xWe4Wm2xc0_r-bwr/assets/images/mcp/workflow_as_mcp_pt.png?fit=max&auto=format&n=xWe4Wm2xc0_r-bwr&q=85&s=986915fffef6a7718702b7bbf0212438" alt="Painel de configuração do nó Start com a aba Avançado aberta e o toggle Habilitar MCP destacado" width="2704" height="1282" data-path="assets/images/mcp/workflow_as_mcp_pt.png" />
    </Frame>
  </Step>

  <Step title="Ative o toggle">
    Ligue **Habilitar MCP**. O workflow passa a ser exposto como ferramenta MCP e aparecerá no `skill_list` dos agentes conectados ao projeto.
  </Step>

  <Step title="Copie a URL do servidor">
    Clique no ícone de engrenagem para abrir **Configuração de MCP**. Ali você encontra a **URL do servidor MCP** do projeto, um exemplo de uso em cURL e um link direto para suas chaves de API.
  </Step>

  <Step title="Publique o projeto">
    Agentes externos só enxergam workflows publicados. Publique uma nova versão para que a mudança chegue à produção.
  </Step>
</Steps>

<Tip>
  Habilite o MCP apenas nos workflows que você quer oferecer para fora. Cada workflow habilitado aparece no catálogo do agente e disputa sua atenção na hora de escolher a ferramenta.
</Tip>

## Conectar um cliente MCP

O servidor MCP existe no nível do projeto. Sua URL segue este formato:

```bash theme={null}
https://gateway.jelou.ai/workflows/mcp/{projectId}
```

A autenticação usa uma chave de API da sua empresa, enviada no header `x-api-key`. Crie-a em **Configurações** > **Chaves de API**.

```bash title="Listar as ferramentas disponíveis" theme={null}
curl -X POST 'https://gateway.jelou.ai/workflows/mcp/{projectId}' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -H 'x-api-key: SUA_CHAVE_DE_API' \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/list",
    "params": {}
  }'
```

Qualquer cliente compatível com MCP — Claude Desktop, Cursor ou um agente próprio sobre OpenAI, Bedrock ou um framework interno — se conecta com essa URL e essa chave.

<Warning>
  A chave de API dá acesso para executar todos os workflows com MCP habilitado do projeto. Guarde-a como um segredo e rotacione-a se suspeitar que foi exposta.
</Warning>

## Ferramentas do servidor

| Ferramenta | O que faz |
| - | - |
| `skill_list` | Devolve os workflows publicados com MCP habilitado, cada um com nome, descrição e inputs. |
| `skill_execute` | Executa um workflow com o contexto do usuário e emite as mensagens em streaming conforme avança. |
| `execution_status` | Consulta o estado de uma execução em andamento. |
| `execution_cancel` | Cancela uma execução em andamento. |

<Note>
  Via MCP só são executados workflows já publicados. Criar, editar ou publicar workflows continua sendo trabalho da interface do Brain Studio — o agente externo não consegue modificá-los.
</Note>

## A descrição do workflow pesa mais

Com MCP, a descrição que você escreveu para o AI Routing ganha um leitor novo: o LLM do cliente. É o único insumo que ele tem para decidir se invoca o seu workflow, então uma descrição vaga degrada a escolha da ferramenta do mesmo jeito que degrada o roteamento interno.

<Tip>
  Uma boa descrição diz quais solicitações o workflow atende, o que ele resolve e em quais contextos deve ser executado. O mesmo esforço rende em dobro: melhora o AI Routing dentro do projeto e a seleção de ferramenta fora dele.
</Tip>

## Nós não suportados

Quando um agente externo invoca o workflow via MCP, os componentes que dependem do canal nativo do WhatsApp não são renderizados da mesma forma. O que o usuário final vê depende do cliente MCP que orquestra a conversa: no Claude Desktop, no Cursor ou em um agente próprio, esses elementos chegam como texto ou como uma estrutura genérica, não como widgets nativos.

Com MCP habilitado, o canvas marca estes nós com a etiqueta **Não suportado como MCP**:

| Categoria | Nós e componentes |
| - | - |
| **WhatsApp** | `WhatsApp Flows`, `HSM`, `Webview`, `Mensagem com URL`, `Call to action` |
| **Atendimento humano** | `Jelou` (Inbox), `HubSpot`, `Genesys` |
| **Mensagens** | `Contato`, `Localização` |
| **Outros** | `Marketplace`, `Consumo` |

<Warning>
  Esses nós não são executados quando o workflow é usado como ferramenta MCP. Se o seu workflow depende de algum deles, desenhe um caminho alternativo antes de expô-lo.
</Warning>

<Note>
  Por enquanto o WhatsApp é o único canal de origem suportado. Outros canais serão adicionados conforme a demanda.
</Note>

## Casos de uso

<AccordionGroup>
  <Accordion title="Agente próprio que precisa de biometria e KYC">
    Uma equipe técnica com um agente sobre OpenAI ou Bedrock que não pretende migrar seu stack: habilita como MCP os workflows de verificação de identidade do projeto e seu agente os invoca quando detecta que precisa validar um usuário, sem tocar em APIs proprietárias nem manter um cliente sob medida.
  </Accordion>

  <Accordion title="Parceiro integrador que orquestra várias ferramentas">
    Um parceiro constrói um agente vertical que combina CRM, e-mail e as capacidades da Jelou: expõe os workflows de onboarding e validações como MCP e os orquestra a partir de um único cliente, junto com o resto das suas ferramentas.
  </Accordion>

  <Accordion title="Demo do projeto a partir do Claude Desktop ou do Cursor">
    Uma equipe comercial conecta o Claude Desktop à URL MCP do projeto e percorre as capacidades do canal diante de um prospect sem abrir o Brain Studio nem preparar um ambiente de teste.
  </Accordion>

  <Accordion title="Capacidades compartilhadas entre vários consumidores">
    Um workflow de consulta de status de pedido atende os usuários do WhatsApp e, com MCP habilitado, também o agente interno que a equipe de suporte usa. Uma só implementação, dois consumidores, a mesma lógica de negócio.
  </Accordion>
</AccordionGroup>

<CardGroup cols={2}>
  <Card title="AI Routing" icon="route" href="/pt/guias/primeiros-passos/ai-routing">
    Escreva as descrições que o AI Router e os agentes MCP usam para escolher o workflow.
  </Card>

  <Card title="Chaves de API" icon="key" href="/pt/guias/configuracao/chaves-api">
    Crie e rotacione a chave de API com a qual o cliente MCP se autentica.
  </Card>

  <Card title="Publicar versões" icon="upload" href="/pt/guias/primeiros-passos/publicar-versoes">
    Publique o projeto para que os workflows habilitados cheguem aos agentes externos.
  </Card>

  <Card title="Execuções de workflow" icon="play" href="/pt/guias/primeiros-passos/execucoes-workflow">
    Monitore as execuções que chegam de clientes MCP.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.