Conecte Claude e Codex ao servidor MCP do n8n

O servidor MCP da instância permite usar Claude Code ou Codex para buscar, construir e executar workflows no n8n. Você configura uma conexão com a instância e concede permissões ao cliente. Esse servidor é integrado ao n8n. Não exige adicionar MCP Server Trigger a cada workflow.

Habilite o acesso na instância

Com permissão de owner ou admin, abra Settings > Instance-level MCP e selecione Enable MCP access. Em Connection details, selecione Connect. No diálogo Connect a client, escolha OAuth (recommended) e o cliente em Your client.

Copie Server URL. O endereço termina em /mcp-server/http, diferente da URL inicial do editor. Nos comandos abaixo, substitua o domínio de exemplo pelo endereço mostrado na sua instância.

Conecte Claude Code

No terminal, registre o servidor com o comando documentado pelo n8n:

1
claude mcp add --transport http n8n https://n8n.exemplo.com/mcp-server/http

Dentro do Claude Code, execute /mcp e selecione n8n para completar a autorização OAuth. Confira as permissões apresentadas antes de aprovar o acesso.

Conecte Codex CLI

No terminal, adicione a mesma URL ao Codex e conclua o login:

1
codex mcp add n8n --url "https://n8n.exemplo.com/mcp-server/http"
2
codex mcp login n8n

Os comandos configuram o cliente no seu computador. A autenticação autoriza o acesso à instância conforme as permissões concedidas. Use as instruções exibidas pelo n8n para conferir diferenças da versão do seu cliente.

Disponibilize um workflow de exercício

No editor do workflow, abra Workflow menu > Settings e ative Available in MCP. Acrescente uma descrição que explique sua finalidade. Pelo cliente, solicite uma consulta a esse workflow e confira o resultado antes de executar ações.

A ferramenta search_workflows pode retornar prévias de outros workflows que seu usuário tem permissão para visualizar. Acesso completo exige habilitação para MCP. Os clientes compartilham os workflows habilitados para o mesmo usuário. A seleção de workflows não é individual por cliente.

Confira execução e permissões

Por padrão, execute_workflow usa a versão publicada. A ferramenta também oferece modo manual para executar a versão atual ainda não publicada. Confira o modo antes do teste.

Em Connected clients, você pode revisar as permissões OAuth e revogar um acesso. Se a conexão falhar atrás de proxy, confira o repasse dos cabeçalhos MCP indicados na documentação oficial.