1. 为什么我劝你别再手搓 HTTP 节点调大模型如果你已经在 n8n 里拖过 HTTP Request 节点去调大模型接口大概经历过这种循环先翻文档找 base_url再拼 Authorization 头然后发现 body 里的 model 名字写错了改完又碰上流式返回解析不了。一个简单的「用户提问 → 模型回答」流程光调试请求格式就能耗掉半小时。n8n 本身是个开源工作流自动化平台GitHub 上 82K Star节点系统是它的核心。而 MCPModel Context Protocol做的事情是给大模型提供一个访问外部工具与数据的统一接口——你可以把它理解成一个「万能插槽」模型通过这个插槽去调用搜索、数据库、文件系统等能力。但插槽本身不产生价值真正让模型跑起来的是工作流谁触发、传什么参数、结果给谁。这篇要解决的问题很具体在 n8n 里用 5 个节点搭出一条能跑通的 AI 工作流其中 MCP 节点负责工具调用模型通道走 TaoToken 统一 Key。所谓统一 Key就是你不用为每个模型厂商单独申请一套凭证一个 Key 覆盖对话、编码等场景base_url 指向https://taotoken.net/api即可。适合谁适合已经装好 n8n、想快速验证 MCP 工作流组合、但不想在鉴权和请求格式上反复踩坑的开发者。下面按「装环境 → 配通道 → 搭 5 节点 → 端到端验证 → 排错」的顺序走一遍命令和参数都可以直接复制。2. 前置准备n8n 跑起来MCP 节点装上2.1 用 Docker 起一个 n8nn8n 官方推荐 Docker 部署数据持久化是关键——不映射卷的话下次升级镜像你的凭证和工作流全没。先建一个数据目录名字别用中文mkdir -p ~/n8n-data docker run -d \ --name n8n \ -p 5678:5678 \ -v ~/n8n-data:/home/node/.n8n \ -e N8N_SECURE_COOKIEfalse \ n8nio/n8nN8N_SECURE_COOKIEfalse是为了本地 http 访问时不被 cookie 安全策略挡住。启动后看日志docker logs -f n8n出现Editor is now accessible via: http://localhost:5678/就说明起来了浏览器打开这个地址进入编辑器。2.2 安装 MCP 社区节点n8n 内置节点不含 MCP需要装社区节点。路径是左下角 Settings → Community nodes → Install a community node在 npm 包名里填n8n-nodes-mcp点安装等它拉完依赖。装好后在节点面板搜索MCP就能看到。这里有个坑社区节点安装依赖 npm 源可达如果卡在 installing 不动先确认容器能正常访问 npm registry别急着怀疑节点本身有问题。2.3 拿一个 TaoToken 的 Key打开https://taotoken.net/api-keys登录后创建一个 API Key复制保存。这个 Key 后面会填进 n8n 的凭证里。同时记住两个地址用途地址API 基址填进 n8nhttps://taotoken.net/api接入文档查参数https://taotoken.net/doc如果你后面要跑长期编码类或 Agent 类工作流可以顺带看下 Coding Plan 页面按用量选套餐比单次调用更划算。模型对话类的轻量验证直接用 API Key 就够。3. 可复制配置5 个节点搭出 AI 工作流整条链路是手动触发 → 设置输入 → MCP 工具调用 → 模型对话 → 结果输出。下面逐个节点给配置。3.1 节点一Manual Trigger从节点面板拖入Manual Trigger不需要任何参数。它的作用是让你点一下就能跑调试阶段比 Webhook 省事。等流程稳定了再换成 Webhook 或 Schedule Trigger。3.2 节点二Set构造输入拖入Set节点用来定义这次请求的输入变量。添加两个字段{ user_query: 帮我查一下今天需要处理的待办事项, session_id: test-001 }user_query是给模型的用户消息session_id用于区分会话。Set 节点的好处是把输入和后续节点解耦改测试用例只动这一处。3.3 节点三MCP Client工具调用这是核心节点。拖入MCP Client在 Credentials 里新建一个 MCP 凭证关键参数{ command: npx, args: [-y, modelcontextprotocol/server-everything], transport: stdio }server-everything是 MCP 官方提供的测试服务器包含 echo、add 等示例工具适合先跑通链路。生产环境换成你自己的 MCP Server 即可transport 按实际选 stdio 或 SSE。在节点的 Tool 选择里勾选你要暴露给模型的工具比如echo。Operation 选Call Tool参数用表达式引用上一步的输入{{ $json.user_query }}3.4 节点四AI Agent / 模型对话走 TaoToken 通道拖入AI Agent节点或Basic LLM Chain看你 n8n 版本。在模型凭证里选OpenAI类型然后填自定义 base_url参数值Base URLhttps://taotoken.net/apiAPI Key你刚才创建的 KeyModel按文档里的模型名填例如对话类模型System Prompt 里写清楚工具使用规则你是一个工作流助手。当用户请求涉及工具能力时调用已挂载的 MCP 工具 否则直接回答。回答保持简洁。把 MCP Client 节点作为 Tool 挂到 Agent 上Agent 就会在需要时自动触发工具调用。这一步是整个工作流「智能」的来源——模型决定调不调工具、调哪个。3.5 节点五Set / Respond整理输出最后拖一个Set节点把模型返回内容提取成干净字段{ answer: {{ $json.output }}, session_id: {{ $(Set).item.json.session_id }} }如果你后面要接 Webhook 返回把最后一个节点换成Respond to Webhook即可。到这里 5 个节点连成一条线点 Manual Trigger 就能跑。4. 端到端验证确认工作流真的通了配置完别急着庆祝先做一次完整验证。点击画布上的Execute Workflow观察每个节点的执行状态。预期结果Manual Trigger 亮绿 → Set 输出两个字段 → MCP Client 显示工具调用记录能看到echo被调用→ AI Agent 返回模型回复 → 最后 Set 输出answer字段。如果 MCP 工具被正确触发你会在 MCP Client 节点的输出里看到类似{ content: [ { type: text, text: Echo: 帮我查一下今天需要处理的待办事项 } ] }同时 AI Agent 的回复里会引用这个工具结果。这说明三件事都成立TaoToken 通道鉴权通过、模型正常返回、MCP 工具被模型识别并调用。想单独验证模型通道是否通可以打开https://taotoken.net/model-chat直接对话测试确认 Key 有效后再回 n8n 排查工作流层的问题能省不少时间。再补一个验证动作把user_query改成不需要工具的问题比如「11 等于几」重新执行。如果这次 MCP Client 没有被触发、模型直接回答说明 Agent 的工具决策逻辑是正常的——该调才调不是无脑调。5. 本篇常见错排查5.1 MCP Server 连不上最常见的是command not found: npx。n8n 跑在容器里容器内不一定有 node/npx。解决办法是在 Docker 启动时换一个自带 node 的镜像或者把 MCP Server 用 SSE 方式独立部署n8n 这边用 SSE transport 连过去。如果日志报spawn ENOENT基本就是命令路径问题。进容器确认docker exec -it n8n sh which npx没有输出就说明容器里缺 node 环境。5.2 模型返回 401 / 403先确认 Key 有没有复制完整前后别带空格。然后确认 Base URL 填的是https://taotoken.net/api不是带路径的完整 endpoint——n8n 的 OpenAI 凭证会自动拼/v1/chat/completions这类路径你多填反而会 404。如果报model not found去接入文档核对模型名别凭记忆写。5.3 工具没被调用模型不调工具通常是 System Prompt 没写清楚或者工具描述太模糊。把工具的 description 写具体比如「当用户询问待办事项时调用此工具」比「一个工具」有效得多。另外确认 MCP Client 节点确实作为 Tool 挂到了 Agent 上而不是当成普通节点串在链路里。5.4 凭证保存后仍报鉴权失败n8n 的凭证有缓存改完 Key 后建议删掉旧凭证重新建一个。另外检查是不是在多个节点里用了不同凭证导致一个对一个错。6. 把这条链路用起来跑通之后你可以把 Manual Trigger 换成 Webhook让外部系统 POST 一个 query 进来把server-everything换成真实的 MCP Server接上你的数据库或内部 API模型通道继续用 TaoToken 的统一 Key不用为每个模型单独维护凭证。需要长期跑编码类或 Agent 类任务的可以看下 Coding Plan 的用量方案只是偶尔验证模型的用 API Key 加模型对话页面就够。接入细节和参数以官方文档为准https://taotoken.net/doc。最后留一个我踩过的坑MCP 节点的工具列表是启动时拉取的如果你改了 MCP Server 的工具定义记得重启 n8n 容器不然节点里还是旧列表怎么调都不对。