O que é n8n Instance-level MCP?
O servidor MCP em nível de instância do n8n faz parte do n8n, a plataforma de automação de workflows, e não é um pacote separado. Um owner ou admin o ativa em Settings > Instance-level MCP, e os clientes MCP se conectam a uma única URL da instância terminada em /mcp-server/http. Ele funciona no n8n Cloud e em instâncias auto-hospedadas, e o post de lançamento do n8n diz que ele está em todas as edições, incluindo a Community Edition gratuita auto-hospedada.
Ele começou como uma forma de executar workflows existentes. Desde uma atualização anunciada em 29 de abril de 2026, os clientes também podem criar e editar workflows, validá-los, rodar execuções de teste com dados fixados e publicá-los; o n8n recomenda a versão 2.18.4 ou superior. O modelo escreve cada workflow em TypeScript, que precisa passar na checagem de tipos antes que qualquer coisa chegue à instância. Versões posteriores acrescentaram controles por projeto e pasta (2.24.0), gerenciamento de agentes (2.34.0, rotulado como Preview) e exposição automática de novos workflows (2.36.0, ainda em implantação).
Ele não é o nó MCP Server Trigger, que transforma um único workflow em seu próprio servidor MCP com ferramentas que você projeta.
Como instalar n8n Instance-level MCP
https://<your-n8n-instance>/mcp-server/httpn8n Instance-level MCP vale a pena?
O modelo de permissões é o motivo para preferi-lo aos servidores da comunidade. Nada é exposto em massa: você ativa o MCP por workflow, ou para um projeto ou pasta, e search_workflows devolve apenas prévias dos workflows que não estão ativados. OAuth é o login recomendado, cada cliente OAuth recebe apenas as permissões aprovadas na conexão, e os clientes conectados podem ser revisados e revogados na página de configurações.
As lacunas são específicas. O acesso não tem escopo por cliente, então cada cliente conectado vê todos os workflows ativados que o usuário alcança. As URLs de callback ficam abertas por padrão, o que a própria documentação do n8n chama de menos seguro. Clientes que se conectam com a chave de API pessoal não aparecem na lista de revogação, e a chave não pode ser vista de novo depois que você sai da aba. execute_workflow usa o modo de produção por padrão e roda a versão publicada, então um modelo pode causar efeitos colaterais reais em qualquer coisa que você exponha.
Sobre qualidade, o post de lançamento do n8n é incomumente franco. Workflows complexos muitas vezes precisam de uma segunda ou terceira passada, a lógica de ramificação muitas vezes exige limpeza manual, e os modelos tendem a construir demais, por exemplo escrevendo um nó Code de 50 linhas onde um template e um nó Set bastariam. Edições feitas na interface no meio da sessão podem ser sobrescritas se o modelo não buscar a versão mais recente. O n8n também relata que o Claude Code produziu resultados melhores do que o chat do Claude com o mesmo prompt e o mesmo modelo.
Em comparação com o servidor n8n-MCP da comunidade, este não precisa de processo extra e pode usar recursos que não estão na API pública do n8n, mas não tem o grande banco de nós e templates daquele projeto. Clientes hospedados na nuvem, como Claude.ai e ChatGPT, também precisam que a instância seja acessível pela internet, que é justamente o que muitas equipes quiseram evitar ao auto-hospedar o n8n.
Onde ele se destaca
Um engenheiro de automação em uma agência de 30 pessoas com n8n auto-hospedado
Rascunhar no Claude Code um novo workflow de onboarding de clientes a partir de uma especificação escrita
O modelo busca nós, escreve o workflow em TypeScript que precisa passar na checagem de tipos, roda test_workflow com dados fixados e só publica quando mandado. O próprio post do n8n diz que fluxos complexos precisam de uma segunda ou terceira passada, então reserve tempo de revisão em vez de esperar uma montagem de primeira.
Um líder de operações no n8n Cloud Pro
Permitir que a equipe de suporte dispare workflows existentes de reembolso e relatórios pelo ChatGPT
Ative apenas esses workflows; execute_workflow roda a versão publicada, e cada execução é uma execução comum do plano (10.000 por mês no Pro, a partir de €50). Revogue o cliente de uma pessoa em Connected clients quando ela sair.
Um engenheiro de plataforma em uma seguradora com um n8n interno
Manter o acesso de IA às automações auditável e fácil de desligar
Restrinja as URLs de callback às confiáveis, exija OAuth em vez da chave de API compartilhada e mantenha a instância fora da internet pública para que só clientes locais ou de IDE se conectem. Em instâncias auto-hospedadas, N8N_DISABLED_MODULES=mcp remove os endpoints por completo.
Antes de decidir
- Configuração
- Um owner ou admin o ativa em Settings > Instance-level MCP e depois ativa os workflows individualmente ou por projeto ou pasta; os clientes se conectam à URL da instância terminada em /mcp-server/http. O n8n documenta Claude Desktop, Claude Code, Codex, Cursor, VS Code, Gemini CLI e Windsurf, e recomenda 2.18.4 ou superior para montar workflows.
- Integrações
- A referência de ferramentas documenta 25 ferramentas para workflows, execuções, credenciais, contexto da instância e o construtor, das quais publish, unpublish, execute e test alteram estado; ferramentas de criação, atualização, restauração, agentes e tabelas de dados vêm por cima. list_credentials devolve nomes, nunca valores secretos.
- Dados e privacidade
- Tudo fica na sua instância, mas o cliente conectado e seu provedor de modelo veem as definições de workflows e os dados de execução que o usuário alcança. O n8n Cloud tem cobertura SOC 2 Type II, segundo o trust centre do n8n; uma instância auto-hospedada mantém os dados nos seus servidores.
- Custo em escala
- O servidor não acrescenta taxa. Execuções de produção disparadas por agentes contam como execuções (a cobrança do n8n mede execuções de produção e não diz se execuções de test_workflow com dados fixados contam): o Cloud Starter, a €20 por mês, cobre 2.500, e o Pro, a partir de €50, cobre 10.000 no faturamento anual, enquanto uma Community Edition auto-hospedada custa só o servidor.
- Limites
- test_workflow espera 5 minutos por padrão e 60 no máximo; proxies e firewalls precisam deixar passar os cabeçalhos MCP-Protocol-Version, Mcp-Method e Mcp-Name; o gerenciamento de agentes exige o módulo de agentes em instâncias auto-hospedadas.
O que é bom
- Oficial, roda dentro do n8n sem serviço extra
- Exposição opcional por workflow, projeto ou pasta
- Clientes OAuth podem ser revisados e revogados
- Monta, valida e testa workflows, não só os dispara
O que não é
- A montagem de workflows é uma preview pública; os agentes estão em Preview
- Sem escopo de workflows por cliente
- execute_workflow usa o modo de produção por padrão
- Clientes com chave de API não aparecem na lista de revogação
Ideal para
Equipes que já usam o n8n e querem que clientes de IA executem e montem workflows sob as próprias permissões do n8n.
Alternativas ao n8n Instance-level MCP
n8n Instance-level MCP: perguntas frequentes
- n8n Instance-level MCP vale a pena?
- Para uma equipe que já roda o n8n, este é o servidor MCP por onde começar: oficial, com liberação workflow a workflow e franco sobre onde seu construtor de workflows ainda tropeça. Damos nota 4.2 de 5.
- Quanto custa n8n Instance-level MCP?
- Incluído em todas as edições do n8n, incluindo a Community Edition gratuita auto-hospedada. n8n Cloud e Enterprise são planos pagos do n8n.
- Quais são as desvantagens de n8n Instance-level MCP?
- A montagem de workflows é uma preview pública; os agentes estão em Preview; sem escopo de workflows por cliente; execute_workflow usa o modo de produção por padrão; clientes com chave de API não aparecem na lista de revogação.
- Para quem n8n Instance-level MCP é indicado?
- Equipes que já usam o n8n e querem que clientes de IA executem e montem workflows sob as próprias permissões do n8n.
- Quanto custa n8n Instance-level MCP para uma equipe ou em produção?
- O servidor não acrescenta taxa. Execuções de produção disparadas por agentes contam como execuções (a cobrança do n8n mede execuções de produção e não diz se execuções de test_workflow com dados fixados contam): o Cloud Starter, a €20 por mês, cobre 2.500, e o Pro, a partir de €50, cobre 10.000 no faturamento anual, enquanto uma Community Edition auto-hospedada custa só o servidor.
- n8n Instance-level MCP é seguro para dados da empresa?
- Tudo fica na sua instância, mas o cliente conectado e seu provedor de modelo veem as definições de workflows e os dados de execução que o usuário alcança. O n8n Cloud tem cobertura SOC 2 Type II, segundo o trust centre do n8n; uma instância auto-hospedada mantém os dados nos seus servidores.
- Quais são as melhores alternativas ao n8n Instance-level MCP?
- As alternativas mais próximas que analisamos são n8n-MCP e Zapier MCP.
Respostas verificadas em 26 de out. de 2026.
