n8n 中文文档

MCP 客户端连接示例

这些示例显示了将特定客户端连接到 n8n 的 MCP 服务器的确切命令和配置。在使用它们之前,请在您的实例上启用 MCP 访问,并按照连接 MCP 客户端中的说明选择身份验证方法。

提示

连接客户端 对话框(从 n8n 2.33.0 开始提供)提供一键设置来连接 Claude.ai、Cursor 和 VS Code。它还提供了 Claude Code、Codex、Gemini CLI、ChatGPT 和 Windsurf 的交互式设置步骤。请参阅 使用 OAuth(推荐) 了解如何打开对话框并选择您的客户端。

如果您选择的客户端的 n8n 中未显示交互步骤,则以下示例非常有用,可用于参考目的或手动配置。

以下示例均使用 https://。如果您的实例提供纯 HTTP 服务(例如位于 http://localhost:5678 的本地安装),请改用 http://。无论使用哪种协议,从 n8n 复制完整的 Server URL 服务器 URL 都能获得正确的前缀。

将 Lovable 连接到 n8n MCP 服务器

  1. 在Lovable(OAuth)中配置MCP服务器。 * 导航到您的工作区设置 > 集成。 * 在 MCP 服务器部分中,找到 n8n 并单击 连接。 * 输入您的 n8n 服务器 URL:连接客户端 对话框中显示的 服务器 URL 值。 * 保存连接。如果成功,n8n 会将您重定向到 Lovable 以批准访问。
  2. 验证连接性。 * 连接后,Lovable 可以查询启用了 MCP 访问的工作流程。 * 示例: 要求 Lovable 构建一个列出用户并允许删除用户的工作流程 UI。

将 Claude 桌面连接到 n8n MCP 服务器

使用 OAuth(推荐)

  1. 导航到 Claude 桌面中的 设置 > 连接器。
  2. 单击“添加自定义连接器”。
  3. 输入以下详细信息: * 名称: n8n MCP * Remote MCP Server URL:Connect a client 连接客户端 对话框中显示的 Server URL 服务器 URL 值。该 URL 以 /mcp-server/http 结尾,形式类似 https://<your-n8n-domain>/mcp-server/http。它不是 n8n 编辑器的地址,请勿粘贴浏览器地址栏中的 URL。
  4. 保存连接器。
  5. 出现提示时,批准 Claude Desktop 的访问权限。

使用 API 密钥

将以下条目添加到您的 claude_desktop_config.json 文件中:

"mcpServers": {
  "n8n-mcp": {
    "command": "npx",
    "args": [
    "-y",
    "supergateway",
    "--streamableHttp",
    "https://<your-n8n-domain>/mcp-server/http",
    "--header",
    "Authorization:Bearer <YOUR_N8N_MCP_TOKEN>"
    ]
  }
}

在这里,替换:

  • <your-n8n-domain>:不含 https:// 前缀的 n8n 域名。在 n8n Cloud 上,该域名为 your-instance.app.n8n.cloud;自托管时,则是提供 n8n 编辑器服务的域名,例如 n8n.example.com。您可以在 n8n 的 Settings 设置 > Instance-level MCP 实例级 MCP > Connect a client 连接客户端 > Server URL 服务器 URL 中找到完整的服务器 URL。

将 Claude 代码连接到 n8n MCP 服务器

选项 1:使用 OAuth 进行身份验证(推荐)

使用以下 CLI 命令:

claude mcp add --transport http n8n https://<your-n8n-domain>/mcp-server/http

或者,将以下条目添加到 claude.json 文件中:

{
    "mcpServers": {
        "n8n": {
            "type": "http",
            "url": "https://<your-n8n-domain>/mcp-server/http"
        }
    }
}

在这里,替换:

  • <your-n8n-domain>:不含 https:// 前缀的 n8n 域名。在 n8n Cloud 上,该域名为 your-instance.app.n8n.cloud;自托管时,则是提供 n8n 编辑器服务的域名,例如 n8n.example.com。您可以在 n8n 的 Settings 设置 > Instance-level MCP 实例级 MCP > Connect a client 连接客户端 > Server URL 服务器 URL 中找到完整的服务器 URL。

在Claude代码中运行/mcp,选择n8n完成OAuth授权。

选项 2:使用 API 密钥进行身份验证

使用以下 CLI 命令:

