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 服务器
- 在Lovable(OAuth)中配置MCP服务器。 * 导航到您的工作区设置 > 集成。 * 在 MCP 服务器部分中,找到 n8n 并单击 连接。 * 输入您的 n8n 服务器 URL:连接客户端 对话框中显示的 服务器 URL 值。 * 保存连接。如果成功,n8n 会将您重定向到 Lovable 以批准访问。
- 验证连接性。 * 连接后,Lovable 可以查询启用了 MCP 访问的工作流程。 * 示例: 要求 Lovable 构建一个列出用户并允许删除用户的工作流程 UI。
将 Claude 桌面连接到 n8n MCP 服务器
使用 OAuth(推荐)
- 导航到 Claude 桌面中的 设置 > 连接器。
- 单击“添加自定义连接器”。
- 输入以下详细信息:
* 名称: 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。 - 保存连接器。
- 出现提示时,批准 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 服务器主页上的 故障排除。