n8n MCP Server

Automatize fluxos de trabalho com o n8n, uma ferramenta poderosa de automação de workflows.

GitHub
4
Experimente este MCPPatrocinado

Documentação

n8n MCP Server

MCP n8n

Servidor MCP (Model Context Protocol) para automação de fluxos de trabalho do n8n. Este servidor permite que assistentes de IA como o Claude interajam com instâncias do n8n por meio da API REST.

Recursos

  • 🔄 Gerenciamento de Fluxos de Trabalho: Listar, criar, atualizar e excluir fluxos de trabalho
  • ▶️ Controle de Execução: Executar fluxos de trabalho e monitorar execuções
  • 🏷️ Gerenciamento de Tags: Organizar fluxos de trabalho com tags
  • 📊 Histórico de Execução: Acessar o histórico e os resultados das execuções de fluxos de trabalho
  • 🔑 Gerenciamento de Credenciais: Listar credenciais disponíveis (somente leitura)
  • 🌐 Gerenciamento de Webhooks: Criar e gerenciar webhooks
  • 🔍 Pesquisa: Pesquisar fluxos de trabalho por nome ou tags

Pré-requisitos

  • Node.js 18 ou superior
  • Instância do n8n com acesso à API habilitado
  • Chave de API do n8n

Instalação

Via npm (quando publicado)

npm install -g n8n-mcp-server

A partir do código-fonte

git clone https://github.com/nikolausm/n8n-mcp-server.git
cd n8n-mcp-server
npm install
npm run build

Configuração

Obtendo sua chave de API do n8n

  1. Faça login na sua instância do n8n
  2. Vá para Configurações → API
  3. Gere uma chave de API

Configurar o Claude Desktop

Adicione o seguinte à sua configuração do Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "n8n": {
      "command": "node",
      "args": ["/path/to/n8n-mcp-server/dist/index.js"],
      "env": {
        "N8N_URL": "https://your-n8n-instance.com",
        "N8N_API_KEY": "your-api-key-here"
      }
    }
  }
}

Para instâncias do n8n na nuvem, use:

  • N8N_URL: https://your-subdomain.app.n8n.cloud

Ferramentas Disponíveis

Gerenciamento de Fluxos de Trabalho

  • list_workflows - Listar todos os fluxos de trabalho com filtragem opcional
  • get_workflow - Obter informações detalhadas sobre um fluxo de trabalho específico
  • create_workflow - Criar um novo fluxo de trabalho a partir de JSON
  • update_workflow - Atualizar um fluxo de trabalho existente
  • delete_workflow - Excluir um fluxo de trabalho
  • activate_workflow - Ativar um fluxo de trabalho
  • deactivate_workflow - Desativar um fluxo de trabalho

Execução

  • execute_workflow - Executar um fluxo de trabalho com dados de entrada opcionais
  • get_executions - Obter histórico de execuções com opções de filtragem
  • get_execution - Obter detalhes de uma execução específica
  • delete_execution - Excluir uma execução
  • retry_execution - Tentar novamente uma execução com falha

Tags

  • get_tags - Listar todas as tags disponíveis
  • create_tag - Criar uma nova tag
  • update_tag - Atualizar uma tag
  • delete_tag - Excluir uma tag

Outros

  • get_credentials - Listar credenciais disponíveis (apenas nomes)
  • search_workflows - Pesquisar fluxos de trabalho por nome ou tags
  • get_workflow_webhooks - Obter URLs de webhook para um fluxo de trabalho

Exemplos de Uso

Listar todos os fluxos de trabalho ativos

Assistant: I'll list all your active n8n workflows.

[Uses list_workflows tool with active=true]

Executar um fluxo de trabalho

Assistant: I'll execute the workflow with the data you provided.

[Uses execute_workflow tool with workflowId and data]

Criar um novo fluxo de trabalho

Assistant: I'll create a new workflow for you.

[Uses create_workflow tool with workflow JSON]

Desenvolvimento

Configuração

npm install

Compilação

npm run build

Testar localmente

N8N_URL=https://your-instance.com N8N_API_KEY=your-key npm start

Executar testes

npm test

Notas de Segurança

  • Nunca faça commit das suas chaves de API
  • Use variáveis de ambiente para dados sensíveis
  • O servidor MCP tem as mesmas permissões que a sua chave de API
  • Considere usar uma chave de API restrita, se possível

Contribuição

Contribuições são bem-vindas! Por favor:

  1. Faça um fork do repositório
  2. Crie um branch de funcionalidade
  3. Faça suas alterações
  4. Adicione testes, se aplicável
  5. Envie um pull request

Licença

MIT - consulte o arquivo LICENSE

Suporte

Autor

Michael Nikolaus - GitHub