claude mcp add --transport http n8n-mcp https://<your-n8n-domain>/mcp-server/http \
  --header "Authorization: Bearer <YOUR_N8N_MCP_TOKEN>"

或者,将以下条目添加到 claude.json 文件中:

{
    "mcpServers": {
        "n8n-mcp": {
            "type": "http",
            "url": "https://<your-n8n-domain>/mcp-server/http",
            "headers": {
                "Authorization": "Bearer <YOUR_N8N_MCP_TOKEN>"
            }
        }
    }
}

在这里,替换:

  • <your-n8n-domain>:不含 https:// 前缀的 n8n 域名。在 n8n Cloud 上,该域名为 your-instance.app.n8n.cloud;自托管时,则是提供 n8n 编辑器服务的域名,例如 n8n.example.com。您可以在 n8n 的 Settings 设置 > Instance-level MCP 实例级 MCP > Connect a client 连接客户端 > Server URL 服务器 URL 中找到完整的服务器 URL。
  • <YOUR_N8N_MCP_TOKEN>:您生成的令牌

将 Codex CLI 连接到 n8n MCP 服务器

选项 1:使用 OAuth 进行身份验证(推荐)

使用以下 CLI 命令:

codex mcp add n8n --url "https://<your-n8n-domain>/mcp-server/http"

或者,将以下条目添加到 ~/.codex/config.toml 文件中:

[features]
experimental_use_rmcp_client = true

[mcp_servers.n8n]
url = "https://<your-n8n-domain>/mcp-server/http"

提示

[features] 块启用 Codex 的 HTTP MCP 客户端。较旧的 Codex 版本需要它;较新的版本会忽略它。

在这里,替换:

  • <your-n8n-domain>:不含 https:// 前缀的 n8n 域名。在 n8n Cloud 上,该域名为 your-instance.app.n8n.cloud;自托管时,则是提供 n8n 编辑器服务的域名,例如 n8n.example.com。您可以在 n8n 的 Settings 设置 > Instance-level MCP 实例级 MCP > Connect a client 连接客户端 > Server URL 服务器 URL 中找到完整的服务器 URL。

运行codex mcp login n8n完成OAuth授权。

选项 2:使用 API 密钥进行身份验证

将以下条目添加到您的 ~/.codex/config.toml 文件中:

[features]
experimental_use_rmcp_client = true

[mcp_servers.n8n-mcp]
url = "https://<your-n8n-domain>/mcp-server/http"
http_headers = { "authorization" = "Bearer <YOUR_N8N_MCP_TOKEN>" }

在这里,替换:

  • <your-n8n-domain>:不含 https:// 前缀的 n8n 域名。在 n8n Cloud 上,该域名为 your-instance.app.n8n.cloud;自托管时,则是提供 n8n 编辑器服务的域名,例如 n8n.example.com。您可以在 n8n 的 Settings 设置 > Instance-level MCP 实例级 MCP > Connect a client 连接客户端 > Server URL 服务器 URL 中找到完整的服务器 URL。
  • <YOUR_N8N_MCP_TOKEN>:您生成的令牌

将 Gemini CLI 连接到 n8n MCP 服务器

使用以下 CLI 命令:

gemini mcp add --transport http n8n https://<your-n8n-domain>/mcp-server/http

或者,将以下条目添加到 ~/.gemini/settings.json 文件中:

{
    "mcpServers": {
        "n8n": {
            "httpUrl": "https://<your-n8n-domain>/mcp-server/http"
        }
    }
}

在这里,替换:

  • <your-n8n-domain>:不含 https:// 前缀的 n8n 域名。在 n8n Cloud 上,该域名为 your-instance.app.n8n.cloud;自托管时,则是提供 n8n 编辑器服务的域名,例如 n8n.example.com。您可以在 n8n 的 Settings 设置 > Instance-level MCP 实例级 MCP > Connect a client 连接客户端 > Server URL 服务器 URL 中找到完整的服务器 URL。

在Gemini CLI中运行/mcp,选择n8n,完成OAuth授权。

将 Cursor 连接到 n8n MCP 服务器

在连接客户端对话框中,从您的客户端中选择Cursor,然后选择一键设置打开Cursor并自动添加n8n服务器。当 Cursor 将您重定向回 n8n 时批准访问。

