EntrarTeste grátis

MCP e IA · Atualizado em 12/10/2026

Como conectar um agente de IA ao Pipe

Crie a chave de Agente de IA (MCP) na Gestão e conecte o Claude Code, o Claude Desktop ou outro cliente MCP à URL do Pipe.

Neste artigo
  1. Quando usar
  2. Pré-requisitos
  3. Passo a passo
  4. Conectar o Claude Code
  5. Conectar o Claude Desktop
  6. Outros clientes MCP
  7. Testar com curl
  8. Resultado esperado
  9. Problemas comuns
  10. Boas práticas
  11. Próximos passos
  12. Perguntas frequentes

Conectar é um trabalho de uma vez só: você cria uma chave de Agente de IA (MCP) na Gestão, informa a URL e a chave no cliente de IA, e pronto. A chave define o que o agente enxerga e o que ele pode propor.

Quando usar

Sempre que quiser que um agente de IA configure ou consulte o atendimento por você. Se prefere integrar um sistema seu por código, use a API.

Pré-requisitos

  • Acesso às configurações do fluxo na Gestão.
  • Claude Code, Claude Desktop (com Node.js instalado, para a ponte mcp-remote) ou outro cliente que fale MCP por HTTP.

Passo a passo

  1. Na Gestão, abra o fluxo e vá em Configurações, depois Chaves de acesso.
  2. Clique em Nova chave e dê um nome que diga para que ela serve.
  3. No campo Agente de IA (MCP), escolha o nível de acesso (veja a tabela abaixo).
  4. Salve e copie a chave que aparece. Ela começa com pipe_.
  5. Conecte o cliente de IA, como mostrado nas seções abaixo.
  6. Peça ao agente: "Por onde eu começo?". Ele chama o checklist da conta e responde com o que falta.

Níveis da chave

Opção na telaPara quê
Só leitura da configuraçãoOlhar e aprender, sem mudar nada
Leitura e propostas de mudançaConfigurar o atendimento: filas, horários, regras, respostas, SLA e pausas
Completo: atendimento, mensagens e fluxos (sempre com confirmação)Operar o fluxo inteiro: bot, modelos, conversas, envios e relatórios

A chave de um fluxo só enxerga e altera o próprio fluxo. Para itens da conta inteira, como membros, papéis e plano, é preciso uma chave da organização, descrita em Escopos da chave.

Conectar o Claude Code

claude mcp add --transport http pipe https://http.pipebr.app/mcp \
  --header "Authorization: Bearer pipe_xxxxxxxxxxxx_yyyyyyyy"

Confira com claude mcp list. Dentro do Claude Code, o comando /mcp mostra o servidor, as ferramentas e os prompts.

Conectar o Claude Desktop

O conector personalizado da interface pede OAuth, que o Pipe ainda não oferece. Use a ponte mcp-remote no arquivo claude_desktop_config.json:

{
  "mcpServers": {
    "pipe": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://http.pipebr.app/mcp", "--header", "Authorization:${PIPE_AUTH}"],
      "env": { "PIPE_AUTH": "Bearer pipe_xxxxxxxxxxxx_yyyyyyyy" }
    }
  }
}

Reinicie o Claude Desktop depois de salvar o arquivo.

Outros clientes MCP

Qualquer cliente que fale MCP por HTTP serve. Informe:

  • URL: https://http.pipebr.app/mcp
  • Transporte: HTTP (Streamable HTTP), somente POST, com resposta em JSON e sem sessão. GET responde 405.
  • Autenticação: cabeçalho Authorization: Bearer pipe_… em toda requisição.

Testar com curl

curl -s https://http.pipebr.app/mcp -H "Authorization: Bearer $PIPE_KEY" -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_setup_status","arguments":{}}}'

Resultado esperado

O cliente lista as ferramentas do Pipe, e a chamada de get_setup_status devolve o checklist da conta, com o que está pronto, o que falta e a próxima ação.

Problemas comuns

  • Resposta 401: a chave não foi enviada ou está errada.
  • Resposta 403: a chave não tem a permissão básica de leitura, ou a chamada veio de um navegador.

Veja todos os casos em Solução de problemas do MCP.

Boas práticas

  • Use uma chave por agente ou por pessoa, para poder revogar uma sem afetar as outras.
  • Comece com Só leitura da configuração e suba o nível quando confiar no fluxo de trabalho.

Próximos passos

Perguntas frequentes

Qual é a URL do MCP do Pipe?

https://http.pipebr.app/mcp. O mesmo caminho também responde em https://api.pipebr.app/mcp. O transporte é HTTP, só com POST.

Como o agente se autentica?

Com a chave do Pipe em toda requisição, no cabeçalho Authorization: Bearer pipe_… (ou Key, com identificador e chave em base64). Não há cookie nem OAuth.

Posso conectar pelo conector personalizado do Claude Desktop?

Ainda não: ele pede OAuth, que o Pipe não oferece. Use a ponte mcp-remote no arquivo claude_desktop_config.json, como no exemplo deste artigo.

Como testo se a conexão funciona?

Faça uma chamada de get_setup_status com curl, como no exemplo, ou rode claude mcp list no Claude Code.