Conecte o Chatfuel MCP ao n8n MCP
O seu Agente de IA qualifica leads e recebe pedidos no WhatsApp, no Instagram e nas outras conversas, e os seus workflows do n8n já conhecem os seus formulários, as notas fiscais e os registros da clínica. Peça ao assistente para rodar esses workflows com o que os clientes escreveram e depois responder na conversa, completar o FAQ ou atualizar o quadro de Leads com o que eles devolverem.
O que a integração faz
As tools que o assistente usa em cada lado, com os nomes que cada servidor dá a elas.
| Tool | O que faz |
|---|---|
list_chats | Lista as conversas com clientes com canal, status e etapa do lead. |
get_chat | Mostra as últimas mensagens de uma conversa com um cliente, com canal, status e etapa do lead. |
review_chats | Resume as conversas com clientes de um período em vez de devolver cada mensagem. |
update_automation_setting | Muda uma configuração de uma automação: quando a IA responde, a passagem para a equipe, os follow-ups, a qualificação de leads, as regras de agendamento ou as respostas a comentários. |
send_chat_message | Envia ao cliente, na conversa dele, o texto que você aprovou e passa a conversa para o chat ao vivo. |
return_chat_to_ai | Devolve ao Agente de IA uma conversa que está no chat ao vivo, depois do seu sim, e o Agente de IA responde a última mensagem do cliente. |
add_faq | Adiciona perguntas e respostas ao FAQ que o Agente de IA usa para responder. |
test_reply | Envia uma mensagem de cliente de teste para uma conversa de teste e devolve a resposta do Agente de IA. |
set_lead_stage | Move um lead para outra etapa do quadro de Leads, como qualificado ou ganho. |
| Tool | O que faz |
|---|---|
search_workflows | Procura workflows por nome, descrição, tag ou pasta e mostra uma prévia de cada um, inclusive se está disponível no MCP. |
get_workflow_details | Mostra os nós e os triggers de um workflow, como iniciá-lo e se você tem permissão para executá-lo. |
execute_workflow | Inicia um workflow pelo trigger Webhook, Form, Chat ou Schedule com os dados que você passa e devolve o ID da execução. |
get_workflow_execution | Mostra o status de uma execução e, se você pedir, os dados que cada nó devolveu. |
search_workflow_executions | Lista execuções por workflow, status e horário de início, como as que falharam hoje. |
test_workflow | Roda um workflow com dados de exemplo no lugar do trigger, dos nós com credenciais e das requisições HTTP, sem chamar nenhum serviço externo. |
create_workflow_from_code | Salva um workflow novo que o assistente escreveu e validou com o Workflow SDK do n8n. |
publish_workflow | Publica o rascunho atual de um workflow para que as execuções de produção usem essa versão. |
search_data_tables | Procura as data tables do n8n que você pode acessar, com as colunas de cada uma. |
add_data_table_rows | Adiciona até mil linhas a uma data table numa só chamada. |
O que pedir ao assistente
Leads qualificados do chat → seu formulário de cadastro no n8n
QuandoClientes novos do site preenchem um formulário de cadastro feito no n8n, enquanto o Agente de IA qualifica nas conversas leads que nunca chegam a ver esse formulário.
- O n8n MCP encontra o workflow Cadastro de clientes com
search_workflows, eget_workflow_detailsmostra os campos do Form trigger: nome, e-mail, procedimento, queixas da pele e dia preferido. - Se o Agente de IA ainda não pede o e-mail e as queixas da pele,
update_automation_settinginclui os dois na qualificação de leads depois do seu sim. - O Chatfuel MCP lista com
list_chatsas conversas na etapa Qualificado, eget_chatlê o que cada cliente escreveu. execute_workflowenvia o formulário publicado uma vez por lead, com formData tirado da conversa.get_workflow_executionconfere cada execução, esearch_workflow_executionsmostra as que falharam.
ResultadoOs leads do chat entram no mesmo processo de cadastro de quem preenche o formulário no site, com tudo o que o seu workflow faz em seguida. Cada envio é uma execução do n8n, não importa quantos passos venham depois.
PeçaEnvie o nosso formulário do n8n Cadastro de clientes para cada lead que chegou a Qualificado no Chatfuel esta semana, com nome, e-mail, procedimento, queixas da pele e dia preferido tirados da conversa. Diga quais execuções falharam.
Pedido de nota fiscal na conversa → seu workflow de notas no n8n → a resposta
QuandoUma cliente precisa da nota fiscal da última visita. As notas saem do seu sistema de notas fiscais, que o Agente de IA não acessa, então ele passa a conversa para a sua equipe.
- O Chatfuel MCP encontra a conversa com
list_chats, eget_chatmostra a visita e o e-mail que a cliente escreveu. - O n8n MCP roda o workflow Nota fiscal da visita com
execute_workflow, mandando esse e-mail e a data da visita para o Webhook trigger. get_workflow_executionlê o que o workflow devolveu: o número da nota, o valor e o e-mail para o qual ela foi enviada.- O assistente escreve a resposta, e
send_chat_messageenvia depois que você aprova esse texto exato. Quando a cliente responder,return_chat_to_aidevolve a conversa ao Agente de IA com o seu sim.
ResultadoA nota fiscal chega ao e-mail da cliente e a confirmação, à conversa dela, sem ninguém abrir o sistema de notas fiscais. A resposta só sai dentro de 24 horas da última mensagem dela no WhatsApp, ou de 7 dias no Instagram e no Messenger.
PeçaA Luana Nascimento pediu a nota fiscal do Peeling do dia 6 de novembro. Rode o nosso workflow do n8n Nota fiscal da visita com o e-mail da conversa dela e escreva uma resposta para eu aprovar.
Perguntas que o Agente de IA não respondeu → sua busca no n8n → o FAQ
QuandoAs clientes perguntam sobre cuidados pós-procedimento que o Agente de IA ainda não conhece, e as suas anotações de tratamento ficam em ferramentas que um workflow do n8n já consulta.
review_chatsdo Chatfuel MCP resume a semana e reúne as perguntas que o Agente de IA não soube responder ou passou para a sua equipe.- O n8n MCP manda cada pergunta para o workflow Buscar nas anotações com
execute_workflow, pelo Webhook trigger. get_workflow_executiondevolve os trechos que o workflow encontrou, e com cada um o assistente escreve uma resposta curta para você ajustar.add_faqsalva as respostas que você aprova, etest_replyfaz uma das perguntas de novo numa conversa de teste.
ResultadoA próxima cliente que perguntar recebe uma resposta tirada das suas anotações, sem esperar pela equipe. As perguntas que as anotações não cobrem voltam para você numa lista curta.
PeçaQuais perguntas o Agente de IA não respondeu esta semana? Procure cada uma com o nosso workflow do n8n Buscar nas anotações, escreva respostas para o FAQ com o que ele encontrar e adicione as que eu aprovar.
Visitas nos registros da clínica → Fechado Ganhou no quadro de Leads
QuandoMuitos leads terminam o agendamento por telefone ou na recepção, então as conversas continuam em Qualificado ou Vendendo mesmo depois que eles já vieram.
- O Chatfuel MCP lista com
list_chatsas conversas nas etapas Qualificado e Vendendo, eget_chatpega o e-mail ou telefone que cada cliente escreveu. - O n8n MCP roda o workflow Buscar visitas uma única vez, com a lista inteira no corpo do webhook: uma execução, não importa quantos clientes ele confira.
get_workflow_executiondevolve quem visitou a clínica neste mês e em que dia.set_lead_stagemove esses leads para ganho depois de um sim que cita até 5 leads com a etapa antiga e a nova. Ganho fecha o chat ao vivo, e o Agente de IA volta a cuidar dessas conversas.
ResultadoO quadro de Leads mostra quem realmente veio, e a sua equipe para de fazer follow-up com quem já visitou a clínica. Leads que não escreveram e-mail nem telefone só batem pelo nome, então o assistente lista esses para você conferir.
PeçaCompare os nossos leads em Qualificado e Vendendo no Chatfuel com as visitas deste mês usando o nosso workflow do n8n Buscar visitas. Mova para ganho os que vieram, depois que eu confirmar.
Como conectar
Conecte o Chatfuel MCP
Adicione o Chatfuel no Claude ou no ChatGPT pelos diretórios deles, ou passe ao Cursor o endereço https://mcp.chatfuel.com/panel, e entre na sua conta.
Ative o MCP no n8n
Um owner ou admin da instância abre Settings › Instance-level MCP e escolhe Enable MCP access. Depois ative Available in MCP em cada workflow que o assistente pode usar, ou num projeto ou pasta inteiros.
Conecte a sua instância
A sua instância tem um endereço de servidor próprio, que termina em /mcp-server/http; copie esse endereço em Connect. O Claude adiciona o n8n pelo diretório, o ChatGPT e o Cursor usam o endereço, e o n8n pede que você aprove cada cliente e escolha o acesso dele.
- Adicione o Chatfuel pelo diretório de conectores do Claude e entre na sua conta.
- No n8n, abra Settings › Instance-level MCP, clique em Connect, escolha Claude.ai e copie a Server URL.
- Clique em Add to Claude para abrir o n8n no diretório do Claude. Conecte com a sua Server URL e aprove o acesso quando o Claude levar você ao n8n.
- Uma instância self-hosted precisa de um domínio público: o Claude se conecta pela nuvem e não alcança localhost nem uma rede privada.
- Chatfuel MCP
- claude.ai/directory/chatfuel
- n8n MCP
- Pelo diretório do Claude
- Instale o plugin do Chatfuel pelo diretório do ChatGPT e entre na sua conta.
- O n8n se conecta ao ChatGPT pelo endereço. No diálogo Connect do n8n, escolha ChatGPT e copie a Server URL.
- No ChatGPT, ative o Developer mode, crie um plugin chamado n8n com essa URL e mantenha o OAuth. Entre no n8n e aprove o acesso que escolher.
- Como no Claude, o ChatGPT só funciona com uma instância que ele alcance pela internet, como o n8n Cloud ou uma self-hosted com domínio público.
- Chatfuel MCP
- chatgpt.com/plugins
- n8n MCP
https://<your-n8n-domain>/mcp-server/http
- Coloque o Chatfuel no ~/.cursor/mcp.json com a URL https://mcp.chatfuel.com/panel.
- Adicione o n8n com "type": "streamable-http" e a sua Server URL, ou use o One-click setup para Cursor no diálogo Connect do n8n. O plugin do próprio n8n, /add-plugin n8n, pede a mesma URL.
- Entre no n8n pelo navegador e aprove o acesso. Se o admin limita as Allowed callback URLs, adicione http://localhost:8787/callback para o app de desktop do Cursor.
- Chatfuel MCP
https://mcp.chatfuel.com/panel- n8n MCP
https://<your-n8n-domain>/mcp-server/http
O que você precisa
- Um bot do Chatfuel cujo Agente de IA responde no WhatsApp, Instagram, Facebook, TikTok ou chat do site.
- n8n Cloud ou uma instância self-hosted do n8n. Esta página segue o n8n 2.33 ou posterior, em que Settings › Instance-level MCP tem o diálogo Connect.
- O acesso MCP ativado por um owner ou admin da instância, e os workflows que você vai usar marcados como Available in MCP e compartilhados com o seu usuário do n8n.
- Os próprios workflows, publicados: um Form trigger de página única para o cadastro e Webhook triggers para os outros desta página. O assistente também pode montá-los com você.
- Claude, ChatGPT com Developer mode ou Cursor.
Limites
- Não existe um endereço comum do n8n: cada instância tem a sua Server URL. O Claude e o ChatGPT chegam a ela pela nuvem, então um n8n self-hosted precisa de domínio público; um em localhost ou numa rede privada só funciona com um cliente na mesma rede, como o Cursor no mesmo computador.
- O assistente só abre e executa workflows marcados como Available in MCP. Mesmo assim, search_workflows mostra uma prévia de todos os que você pode ver, e todos os seus assistentes conectados enxergam os mesmos workflows ativados.
- execute_workflow roda a versão publicada e só inicia triggers Webhook, Form, Chat e Schedule. Workflows que esperam uma pessoa ou usam formulários de várias páginas não rodam assim.
- O acesso que você aprova para cada cliente limita as ferramentas dele: com Read only, o n8n esconde execute_workflow e as outras que gravam dados.
- Cada execução conta como uma no seu plano do n8n. Nada roda sozinho: nenhum dos servidores inicia o outro, então os workflows recebem dados do chat só quando você pede ao assistente.
- O Chatfuel MCP compartilha nomes, canais, etapas e mensagens, não telefones nem e-mails. Um workflow recebe e-mail ou telefone só se o cliente escreveu na conversa.
- As respostas por send_chat_message precisam do seu sim a cada texto exato, chegam ao WhatsApp em até 24 horas desde a última mensagem do cliente e ao Instagram ou Messenger em até 7 dias, e deixam a conversa no chat ao vivo até você devolvê-la.
Perguntas frequentes
É o servidor MCP no nível da instância, embutido no n8n e disponível para todos desde o n8n 2.31, em julho de 2026. Uma única chave vale para a instância inteira, e o assistente roda qualquer workflow que você ativar. O nó MCP Server Trigger é outra coisa: transforma um workflow num servidor próprio, só com as ferramentas que você ligar a ele.
No n8n, em Settings › Instance-level MCP › Connect, como Server URL. O formato é https://<your-n8n-domain>/mcp-server/http, e no n8n Cloud o domínio é your-instance.app.n8n.cloud. O endereço do editor que aparece no navegador não funciona.
Sim. O acesso MCP funciona igual no n8n Cloud e em instâncias self-hosted. Para o Claude e o ChatGPT, a instância precisa de um endereço público, e o proxy reverso ou o firewall na frente dela deve deixar passar os cabeçalhos MCP-Protocol-Version, Mcp-Method e Mcp-Name.
Sim, a partir do n8n 2.13. Ele procura os nós do n8n, escreve o workflow com o Workflow SDK, confere com validate_workflow, salva com create_workflow_from_code e publica com publish_workflow. Para montar workflows, o n8n sugere agentes de código como o Claude Code.
Sim. test_workflow roda o workflow com dados de exemplo no lugar do trigger, dos nós com credenciais e das requisições HTTP, então nenhum app externo recebe chamada. Os nós de lógica, como If ou Code, rodam de verdade, e você vê o que a execução real faria.
Sim. O assistente encontra a tabela com search_data_tables, ou cria uma, e add_data_table_rows grava até mil leads numa só chamada. O n8n MCP não tem ferramenta para ler linhas, então, para usá-las depois, rode um workflow que leia a tabela.
Mais integrações
Conecte o Chatfuel MCP
Comece o teste grátis, adicione o Chatfuel ao seu assistente e pergunte sobre n8n e as suas conversas em um só lugar.