n8n MCP 教程：把工作流暴露成工具，让 Claude 和 Cursor 直接调用

n8n 和 MCP 的组合是 2026 年自动化圈最实用的搭配之一：n8n 负责把各种服务串成工作流，MCP（Model Context Protocol）负责让 AI 客户端（Claude Code、Cursor 等）直接调用这些工作流。你在 n8n 里搭好「查订单 → 生成日报 → 发飞书」，Claude 里说一句话就能触发。

两个方向都要会：

• 正向：把 n8n 工作流暴露成 MCP 工具，给 AI 客户端调用（最常用）
• 反向：n8n 工作流里调用别人的 MCP 服务（比如让工作流直接用搜索、浏览器工具）

前置准备

1. n8n 版本：1.90 以上（MCP 相关节点从 2025 年中开始内置，旧版本先升级）
2. 部署方式：云端版（n8n Cloud）和自建版（Docker / npm）都支持 MCP；自建注意端口可被 AI 客户端访问
3. 一个能跑的工作流：先把工作流本身调通，再加 MCP 出入口

第一步：把工作流暴露成 MCP Server

1. 新建工作流，添加 MCP Server Trigger 节点作为入口
2. 在节点里定义工具名和描述——描述要写清楚什么时候该用这个工具，AI 靠它决定要不要调用（这本身就是一次 prompt 写作）
3. 后面接上你原有的处理节点（HTTP 请求、数据库、飞书通知都行），最后用 Respond to Client 节点把结果返回给 AI
4. 保存并激活工作流，节点上会显示这个工作流的 SSE 端点地址（形如 http://你的n8n地址/mcp/工作流ID/sse），复制备用

第二步：在 AI 客户端里配置

Claude Code（终端一条命令）：

claude mcp add --transport sse my-n8n http://127.0.0.1:5678/mcp/工作流ID/sse

Cursor（编辑 ~/.cursor/mcp.json）：

{
  "mcpServers": {
    "my-n8n": {
      "url": "http://127.0.0.1:5678/mcp/工作流ID/sse"
    }
  }
}

配置完成后重启客户端，工具列表里就能看到你在 n8n 里定义的工具。之后直接对话：「帮我跑一下日报工作流」，AI 会自己发起调用。

安全提醒：生产环境务必给 MCP 端点加认证（n8n 的 API 鉴权或反向代理层加 token），不要把未保护的 n8n 地址暴露在公网。

第三步（反向玩法）：工作流里调用外部 MCP 服务

在 n8n 里添加 MCP Client Tool 节点：

1. 填外部 MCP Server 的地址（比如搜索、浏览器自动化类服务）
2. 选择要暴露给工作流的工具
3. 在后续节点里像调用普通函数一样用它

典型场景：AI 客服工作流里，遇到要查实时信息的地方，直接经 MCP 调搜索服务，不用自己维护搜索 API 的对接代码。

常见报错排查

相关阅读

• Claude Code 提示词技巧
• CatPaw 上手指南：全场景 AI Agent 平台怎么用