如何将 n8n-mcp 接入 n8n 内置 MCP Client Tool 节点【免费下载链接】n8n-mcpA MCP for Claude Desktop / Claude Code / Windsurf / Cursor to build n8n workflows for you项目地址: https://gitcode.com/GitHub_Trending/n8/n8n-mcpn8n-mcp 是一个 Model Context ProtocolMCP服务器接入 n8n 之后你可以在 n8n 工作流里通过MCP Client Tool节点直接调用它提供的 n8n 节点文档查询与管理工作流工具。本文的目标路径是把 n8n-mcp 以 HTTP 模式跑起来 → 用/health和/mcp两个端点确认服务端就绪 → 在 n8n 中配置 MCP Client Tool 节点 → 用一个简单工具验证连通。适用前提一个可访问的 n8n 实例如果要用工作流管理工具创建/更新/获取工作流还需要 n8n API key在 n8n 的 Settings → API 中创建。只用文档类工具则不需要 API key。主要资料来自 docs/N8N_DEPLOYMENT.md 和 N8N_HTTP_STREAMABLE_SETUP.md。准备条件生成鉴权 Token 并确认运行模式接入 n8n 的关键点是n8n-mcp 必须以 HTTP 模式运行MCP_MODEhttp。缺了这个变量服务器会跑在 stdio 模式与 n8n 不兼容这是文档列出的最常见故障原因之一。生成一个至少 32 字符的随机 tokenMCP_AUTH_TOKEN与AUTH_TOKEN必须完全相同# 生成安全 token保存好稍后要填进 n8n MCP Client Tool 配置 AUTH_TOKEN$(openssl rand -hex 32) echo Your AUTH_TOKEN: $AUTH_TOKEN必配环境变量一览摘自部署指南的环境变量参考表变量必填说明示例N8N_MODE是启用 n8n 集成模式trueMCP_MODE是启用 HTTP 模式供 n8n MCP Client 连接httpN8N_API_URL管理工具需要n8n 实例 URLhttp://localhost:5678N8N_API_KEY管理工具需要n8n API keyn8n_api_xxx...MCP_AUTH_TOKEN是MCP 请求鉴权 token至少 32 字符上面生成的值AUTH_TOKEN是必须与MCP_AUTH_TOKEN完全一致上面生成的值PORT否HTTP 端口3000默认N8N_API_URL/N8N_API_KEY仅在使用工作流管理功能时必需文档工具不带这两个也能工作。另外当N8N_API_URL指向 localhost 或同网段 RFC1918 主机时文档要求设置WEBHOOK_SECURITY_MODEmoderate默认值是strict可选permissive。主路径用预构建镜像启动 n8n-mcp文档推荐预构建镜像方式并特别提醒Docker 会缓存本地镜像部署前先docker pull否则可能用到旧版本。以n8n-mcp 与 n8n 同机部署为例docs/N8N_DEPLOYMENT.md 的 Same Server as n8n 一节# 先拉取最新镜像避免使用本地缓存的旧版本 docker pull ghcr.io/czlonkowski/n8n-mcp:latest # 生成安全 token保存好 AUTH_TOKEN$(openssl rand -hex 32) echo Your AUTH_TOKEN: $AUTH_TOKEN # 如果 n8n 使用独立 Docker 网络先创建 docker network create n8n-net # 启动 n8n-mcp 容器 docker run -d \ --name n8n-mcp \ --network n8n-net \ -p 3000:3000 \ -e N8N_MODEtrue \ -e MCP_MODEhttp \ -e N8N_API_URLhttp://n8n:5678 \ -e N8N_API_KEYyour-n8n-api-key \ -e WEBHOOK_SECURITY_MODEpermissive \ -e MCP_AUTH_TOKEN$AUTH_TOKEN \ -e AUTH_TOKEN$AUTH_TOKEN \ -e LOG_LEVELinfo \ --restart unless-stopped \ ghcr.io/czlonkowski/n8n-mcp:latest说明N8N_API_URLhttp://n8n:5678是文档给出的n8n 在同一 Docker 网络内的示例值如果你的 n8n 地址不同例如远程实例https://your-n8n-instance.com按实际替换your-n8n-api-key替换为你在 n8n Settings → API 创建的 key。镜像缓存是否过旧可以用docker images | grep n8n-mcp核对。可选分支本地源码启动。适合开发调试需要先npm install和npm run build再设置同样的环境变量后npm start。注意文档示例中本地模式用的是PORT3001后续验证命令的端口要与它保持一致export N8N_MODEtrue export MCP_MODEhttp # HTTP 模式必需 export N8N_API_URLhttp://localhost:5678 # 你的 n8n 实例 URL export N8N_API_KEYyour-api-key-here # 你的 n8n API key export WEBHOOK_SECURITY_MODEmoderate # N8N_API_URL 为 localhost/RFC1918 时设置 export MCP_AUTH_TOKENtest-token-minimum-32-chars-long export AUTH_TOKENtest-token-minimum-32-chars-long # 与 MCP_AUTH_TOKEN 同值 export PORT3001 npm start验证服务端/health 与 /mcp 端点在 n8n 接入前先在服务器侧确认两个端点可用文档中 n8n 实际连接的就是/mcp端点# 健康检查 curl http://localhost:3000/health # MCP 协议端点n8n 连接的端点 curl http://localhost:3000/mcp文档给出的预期/mcp端点应返回{protocolVersion:2024-11-05}这是 n8n 兼容所需的协议版本。带鉴权地测试工具列表与单个工具调用把YOUR_AUTH_TOKEN替换为你的 token 值# 工具列表鉴权正常时返回 tools list curl -X POST http://localhost:3000/mcp \ -H Authorization: Bearer YOUR_AUTH_TOKEN \ -H Content-Type: application/json \ -d {jsonrpc:2.0,method:tools/list,id:1} # 调用一个文档类工具不需要 n8n API key curl -X POST http://localhost:3000/mcp \ -H Authorization: Bearer YOUR_AUTH_TOKEN \ -H Content-Type: application/json \ -d {jsonrpc:2.0,method:tools/call,params:{name:get_database_statistics,arguments:{}},id:2}在 n8n 中配置 MCP Client Tool 节点在你的 n8n 工作流中添加MCP Client Tool节点即n8n/n8n-nodes-langchain.mcpClientTool节点类型命名参见 data/skills/n8n-agents/TOOLS.md。按下面三个位置条件之一填写 Server URL——必须带/mcp路径文档明确警告缺少它连接会失败Server URL (必须包含 /mcp 端点): - 同机部署: http://localhost:3000/mcp - Docker 网络: http://n8n-mcp:3000/mcp - 跨服务器: https://mcp.yourdomain.com/mcpAuth Token填你生成的MCP_AUTH_TOKEN/AUTH_TOKEN值两个变量同值。Transport选择HTTP Streamable (SSE)。测试连接选一个简单工具例如list_nodes执行工作流确认能返回结果。可选路径社区节点 n8n-nodes-mcpN8N_HTTP_STREAMABLE_SETUP.md 给出另一条接入路径在 n8n 的 Settings → Community Nodes 中安装社区节点n8n-nodes-mcp并在 n8n 侧设置环境变量N8N_COMMUNITY_PACKAGES_ALLOW_TOOL_USAGEtrue。然后在 n8n 的 Credentials → Add credential 中搜索 MCP选择MCP API配置Additional Headers为{Authorization: Bearer 你的token}文档示例值test-secure-token-123456789替换为你的 token工作流中添加 MCP Client 节点Connection Type为HTTP StreamableHTTP Streamable URL为http://n8n-mcp:3000/mcp容器名而非 localhostAuthentication为Bearer AuthOperation可选 List Tools 或 Call Tool验证方式执行工作流MCP Client 成功连接并返回结果即通。Call Tool的示例参数get_node_info传{ nodeType: n8n-nodes-base.httpRequest }search_nodes传{ query: webhook, limit: 5 }。连接成功后可用的工具按 docs/N8N_DEPLOYMENT.md 的划分文档工具不需要 n8n API keylist_nodes、search_nodes、get_node_info、get_node_essentials、validate_workflow、get_node_documentation。管理工具需要 n8n API keyn8n_create_workflow、n8n_update_workflow、n8n_get_workflow、n8n_list_workflows、n8n_trigger_webhook_workflow。如果你想让 AI Agent 自动使用这些工具添加 AI Agent 节点如 OpenAI、Anthropic把 MCP Client Tool 连到 Agent 的 tool 输入端。文档给出的提示词模板You are an n8n workflow expert. Use the MCP tools to: 1. Search for appropriate nodes using search_nodes 2. Get configuration details with get_node_essentials 3. Validate configurations with validate_workflow 4. Create the workflow if all validations pass常见接入失败排查以下现象和解法均直接来自文档的 Troubleshooting 一节现象原因与解法无法连接、/mcp端点无响应缺MCP_MODEhttp。没有它服务器跑在 stdio 模式与 n8n 不兼容Connection refused 或 Invalid responseServer URL 缺/mcp路径n8n 连接的是/mcp而不是根 URLAuthentication failed / Invalid auth tokenMCP_AUTH_TOKEN与AUTH_TOKEN不一致或 token 少于 32 字符、带多余空白/换行、环境变量文件中特殊字符未转义Connection refused网络层依次检查容器是否在跑docker ps \| grep n8n-mcp、docker logs n8n-mcp --tail 20curl /health与curl /mcp是否可达从 n8n 所在机器测端口telnet your-mcp-server 3000防火墙sudo ufw status端口绑定netstat -tlnp \| grep :3000Cannot connect to n8n APIN8N_API_URL缺http://或https://协议头API key 过期/无效n8n 从 n8n-mcp 服务器不可达n8n API 未启用。可用curl -H X-N8N-API-KEY: your-api-key https://your-n8n-instance.com/api/v1/workflows直接测试 n8n API功能与文档不符、旧 bug 复现Docker 用了本地缓存镜像先docker pull ghcr.io/czlonkowski/n8n-mcp:latest用docker images \| grep n8n-mcp核对镜像时间排查时也可开启调试容器加-e DEBUG_MCPtrue -e LOG_LEVELdebug或在 systemd 服务文件中加EnvironmentDEBUG_MCPtrue与EnvironmentLOG_LEVELdebug然后按先/health、再/mcp、再带 token 的tools/list、最后单个工具调用的顺序逐项测试端点。完成标准接入成功的判定依据文档给出的验证方式MCP Client Tool 节点选择list_nodes之类的文档工具后执行工作流能返回结果即代表 n8n 到 n8n-mcp 的 MCP 连接建立完成。注意两个硬限制Server URL 必须带/mcp路径MCP_AUTH_TOKEN与AUTH_TOKEN必须完全一致且不少于 32 字符。跨服务器部署时文档要求使用 HTTPSCaddy/Nginx/Traefik并只暴露必要端口3000 或 443。【免费下载链接】n8n-mcpA MCP for Claude Desktop / Claude Code / Windsurf / Cursor to build n8n workflows for you项目地址: https://gitcode.com/GitHub_Trending/n8/n8n-mcp创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
)
