配置 n8n 技能插件与 MCP
安装 n8n-skills@n8n-io 后,单独连接实例的 /mcp-server/http。技能插件与 MCP 连接分别配置。
n8n 文档包含 Codex 配置说明,而且技能仓也点名 Codex。技能插件不会替 Codex 登记 MCP。先在 n8n 打开 Settings → Instance-level MCP。Cloud 示例主机是 acme.app.n8n.cloud,完整入口是 https://acme.app.n8n.cloud/mcp-server/http。本机默认是 http://localhost:5678/mcp-server/http。路径是 /mcp-server/http,不是 /mcp,也不是编辑器地址栏。
技能仓要求 Codex 0.142.0 以上:
codex plugin marketplace add n8n-io/skills
codex plugin add n8n-skills@n8n-io
清单 .agents/plugins/marketplace.json 的 name 是 n8n-io,插件 name 是 n8n-skills,所以是 n8n-skills@n8n-io。装完会弹出 hook 信任提示(SessionStart / PreToolUse / PostToolUse),批准后再新开会话。
然后才接线。技能仓 Codex 节用表名 n8n-mcp:
codex mcp add n8n-mcp --url https://acme.app.n8n.cloud/mcp-server/http
codex mcp login n8n-mcp
[mcp_servers.n8n-mcp]
url = "https://acme.app.n8n.cloud/mcp-server/http"
enabled = true
文档客户端示例把 OAuth 表写成 n8n,命令是 codex mcp add n8n --url … 再 mcp login n8n。两张表指向同一 URL,选择一种即可。走技能仓就用 n8n-mcp;只要 MCP、不要技能才用文档那张 n8n。
此连接无需启用 experimental_use_rmcp_client。现行 Codex 自己连 Streamable HTTP。
无头 / CI 才用 API key。文档把密钥写进 http_headers 的 authorization = "Bearer …",不要抄。改用 bearer_token_env_var,变量必须在启动 Codex 的进程里:
[mcp_servers.n8n-mcp]
url = "https://acme.app.n8n.cloud/mcp-server/http"
bearer_token_env_var = "N8N_MCP_TOKEN"
enabled = true
OAuth 与 Bearer token 请选择一种认证方式。API key 认证无需 OAuth 登录。
还要给具体工作流打开 Available in MCP。实例开关不等于每条都能跑。execute_workflow 默认跑已发布版本。能改工作流,保持工具批准。
网页 Cloud 不读取 ~/.codex/config.toml。配置后重新打开会话。用 codex mcp get n8n-mcp 看传输是 streamable_http,url 是 https://acme.app.n8n.cloud/mcp-server/http。