# n8n-mcp

n8n-mcp é um servidor Model Context Protocol (MCP) que dá a assistentes de IA como Claude Desktop, Cursor e Windsurf acesso completo a mais de 1.084 nodes do n8n, documentação, templates e ferramentas de gerenciamento, permitindo que eles construam, validem e implantem de forma autônoma workflows prontos para produção.

Canonical URL: https://a2a-mcp.org/entry/n8n-mcp-pt

Language: pt

Category: MCP Servers

Updated: 2026-03-18

## Visão Geral

n8n-mcp é um servidor open-source Model Context Protocol (MCP) que conecta assistentes de codificação com IA à plataforma de automação de workflows n8n. Ele equipa ferramentas como Claude Desktop, Claude Code, Cursor, Windsurf e VS Code com conhecimento estruturado e em tempo real de todo o ecossistema n8n — incluindo 537 nodes principais + 547 nodes da comunidade (total de 1.084), 2.709 templates de workflows e lógica de validação específica para IA.

Construído como uma aplicação leve em Node.js com banco de dados SQLite embutido, oferece respostas em menos de 12 ms e funciona nos modos stdio ou HTTP. Conecte uma única vez e deixe sua IA construir, validar, testar e implantar workflows completos do n8n sem copiar-colar ou configuração manual.

Uma versão hospedada com Chat Agent pronto para uso está disponível em [n8n-mcp.com](https://www.n8n-mcp.com) (plano gratuito + planos pagos), enquanto o repositório no GitHub permanece totalmente auto-hospedável sob a licença MIT.

## Principais Recursos

- **Base de Conhecimento Completa de Nodes** — Acesso total a 1.084 nodes do n8n com 99% de cobertura de propriedades, 63,6% de cobertura de operações e 87% da documentação oficial (atualizada em até 48 horas após novos releases do n8n).
- **Busca Inteligente e Descoberta** — `search_nodes`, `get_node` (vários modos de detalhe) e filtragem de nodes da comunidade por origem (verificados/comunidade).
- **Exemplos do Mundo Real** — 2.646 configurações extraídas previamente de templates populares.
- **Validação Avançada** — `validate_node` e `validate_workflow` com perfis de agentes IA, verificações em tempo de execução e análise de dependências. Suporta workflows AI Agent do n8n v2.17+.
- **Engine de Templates** — Busca e recuperação de mais de 2.709 JSONs de workflows prontos para uso com filtragem inteligente.
- **Ferramentas de Gerenciamento n8n** (conexão API opcional) — Criar, atualizar, testar, executar e corrigir automaticamente workflows diretamente na sua instância n8n.
- **Desempenho e Compatibilidade** — ~12 ms de resposta média, consumo de memória de 70–120 MB, compatível com qualquer versão do Node.js. Suporta modos stdio (Claude Desktop) e HTTP/SSE.
- **Privacidade e Segurança** — Telemetria anônima opcional (fácil de desativar), sem credenciais hard-coded, modos de segurança para webhooks.

## Instalação e Configuração

### Início Rápido (npx – sem instalação)
```bash
npx n8n-mcp
```
Adicione ao seu `claude_desktop_config.json` do Claude Desktop com `MCP_MODE=stdio`.

### Docker (recomendado para produção)
```bash
docker pull ghcr.io/czlonkowski/n8n-mcp:latest
docker run -i ghcr.io/czlonkowski/n8n-mcp:latest
```

### Nuvem (one-click)
Implante gratuitamente no Railway usando o template do repositório.

### Build Local Completo
```bash
git clone https://github.com/czlonkowski/n8n-mcp.git
cd n8n-mcp
npm install
npm run build
npm run rebuild
npm start
```

Variáveis de ambiente opcionais: `N8N_API_URL`, `N8N_API_KEY` (para gerenciamento direto de workflows), `LOG_LEVEL=error`, `MCP_MODE=stdio`.

## Assistentes de IA Suportados

- Claude Desktop / Claude Code
- Cursor
- Windsurf
- VS Code + Codex
- Antigravity
- Qualquer cliente compatível com MCP (mais de 20 ferramentas via serviço hospedado)

## Casos de Uso

- **Criação de Workflows Impulsionada por IA** — Descreva “monitorar menções no Twitter e postar resumos no Slack com análise de sentimento” → a IA gera, valida e implanta o JSON completo.
- **Manutenção de Workflows Existentes** — A IA lê workflows ao vivo, sugere otimizações e aplica atualizações direcionadas.
- **Exploração de Templates** — Peça “o melhor template de sincronização com CRM usando nodes da comunidade” e receba JSON pronto para importar.
- **Automação Empresarial** — Conecte a instâncias n8n auto-hospedadas para geração segura e auditável de workflows em escala.
- **Aprendizado e Prototipagem** — Use ferramentas de validação para ensinar as melhores práticas à IA antes do deploy em produção.

## MCP Nativo do n8n vs n8n-mcp

O servidor MCP nativo do n8n (disponível em releases recentes) expõe seus próprios workflows como ferramentas. O n8n-mcp é um servidor MCP **externo** complementar focado no **conhecimento dos nodes do n8n** e na criação assistida por IA. Use os dois juntos para potência máxima: servidor nativo para disparar workflows + n8n-mcp para construção inteligente de workflows.

## Links e Recursos

- GitHub: [czlonkowski/n8n-mcp](https://github.com/czlonkowski/n8n-mcp)
- Chat Agent Hospedado & Dashboard: [n8n-mcp.com](https://www.n8n-mcp.com)
- Plano gratuito: 100 chamadas de ferramentas/dia (hospedado) ou ilimitado no auto-hospedagem
- Documentação e exemplos no repositório

n8n-mcp transforma qualquer assistente de codificação com IA em um especialista completo em workflows n8n — instantaneamente.

## Tags

- mcp-server
- n8n
- ai-assistant
- workflow-automation
- claude-desktop
- cursor
- typescript
- node-js
- mcp
- automation

## Sources

- [Project website](https://github.com/czlonkowski/n8n-mcp)