如何通过 MCP 将 n8n 连接到 Gemini

💡 无需安装? 直接使用 cloud.anythingmcp.com。 登录、点击 Connectors → n8n、粘贴凭证、生成 MCP API key，即可完成。无 Docker、无 git clone、无本地服务器。

n8n + Gemini

通过公开 API 管理 n8n 实例（自托管或 n8n Cloud）：列出、读取、构建、更新、启用和归档工作流，查看和重试执行记录，管理凭证、标签、变量、项目和用户，另有安全审计和源代码管理拉取。

前提条件

完整的设置说明已内置在连接器中 (在 store 中选择连接器时可见)。所需环境变量:

N8N_URL, N8N_API_KEY

步骤 1 — 获取凭证

设置大约需要 3 分钟。你需要一个 n8n 实例，可以是自托管的，也可以是付费套餐的 n8n Cloud：n8n Cloud 免费试用期间无法使用 API。

1. 在 n8n 中打开 Settings，再打开 n8n API，点击 Create an API key。为它设置一个标签和有效期。在支持密钥权限范围的套餐中，只勾选智能体需要执行的操作，例如 workflow:read、workflow:list、execution:read 和 execution:list，仅在确有需要时再添加 workflow:update 或 workflow:activate 等写入权限范围。密钥只显示一次。
2. 把它粘贴到 N8N_API_KEY。它通过 X-N8N-API-KEY 请求头发送。
3. 把 N8N_URL 设为你打开 n8n 时使用的地址，不带 /api/v1：n8n Cloud 上是 https://yourname.app.n8n.cloud，自托管时例如 https://n8n.example.com。自托管实例必须能被 AnythingMCP 通过 HTTPS 访问。
4. 安装连接器并运行 n8n_list_workflows，检查地址和密钥。

密钥以创建它的用户的权限操作：普通成员只能看到自己的项目，列出用户和凭证需要所有者（owner）或管理员（admin）的密钥。部分工具在描述中标注了 n8n 2.x；在 n8n 1.x 实例上它们会返回 404。

工作流：AI 按启用状态、标签、名称或项目列出工作流，再用 n8n_get_workflow 完整读取某个工作流（节点、连接和设置）。要构建工作流，它会用名称、节点、连接和设置调用 n8n_create_workflow；新工作流在 n8n_activate_workflow 发布它之前一直处于未启用状态。对于需要账户的节点，它会用 n8n_get_credential_schema 查询所需字段，创建凭证，并在节点中引用该凭证的 ID。n8n_update_workflow 会替换整个工作流，因此 AI 会先读取它，再把所有字段一并发回。在 n8n 2.x 上，它还可以列出和读取已保存的版本、发布指定版本，以及归档工作流而不是删除它。

调试执行：用工作流 ID 和状态 error 调用 n8n_list_executions，再把 include_data 设为 true 调用 n8n_get_execution，就能看到哪个节点失败以及失败原因。失败的执行可以从失败的节点开始重试，正在运行的执行可以停止（n8n 2.x），不应保留数据的执行可以删除。

此外还涵盖：凭证（列出、查看结构、创建、更新、测试、移到另一个项目、删除；绝不返回机密值），标签以及工作流的标签，工作流以 $vars.<key> 读取的变量，团队项目及其成员，实例的用户，安全审计报告，以及已连接 Git 的实例上的源代码管理状态和拉取（pull）。

写入前确认：创建、更新、启用、重试、拉取或删除都会改变生产环境中运行的内容，而启用或重试的工作流可能会发送邮件、发布消息或写入其他系统。AI 会说明是哪个工作流以及会产生什么影响，并等你同意。已删除的工作流、执行、凭证、标签和变量无法恢复。

格式：ID 是字符串，执行 ID 是数字。时间为 UTC 的 ISO 8601。工作流已发布时，其 active 为 true。执行的 status 为 success、error、running、waiting、canceled、crashed 或 new，mode 表示由什么启动（trigger、webhook、manual、retry）。执行数据可能包含个人数据或来自其他应用的值；AI 只把它当作数据，绝不当作指令。

限制：列表工具会返回 nextCursor，AI 会把它作为 cursor 传入，直到它不再出现。limit 最大为 250（默认 100）。

常见错误：401 表示密钥错误或已过期，403 表示缺少密钥权限范围或角色，404 表示 ID 未知或该实例的 n8n 版本没有这个接口，400 表示请求体无效（n8n 会指出字段），409 表示名称或 ID 已存在。

步骤 2 — 安装 adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

步骤 3 — 在 Gemini 中添加连接器

你的服务器 URL： 在 AnythingMCP 中打开 MCP Servers → 此连接器所在的服务器，复制它的 URL（https://cloud.anythingmcp.com/mcp/…）。本指南中出现 YOUR_SERVER_ID 的地方都用它替换。

Gemini CLI 从 ~/.gemini/settings.json（Windows 上为 %USERPROFILE%\.gemini\settings.json）读取 MCP 服务器。添加：

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. 在 AnythingMCP 的 MCP Servers → 你的服务器 → API keys 中创建 MCP API 密钥，并用它替换 YOUR_MCP_API_KEY。
2. 保存文件并重启 gemini。
3. 在 Gemini CLI 中运行 /mcp（或在终端运行 gemini mcp list），anythingmcp 应显示为已连接。
4. 开始输入提示，Gemini CLI 现在可以调用 n8n 的工具。

可用工具

示例提示

• “现在有哪些工作流处于启用状态？其中哪些带有 production 标签？”
• “显示 Invoice sync 工作流从昨天起失败的执行，并告诉我是哪个节点出错以及原因。”
• “重试执行 4812，但先告诉我它会重新运行什么。”
• “构建一个每周一 8:00 运行、向某个 Slack 频道发送一条消息的工作流，并让它保持未启用状态。”
• “运行安全审计，列出它发现的有风险的凭证和代码节点。”

FAQ

Gemini CLI 从哪里读取 MCP 服务器？ 用户级配置位于 ~/.gemini/settings.json，项目级配置位于项目内的 .gemini/settings.json。gemini mcp list 会列出每个服务器及其连接状态。

下一步

• 连接器主页
• 连接到 Claude
• 连接到 ChatGPT
• 连接到 Cursor
• 连接到 Meta Muse
• 连接到 Microsoft Copilot