n8n 中文文档

连接到 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 工作流库 找现成的中文工作流。