连接到 n8n docs MCP server
n8n 文档发布了两个 Model Context Protocol (MCP) server。将 AI 工具连接到其中一个 server,即可让它搜索 n8n 知识并在你工作时回答问题。
这两个 server 使用不同来源。根据你希望 AI 工具如何回答来选择:
| Server | 来源 | 最适合 |
|---|---|---|
| GitBook docs server | 仅已发布的 n8n 文档 | 搜索和阅读准确的文档页面。文档是唯一权威来源。 |
| Kapa.ai server | 文档、community forum 和 n8n blog | 文档本身无法覆盖的更广泛问题,例如故障排除和真实案例。它与文档站点上的 AI Assistant 使用同一引擎。 |
你可以同时连接两个 server。当你希望答案严格基于文档时,使用 GitBook server;当你希望答案来自 n8n 更广泛知识库时,使用 Kapa.ai server。
两个 server 都使用 HTTP transport,因此你的 AI 工具需要支持通过 HTTP 连接远程 MCP server。它们都不支持 stdio 或 SSE。
MCP server URL
使用你想连接的 server 端点:
| Server | URL |
|---|---|
| GitBook docs server | https://docs.n8n.io/~gitbook/mcp |
| Kapa.ai server | https://n8n.mcp.kapa.ai |
连接你的 AI 工具
具体步骤因工具而异,但每个工具都需要上面的 server URL。以下示例会同时设置两个 server。如果只想连接其中一个,保留你需要的配置并移除另一个。
提示
Kapa.ai server 需要身份验证。你的 AI 工具会在首次连接或首次使用时打开基于浏览器的登录流程。按提示批准连接。
Claude Code
在终端中运行:
claude mcp add --transport http n8n-docs https://docs.n8n.io/~gitbook/mcp
claude mcp add --transport http n8n-kapa https://n8n.mcp.kapa.ai
Cursor
将 server 添加到 mcp.json 文件:
{
"mcpServers": {
"n8n-docs": {
"url": "https://docs.n8n.io/~gitbook/mcp"
},
"n8n-kapa": {
"url": "https://n8n.mcp.kapa.ai"
}
}
}
VS Code
将 server 添加到 mcp.json 文件:
{
"servers": {
"n8n-docs": {
"type": "http",
"url": "https://docs.n8n.io/~gitbook/mcp"
},
"n8n-kapa": {
"type": "http",
"url": "https://n8n.mcp.kapa.ai"
}
}
}
其他工具
对于其他 MCP client,在其 MCP 设置中添加新的远程 (HTTP) server,并输入 server URL:
https://docs.n8n.io/~gitbook/mcp
https://n8n.mcp.kapa.ai
连接后,你的工具就可以在你工作时搜索 n8n 知识。
提示
具体配置步骤和文件位置会因工具和版本而异。请查看对应工具的文档,了解如何添加远程 MCP server。关于 Kapa.ai server 的更多信息,请参阅 Kapa.ai MCP 文档。
相关资源
不想自己部署和维护 n8n?n8ncn 托管 n8n 云服务:开通账号即可使用,不用买服务器;也可以在 n8ncn 工作流库 找现成的中文工作流。