或者,将以下条目添加到您的 ~/.cursor/mcp.json 文件(或项目的 .cursor/mcp.json)中:

{
  "mcpServers": {
    "n8n": {
      "type": "streamable-http",
      "url": "https://<your-n8n-domain>/mcp-server/http"
    }
  }
}

在这里,替换:

  • <your-n8n-domain>:不含 https:// 前缀的 n8n 域名。在 n8n Cloud 上,该域名为 your-instance.app.n8n.cloud;自托管时,则是提供 n8n 编辑器服务的域名,例如 n8n.example.com。您可以在 n8n 的 Settings 设置 > Instance-level MCP 实例级 MCP > Connect a client 连接客户端 > Server URL 服务器 URL 中找到完整的服务器 URL。

将 VS Code 连接到 n8n MCP 服务器

在 连接客户端 对话框中,从 您的客户端 中选择 VS Code,然后选择 一键设置 打开 VS Code 并自动添加 n8n 服务器。当 VS Code 将您重定向回 n8n 时批准访问。

或者,将以下条目添加到工作区的 .vscode/mcp.json 文件中:

{
  "servers": {
    "n8n": {
      "type": "http",
      "url": "https://<your-n8n-domain>/mcp-server/http"
    }
  }
}

在这里,替换:

  • <your-n8n-domain>:不含 https:// 前缀的 n8n 域名。在 n8n Cloud 上,该域名为 your-instance.app.n8n.cloud;自托管时,则是提供 n8n 编辑器服务的域名,例如 n8n.example.com。您可以在 n8n 的 Settings 设置 > Instance-level MCP 实例级 MCP > Connect a client 连接客户端 > Server URL 服务器 URL 中找到完整的服务器 URL。

将 Windsurf 连接到 n8n MCP 服务器

将以下条目添加到您的 ~/.codeium/windsurf/mcp_config.json 文件中:

{
  "mcpServers": {
    "n8n": {
      "serverUrl": "https://<your-n8n-domain>/mcp-server/http"
    }
  }
}

在这里,替换:

  • <your-n8n-domain>:不含 https:// 前缀的 n8n 域名。在 n8n Cloud 上,该域名为 your-instance.app.n8n.cloud;自托管时,则是提供 n8n 编辑器服务的域名,例如 n8n.example.com。您可以在 n8n 的 设置 > 实例级 MCP > 连接客户端 > 服务器 URL 中找到完整的服务器 URL。

当 Windsurf 在第一次连接尝试时将您重定向到 n8n 时批准访问。

将 Google ADK 代理连接到 n8n MCP 服务器

以下是创建连接到远程 n8n MCP 服务器的代理的示例代码:

from google.adk.agents import Agent
from google.adk.tools.mcp_tool import McpToolset
from google.adk.tools.mcp_tool.mcp_session_manager import StreamableHTTPServerParams

N8N_INSTANCE_URL = "https://n8n.example.com"
N8N_MCP_TOKEN = "YOUR_N8N_MCP_TOKEN"

root_agent = Agent(
    model="gemini-2.5-pro",
    name="n8n_agent",
    instruction="Help users manage and execute workflows in n8n",
    tools=[
        McpToolset(
            connection_params=StreamableHTTPServerParams(
                url=f"{N8N_INSTANCE_URL}/mcp-server/http",
                headers={
                    "Authorization": f"Bearer {N8N_MCP_TOKEN}",
                },
            ),
        )
    ],
)

在这里,替换:

  • N8N_INSTANCE_URL:n8n 实例的基础 URL。在 n8n Cloud 上,该 URL 为 https://your-instance.app.n8n.cloud;自托管时,则是您自己的 URL,例如 https://n8n.example.com。您可以在 n8n 的 Settings 设置 > Instance-level MCP 实例级 MCP > Connect a client 连接客户端 > Server URL 服务器 URL 中找到完整的服务器 URL。
  • YOUR_N8N_MCP_TOKEN:您生成的访问令牌

有关更多详细信息,请参阅 将 ADK 代理连接到 n8n。

故障排除

如果客户端未使用上述步骤进行连接,请参阅 MCP 服务器主页上的 故障排除。

相关资源

不想自己部署和维护 n8n?n8ncn 托管 n8n 云服务:开通账号即可使用,不用买服务器;也可以在 n8ncn 工作流库 找现成的中文工作流。