Como conectar o Claude Code ao Chatfuel

O Claude Code se conecta ao Chatfuel com um único comando claude mcp add e um login pelo /mcp. Você pode adicionar o servidor do dia a dia para gerenciar bots, o servidor para desenvolvedores com toda a API GraphQL do Chatfuel, ou os dois com nomes diferentes.

Como adicionar o servidor do Chatfuel

1. Execute este comando no seu terminal:

   claude mcp add --transport http chatfuel https://mcp.chatfuel.com/panel

2. Abra o Claude Code, execute /mcp, escolha chatfuel e faça login no Chatfuel no navegador.

O servidor chatfuel dá ao Claude Code as ferramentas prontas do Chatfuel para bots, Automations, a Knowledge Base, respostas a comentários, chats e agendamentos.

Como adicionar a API completa do Chatfuel

Para scripts, integrações e tarefas que as ferramentas prontas não cobrem, adicione o servidor para desenvolvedores com um nome próprio:

claude mcp add --transport http chatfuel-api https://mcp.chatfuel.com/panel/api

Depois execute /mcp, escolha chatfuel-api e faça login. Os dois servidores são conexões separadas, então você faz login em cada um que adicionar. O que o servidor para desenvolvedores acrescenta está em MCP ou API MCP: qual link do Chatfuel usar.

Como conectar o Claude Code com um CLI token

Use um CLI token quando o Claude Code não conseguir abrir o navegador, por exemplo em uma máquina remota ou em CI. Passe o token em um cabeçalho:

claude mcp add --transport http chatfuel-api https://mcp.chatfuel.com/panel/api --header "Authorization: Bearer <token>"

Substitua <token> pelo seu CLI token do Chatfuel. Qualquer pessoa com o token pode acessar a sua conta do Chatfuel, então mantenha-o fora de arquivos e repositórios compartilhados. Onde criar o token está em login, acesso somente leitura e CLI token no Chatfuel MCP.

O que posso pedir ao Claude Code?

Exemplos:

• "Mostre meus bots e quais estão com a IA ativada."
• "Revise meus chats recentes e liste as perguntas que as perguntas frequentes não cobrem."
• "Escreva um script que liste os meus leads em Qualified" (com chatfuel-api).

Mais pedidos estão em exemplos de prompts para o Chatfuel MCP. Para o Claude na web e no app para desktop, veja como conectar o Claude ao Chatfuel.

Problemas comuns

O Claude Code mostra que o servidor precisa de autenticação

Execute /mcp, escolha o servidor do Chatfuel e faça login de novo. O login pode ter expirado ou sido revogado em Connected apps no painel do Chatfuel.

Fazer login no chatfuel não conectou o chatfuel-api

Os dois links são conexões separadas. Execute /mcp, escolha chatfuel-api e faça login nele também.

Posso conectar o chatfuel-api com acesso somente leitura?

Não. O link para desenvolvedores sempre funciona com acesso total, e a tela de consentimento dele não tem a opção Read-only. Para ter acesso somente leitura, use o servidor chatfuel com https://mcp.chatfuel.com/panel e ative Read-only ao fazer login.