MCP ou API MCP: qual link do Chatfuel usar

O Chatfuel tem dois links de servidor MCP. https://mcp.chatfuel.com/panel (MCP) dá a qualquer assistente ferramentas prontas para gerenciar bots. https://mcp.chatfuel.com/panel/api (API MCP) dá aos agentes de programação a API GraphQL inteira do Chatfuel, para que eles possam pesquisar o schema e executar qualquer consulta ou mutação que a sua conta permita.

O que o link MCP dá ao assistente?

O link MCP https://mcp.chatfuel.com/panel tem ferramentas tipadas, e cada uma faz uma única tarefa: listar bots, ativar a IA, adicionar entradas ao FAQ, configurar respostas a comentários, adicionar serviços e especialistas, revisar chats, responder a um cliente, testar uma resposta em um chat de teste (sandbox) e mais. As ferramentas explicam o que alteram e pedem um sim quando necessário, por isso o link MCP é ideal para Claude, ChatGPT, Muse e o trabalho do dia a dia em qualquer assistente. É o único link com a opção Read-only.

O que o link API MCP dá ao assistente?

O link API MCP https://mcp.chatfuel.com/panel/api é para Claude Code, Cursor, VS Code, Codex, Gemini CLI e Antigravity. Ele expõe a Public API do Chatfuel por meio de algumas ferramentas gerais:

• search_schema, list_operations, get_type e get_operation encontram a operação GraphQL certa e mostram seus argumentos.
• execute_query e execute_mutation a executam. execute_mutation pode verificar uma requisição com validateOnly sem enviá-la.
• upload_file envia uma imagem, um vídeo, um arquivo de áudio ou um documento e retorna o ID do arquivo.

O link API MCP também mantém as ferramentas combinadas para as tarefas mais comuns: ativar a IA, respostas a comentários, configuração de agendamentos, revisão de chats, diagnóstico, testes em sandbox e envio de uma mensagem em um chat.

O que só posso fazer com a API MCP?

Algumas tarefas não têm ferramenta pronta e só estão disponíveis em https://mcp.chatfuel.com/panel/api:

• Gerenciar produtos no catálogo.
• Consultar agendamentos e criar, remarcar, confirmar ou cancelar agendamentos.
• Mover leads entre etapas no quadro de Leads.
• Criar um link para conectar um número de WhatsApp.
• Enviar arquivos.

No link MCP, o assistente indica o painel do Chatfuel para essas tarefas.

Posso adicionar os dois links?

Sim. Adicione-os com nomes diferentes, por exemplo chatfuel e chatfuel-api. Os dois links são conexões separadas: o login em um não vale para o outro, então faça login em cada um. Um CLI token funciona nos dois links.

Como é uma requisição GraphQL pela API MCP?

O assistente geralmente pesquisa o schema, lê a operação e a executa. Para um pedido como "Liste meus bots", ele encontra currentUser com search_schema, lê a operação com get_operation e executa um documento como este:

query Me {
  currentUser {
    botsV2(first: 50) {
      edges { node { id title } }
      pageInfo { hasNextPage endCursor }
    }
  }
}

O assistente executa apenas o que as permissões da sua conta permitem. Algumas operações estão fechadas para o MCP nos dois links, por exemplo excluir bots, gerenciar membros da equipe, cobrança e criação de broadcasts.

Problemas comuns

Qual link devo adicionar ao Claude ou ao ChatGPT?

Adicione https://mcp.chatfuel.com/panel. Claude, ChatGPT e Muse funcionam com as ferramentas prontas do link MCP.

Posso usar a API MCP com acesso somente leitura?

Não. A API MCP sempre funciona com acesso total, porque algumas consultas GraphQL também alteram dados. Para ter acesso somente leitura, use o link MCP e ative Read-only ao fazer login.

O assistente diz que uma operação não está disponível

Algumas operações estão fechadas para o MCP, e algumas exigem um plano ativo ou uma função no bot. Faça a tarefa no painel do Chatfuel, em panel.chatfuel.com.