---
title: "配置 n8n 技能插件与 MCP"
summary: "安装 n8n-skills@n8n-io 后，单独连接实例的 /mcp-server/http。技能插件与 MCP 连接分别配置。"
category: skills
level: starter
surfaces: [cli, app, ide]
tags: ["plugins", "n8n", "Skills", "MCP"]
canonical: /tips/n8n-codex-mcp/
---

# 配置 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 以上：

```bash
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`：

```bash
codex mcp add n8n-mcp --url https://acme.app.n8n.cloud/mcp-server/http
codex mcp login n8n-mcp
```

```toml
[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 的进程里：

```toml
[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`。

## 来源

- [n8n · MCP client examples](https://docs.n8n.io/connect/connect-to-n8n-mcp-server/mcp-client-examples/)
- [n8n · Connect to MCP server](https://docs.n8n.io/connect/connect-to-n8n-mcp-server/)
- [n8n-io/skills](https://github.com/n8n-io/skills)