Antes de começar
- Instância n8n compatível com MCP
- Permissão de proprietário ou administrador
- Cliente MCP suportado
- Workflow de teste sem ações externas sensíveis
Prepare um fluxo de teste
Escolha um workflow simples, com nome e descrição claros, que trabalhe apenas com dados de exemplo. Confira suas entradas e saídas no próprio n8n antes de conectá-lo ao agente.
Evite começar com envio de mensagens, cobranças ou alterações em dados de clientes. O objetivo inicial é conferir a conexão.
Habilite o acesso MCP da instância
Na versão documentada, abra Settings e Instance-level MCP para habilitar o acesso. Se a sua versão tiver outra interface, consulte o guia da instalação.
Selecione os workflows que o MCP poderá usar. Habilitar a instância ainda exige essa escolha de quais fluxos liberar.
Copie a URL correta e conecte o cliente
Use Connect a client e copie o campo Server URL. Ele é o endpoint MCP da sua instância, não a URL comum do editor.
Escolha seu cliente e siga o fluxo oficial, preferindo OAuth quando disponível. Faça a autorização na tela do serviço. Não cole tokens em conversas ou arquivos públicos.
Comece com uma consulta
Peça ao agente para localizar o workflow de teste e explicar o que ele faz, sem executá-lo. Confira se ele encontrou o fluxo correto e se entendeu as entradas.
Se a consulta falhar, revise autenticação, permissões e versão. Não aumente permissões indiscriminadamente para contornar um erro.
Execute apenas o teste definido
Depois da consulta, autorize uma execução do workflow de teste com dados de exemplo. Peça o identificador da execução e confira o registro no n8n.
Compare a entrada enviada, os nós percorridos e a saída obtida. Se houver erro, corrija a causa antes de repetir a execução.
Anote os acessos e remova o que não precisa
Anote qual cliente foi conectado, quais workflows ele pode usar e quem administra o acesso. Remova o fluxo de teste do MCP quando terminar.
Antes de adicionar uma automação real, descreva o que ela altera nos serviços conectados e como conferir falhas. Outros clientes conectados também podem acessar os workflows expostos, dentro das permissões do usuário.
O que você terá ao final
Uma conexão MCP configurada e uma execução de teste para conferir no histórico do n8n.
Vale conferir
- Versão e modalidade do n8n afetam as ferramentas e a interface disponíveis.
- A busca pode mostrar prévias de outros workflows que o usuário tem permissão de visualizar.
- Executar um workflow pode consumir serviços e gerar alterações reais.
- Integração descrita pela documentação; não conectada nem executada pela Agentspedia.