n8n MCP Server

Gerencie workflows, execuções e credenciais do n8n através do Model Context Protocol.

GitHub
3
Experimente este MCPPatrocinado

Documentação

n8n MCP Server

Um servidor MCP que fornece acesso a workflows, execuções, credenciais e mais do n8n através do Model Context Protocol. Isso permite que Grandes Modelos de Linguagem (LLMs) interajam com instâncias do n8n de forma segura e padronizada.

Instalação

Obtenha sua chave de API do n8n

  1. Faça login na sua instância do n8n
  2. Clique no ícone do usuário no canto inferior esquerdo
  3. Vá para Configurações
  4. Selecione API
  5. Clique em "Criar chave de API"
  6. Copie sua chave de API (você não poderá vê-la novamente)

Instale o servidor MCP

Opção 1: Instalar a partir do npm (Recomendado)

npm install -g @illuminaresolutions/n8n-mcp-server

Opção 2: Instalar a partir do código-fonte

  1. Clone o repositório:

    git clone https://github.com/illuminaresolutions/n8n-mcp-server.git
cd n8n-mcp-server

  2. Instale as dependências e compile:

    npm install
npm run build

  3. Inicie o servidor em segundo plano:

    nohup npm start > n8n-mcp.log 2>&1 &

    Para parar o servidor:

    pkill -f "node build/index.js"

Nota: Ao instalar a partir do npm, o servidor estará disponível como n8n-mcp-server no seu PATH.

Configuração

Claude Desktop

  1. Abra a configuração do seu Claude Desktop:

    ~/Library/Application Support/Claude/claude_desktop_config.json

  2. Adicione a configuração do n8n:

    {
  "mcpServers": {
     "n8n": {
      "command": "n8n-mcp-server",
      "env": {
        "N8N_HOST": "https://your-n8n-instance.com",
        "N8N_API_KEY": "your-api-key-here"
      }
    }
  }
}

Cline (VS Code)

  1. Instale o servidor (siga os passos de Instalação acima)
  2. Abra o VS Code
  3. Abra a extensão Cline na barra lateral esquerda
  4. Clique no ícone 'MCP Servers' no topo do painel
  5. Role até o final e clique em 'Configure MCP Servers'
  6. Adicione ao arquivo de configurações aberto: 
    {
  "mcpServers": {
    "n8n": {
      "command": "n8n-mcp-server",
      "env": {
        "N8N_HOST": "https://your-n8n-instance.com",
        "N8N_API_KEY": "your-api-key-here"
      }
    }
  }
}
  7. Salve o arquivo
  8. Certifique-se de que o alternador MCP esteja habilitado (verde) e o indicador de status esteja verde
  9. Comece a usar comandos MCP no Cline

Sage

Em breve! O servidor MCP do n8n estará disponível através de:

  • Smithery.ai marketplace
  • Importar do Claude Desktop

Por enquanto, use Claude Desktop ou Cline.

Validação

Após a configuração:

  1. Reinicie seu aplicativo de LLM
  2. Pergunte: "Liste meus workflows do n8n"
  3. Você deve ver seus workflows listados

Se você receber um erro:

  • Verifique se sua instância do n8n está em execução
  • Verifique se sua chave de API tem as permissões corretas
  • Certifique-se de que N8N_HOST não tenha barra no final

Recursos

Recursos Principais

  • Listar e gerenciar workflows
  • Visualizar detalhes do workflow
  • Executar workflows
  • Gerenciar credenciais
  • Lidar com tags e execuções
  • Gerar auditorias de segurança
  • Gerenciar tags de workflow

Recursos Enterprise

Esses recursos exigem uma licença Enterprise do n8n:

  • Gerenciamento de projetos
  • Gerenciamento de variáveis
  • Gerenciamento avançado de usuários

Solução de Problemas

Problemas Comuns

  1. "Cliente não inicializado"

    • Verifique se N8N_HOST e N8N_API_KEY estão definidos corretamente
    • Certifique-se de que a instância do n8n esteja acessível
    • Verifique as permissões da chave de API

  2. "Licença necessária"

    • Você está tentando usar um recurso Enterprise
    • Atualize para o n8n Enterprise ou use apenas os recursos principais

  3. Problemas de Conexão

    • Verifique se a instância do n8n está em execução
    • Verifique o protocolo da URL (http/https)
    • Remova a barra final de N8N_HOST

Boas Práticas de Segurança

  1. Gerenciamento de Chave de API

    • Use as permissões mínimas necessárias
    • Rotacione as chaves regularmente
    • Nunca envie chaves para o controle de versão

  2. Acesso à Instância

    • Use HTTPS para produção
    • Habilite a autenticação do n8n
    • Mantenha o n8n atualizado

Suporte

Licença

MIT License