1. Dify v1.6.0 双向 MCP 到底解决了什么问题Dify v1.6.0 最核心的变化是支持双向 MCP既能从 Dify 的 Agent 和工作流里调用外部 MCP 服务也能把 Dify 自己的应用反向暴露成标准 MCP 端点给别的客户端用。说白了就是“与己方便与人方便”——你既可以用别人的工具也能把自己的工作流打包成工具给别人调。这个功能适合谁如果你已经在用 Dify 搭 Agent 或 Chatflow但受限于插件生态不够全想接本地文件、数据库、第三方图表服务那双向 MCP 就是最直接的扩展方式。另一个场景是团队内部你把一个知识库问答工作流发布成 MCP 服务其他同事在 Cursor、Trae、VS Code 里直接调用不用重复搭一套。但实际配置时有个绕不开的问题每个 MCP 服务、每个客户端都要单独配 Key 和 API 地址Agent 调外部工具一套凭证工作流反向暴露又一套客户端接入再来一套。管理起来很碎。我试过用 TaoToken 做统一 Key 和 API 通道把模型调用和 MCP 接入收敛到一个入口配置量能明显降下来。下面按“前置准备 → 配置骨架 → 双向注册 → 连通性验证 → 报错排查”的顺序走一遍目标是你复制配置就能跑通。2. TaoToken 前置统一 Key 与 API 通道准备TaoToken 在这里的角色是统一模型调用入口。Dify 里 Agent 节点、工作流里的 LLM 节点、以及 MCP 服务背后如果涉及模型推理都可以走同一个 API 通道不用每个服务单独申请和轮换 Key。先拿到 API Key。打开控制台页面https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite在 API Keys 页面创建一个新 Key复制保存。这个 Key 后面会填到 Dify 的模型供应商配置里也会用在 MCP 服务端的环境变量中。API 基础地址统一用https://taotoken.net/api注意这个地址不加 UTM 参数直接作为 base_url 填。模型对话调试可以在模型对话页先验证 Key 是否可用https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite如果你后续要长期跑编码类 Agent 或高频工作流可以看下 Coding Plan 的额度方案https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite接入文档在这里配置格式和参数说明以文档为准https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite前置准备就三样一个 API Key、base_url 用https://taotoken.net/api、以及确认 Dify 版本 ≥ v1.6.0。版本不够的话先升级双向 MCP 的入口在旧版里没有。3. 可复制配置settings.json 与 config.toml 骨架这一节给两份可直接改的配置骨架。settings.json 用于 MCP 客户端侧比如 Cursor、Claude Code 这类支持 MCP 的终端config.toml 用于 Dify 侧或 MCP 服务端的模型通道配置。两份都围绕 TaoToken 统一 Key 来写。先看 settings.json。这是 MCP 客户端注册 Dify 反向暴露出来的 MCP 服务时用的{ mcpServers: { dify-file-chat: { type: http, url: http://127.0.0.1/mcp/server/ACmAf7BOpaoUP8Fs/mcp, headers: { Authorization: Bearer YOUR_TAOTOKEN_API_KEY } }, dify-chart-agent: { type: http, url: http://127.0.0.1/mcp/server/REPLACE_WITH_YOUR_ID/mcp, headers: { Authorization: Bearer YOUR_TAOTOKEN_API_KEY } } } }关键点type填httpurl填 Dify 应用启用 MCP 服务后给出的地址headers里带上 TaoToken 的 Key。如果你的客户端不支持 headers 字段就把 Key 放到环境变量里在配置中用${TAOTOKEN_API_KEY}引用。再看 config.toml。这是 MCP 服务端或 Dify 模型通道的配置骨架[model_provider] name taotoken base_url https://taotoken.net/api api_key YOUR_TAOTOKEN_API_KEY model claude-sonnet-4-20250514 timeout 120 [mcp_server] enabled true transport http host 0.0.0.0 port 8080 [mcp_server.auth] type bearer token YOUR_TAOTOKEN_API_KEYbase_url固定用https://taotoken.net/apiapi_key填控制台创建的 Key。model按你实际要用的模型名填接入文档里有完整模型列表。timeout建议给到 120 秒MCP 工具调用链路比普通对话长超时太短容易断。两份配置改完先别急着启动确认三个值Key 没有多余空格、base_url 没有尾部斜杠、MCP 服务 URL 里的 ID 是真实应用生成的。4. 双向注册MCP 服务端与客户端配置链路双向 MCP 的“双向”要分开配一个方向是 Dify 作为客户端去调外部 MCP 服务另一个方向是 Dify 作为服务端把应用暴露出去。4.1 Dify 调用外部 MCP 服务进入 Dify 工具页新增 MCP 配置。弹窗里填服务名称和 URL。以图表类 MCP 为例名称写mcp-server-chatURL 从 MCP 广场对应服务页面复制。授权完成后能看到详细工具列表确认工具数量对得上。然后在 Agent 应用里工具一栏添加这个 MCP 服务默认全开按需关掉不用的。系统指令参考你是一个智能代理连接到 mcp-server-chat 并访问其工具。根据用户意图灵活创建图表。在工作流里用的话新增 Agent 节点安装插件、选择策略、配置模型、添加工具、写系统指令。模型配置这里就填 TaoToken 的 base_url 和 Key这样 Agent 节点和 MCP 工具走同一条通道。4.2 Dify 应用反向暴露为 MCP 服务端打开一个 Chatflow 应用先发布。在编排页面左上角找到 MCP 服务板块编写服务描述点击启用。绿灯亮起说明运行成功拿到 MCP 服务 URL。如果开始节点有必填参数启用 MCP 服务时还要配置参数描述否则外部客户端调用时不知道传什么值。服务描述要写清楚这个工作流干什么外部 LLM 才知道什么时候该调它。4.3 客户端接入 Dify MCP 服务以支持 MCP 的客户端为例创建 MCP 服务器类型选 HTTPURL 填 Dify 给出的地址保存后绿灯亮起表示创建成功。然后在对话页面选择这个 MCP 服务直接对话就能用上你发布的工作流。Cursor、Trae、VS Code 的配置逻辑一样把 settings.json 里的 mcpServers 段贴到对应配置文件即可。Claude Code 的接入方式参考https://taotoken.net/claude-code?utm_sourcetaotoken_aicg_blog_endutm_contentclaude-codeutm_campaignrewrite5. 连通性验证与成功结果配置完必须验证不然等到用的时候才发现不通排查成本更高。第一步验证 TaoToken Key 可用。用 curl 直接打模型接口curl -X POST https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer YOUR_TAOTOKEN_API_KEY \ -H Content-Type: application/json \ -d { model: claude-sonnet-4-20250514, messages: [{role: user, content: ping}], max_tokens: 10 }返回里有choices字段且内容正常说明 Key 和通道没问题。第二步验证 Dify 调外部 MCP。在 Agent 应用里发一条会触发工具调用的消息比如“生成一个饼图数据是 18-25:32.5, 26-35:41.2”。观察日志里是否有 MCP 工具调用记录返回结果里是否包含图表数据。第三步验证 Dify 反向 MCP 服务。在客户端里选中 Dify 的 MCP 服务发一条该工作流能处理的 query。成功的话会返回工作流执行结果而不是报连接错误。三个验证都过说明双向链路通了。任何一步失败看下一节的排查表。6. 本篇常见错排查配置过程中容易踩的坑集中在这几类对照排查报错现象可能原因处理方式401 UnauthorizedKey 错误或带了多余空格重新复制 Key检查 headers 格式连接超时base_url 写错或网络不通确认用https://taotoken.net/api不加尾部斜杠MCP 服务绿灯不亮URL 里的应用 ID 不对重新从 Dify 应用页复制 MCP 服务 URL工具列表为空授权未完成或工具被全部关闭重新授权检查工具开关客户端调用无响应开始节点必填参数未配置描述在 MCP 服务配置里补参数描述工作流执行报参数缺失客户端传参名与开始节点不一致核对参数名大小写敏感模型调用 404model 名写错查接入文档里的模型列表反向 MCP 调用返回空工作流未发布先发布应用再启用 MCP 服务排查顺序建议从外到内先 curl 验证 Key再验证 Dify 内部模型通道最后验证 MCP 双向链路。这样能快速定位是凭证问题、配置问题还是应用逻辑问题。如果排查中需要重新生成 Key 或查看调用记录回控制台https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite接入细节和参数说明以文档为准https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite生产环境升级前务必备份 docker-compose.yaml 和 volumes 目录非生产环境可以先升 v1.6.0 体验双向 MCP。配置跑通后把 settings.json 和 config.toml 存一份模板下次接新 MCP 服务只改 URL 和名称就行。
1. Dify v1.6.0 双向 MCP 到底解决了什么问题Dify v1.6.0 最核心的变化是支持双向 MCP既能从 Dify 的 Agent 和工作流里调用外部 MCP 服务也能把 Dify 自己的应用反向暴露成标准 MCP 端点给别的客户端用。说白了就是“与己方便与人方便”——你既可以用别人的工具也能把自己的工作流打包成工具给别人调。这个功能适合谁如果你已经在用 Dify 搭 Agent 或 Chatflow但受限于插件生态不够全想接本地文件、数据库、第三方图表服务那双向 MCP 就是最直接的扩展方式。另一个场景是团队内部你把一个知识库问答工作流发布成 MCP 服务其他同事在 Cursor、Trae、VS Code 里直接调用不用重复搭一套。但实际配置时有个绕不开的问题每个 MCP 服务、每个客户端都要单独配 Key 和 API 地址Agent 调外部工具一套凭证工作流反向暴露又一套客户端接入再来一套。管理起来很碎。我试过用 TaoToken 做统一 Key 和 API 通道把模型调用和 MCP 接入收敛到一个入口配置量能明显降下来。下面按“前置准备 → 配置骨架 → 双向注册 → 连通性验证 → 报错排查”的顺序走一遍目标是你复制配置就能跑通。2. TaoToken 前置统一 Key 与 API 通道准备TaoToken 在这里的角色是统一模型调用入口。Dify 里 Agent 节点、工作流里的 LLM 节点、以及 MCP 服务背后如果涉及模型推理都可以走同一个 API 通道不用每个服务单独申请和轮换 Key。先拿到 API Key。打开控制台页面https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite在 API Keys 页面创建一个新 Key复制保存。这个 Key 后面会填到 Dify 的模型供应商配置里也会用在 MCP 服务端的环境变量中。API 基础地址统一用https://taotoken.net/api注意这个地址不加 UTM 参数直接作为 base_url 填。模型对话调试可以在模型对话页先验证 Key 是否可用https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite如果你后续要长期跑编码类 Agent 或高频工作流可以看下 Coding Plan 的额度方案https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite接入文档在这里配置格式和参数说明以文档为准https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite前置准备就三样一个 API Key、base_url 用https://taotoken.net/api、以及确认 Dify 版本 ≥ v1.6.0。版本不够的话先升级双向 MCP 的入口在旧版里没有。3. 可复制配置settings.json 与 config.toml 骨架这一节给两份可直接改的配置骨架。settings.json 用于 MCP 客户端侧比如 Cursor、Claude Code 这类支持 MCP 的终端config.toml 用于 Dify 侧或 MCP 服务端的模型通道配置。两份都围绕 TaoToken 统一 Key 来写。先看 settings.json。这是 MCP 客户端注册 Dify 反向暴露出来的 MCP 服务时用的{ mcpServers: { dify-file-chat: { type: http, url: http://127.0.0.1/mcp/server/ACmAf7BOpaoUP8Fs/mcp, headers: { Authorization: Bearer YOUR_TAOTOKEN_API_KEY } }, dify-chart-agent: { type: http, url: http://127.0.0.1/mcp/server/REPLACE_WITH_YOUR_ID/mcp, headers: { Authorization: Bearer YOUR_TAOTOKEN_API_KEY } } } }关键点type填httpurl填 Dify 应用启用 MCP 服务后给出的地址headers里带上 TaoToken 的 Key。如果你的客户端不支持 headers 字段就把 Key 放到环境变量里在配置中用${TAOTOKEN_API_KEY}引用。再看 config.toml。这是 MCP 服务端或 Dify 模型通道的配置骨架[model_provider] name taotoken base_url https://taotoken.net/api api_key YOUR_TAOTOKEN_API_KEY model claude-sonnet-4-20250514 timeout 120 [mcp_server] enabled true transport http host 0.0.0.0 port 8080 [mcp_server.auth] type bearer token YOUR_TAOTOKEN_API_KEYbase_url固定用https://taotoken.net/apiapi_key填控制台创建的 Key。model按你实际要用的模型名填接入文档里有完整模型列表。timeout建议给到 120 秒MCP 工具调用链路比普通对话长超时太短容易断。两份配置改完先别急着启动确认三个值Key 没有多余空格、base_url 没有尾部斜杠、MCP 服务 URL 里的 ID 是真实应用生成的。4. 双向注册MCP 服务端与客户端配置链路双向 MCP 的“双向”要分开配一个方向是 Dify 作为客户端去调外部 MCP 服务另一个方向是 Dify 作为服务端把应用暴露出去。4.1 Dify 调用外部 MCP 服务进入 Dify 工具页新增 MCP 配置。弹窗里填服务名称和 URL。以图表类 MCP 为例名称写mcp-server-chatURL 从 MCP 广场对应服务页面复制。授权完成后能看到详细工具列表确认工具数量对得上。然后在 Agent 应用里工具一栏添加这个 MCP 服务默认全开按需关掉不用的。系统指令参考你是一个智能代理连接到 mcp-server-chat 并访问其工具。根据用户意图灵活创建图表。在工作流里用的话新增 Agent 节点安装插件、选择策略、配置模型、添加工具、写系统指令。模型配置这里就填 TaoToken 的 base_url 和 Key这样 Agent 节点和 MCP 工具走同一条通道。4.2 Dify 应用反向暴露为 MCP 服务端打开一个 Chatflow 应用先发布。在编排页面左上角找到 MCP 服务板块编写服务描述点击启用。绿灯亮起说明运行成功拿到 MCP 服务 URL。如果开始节点有必填参数启用 MCP 服务时还要配置参数描述否则外部客户端调用时不知道传什么值。服务描述要写清楚这个工作流干什么外部 LLM 才知道什么时候该调它。4.3 客户端接入 Dify MCP 服务以支持 MCP 的客户端为例创建 MCP 服务器类型选 HTTPURL 填 Dify 给出的地址保存后绿灯亮起表示创建成功。然后在对话页面选择这个 MCP 服务直接对话就能用上你发布的工作流。Cursor、Trae、VS Code 的配置逻辑一样把 settings.json 里的 mcpServers 段贴到对应配置文件即可。Claude Code 的接入方式参考https://taotoken.net/claude-code?utm_sourcetaotoken_aicg_blog_endutm_contentclaude-codeutm_campaignrewrite5. 连通性验证与成功结果配置完必须验证不然等到用的时候才发现不通排查成本更高。第一步验证 TaoToken Key 可用。用 curl 直接打模型接口curl -X POST https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer YOUR_TAOTOKEN_API_KEY \ -H Content-Type: application/json \ -d { model: claude-sonnet-4-20250514, messages: [{role: user, content: ping}], max_tokens: 10 }返回里有choices字段且内容正常说明 Key 和通道没问题。第二步验证 Dify 调外部 MCP。在 Agent 应用里发一条会触发工具调用的消息比如“生成一个饼图数据是 18-25:32.5, 26-35:41.2”。观察日志里是否有 MCP 工具调用记录返回结果里是否包含图表数据。第三步验证 Dify 反向 MCP 服务。在客户端里选中 Dify 的 MCP 服务发一条该工作流能处理的 query。成功的话会返回工作流执行结果而不是报连接错误。三个验证都过说明双向链路通了。任何一步失败看下一节的排查表。6. 本篇常见错排查配置过程中容易踩的坑集中在这几类对照排查报错现象可能原因处理方式401 UnauthorizedKey 错误或带了多余空格重新复制 Key检查 headers 格式连接超时base_url 写错或网络不通确认用https://taotoken.net/api不加尾部斜杠MCP 服务绿灯不亮URL 里的应用 ID 不对重新从 Dify 应用页复制 MCP 服务 URL工具列表为空授权未完成或工具被全部关闭重新授权检查工具开关客户端调用无响应开始节点必填参数未配置描述在 MCP 服务配置里补参数描述工作流执行报参数缺失客户端传参名与开始节点不一致核对参数名大小写敏感模型调用 404model 名写错查接入文档里的模型列表反向 MCP 调用返回空工作流未发布先发布应用再启用 MCP 服务排查顺序建议从外到内先 curl 验证 Key再验证 Dify 内部模型通道最后验证 MCP 双向链路。这样能快速定位是凭证问题、配置问题还是应用逻辑问题。如果排查中需要重新生成 Key 或查看调用记录回控制台https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite接入细节和参数说明以文档为准https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite生产环境升级前务必备份 docker-compose.yaml 和 volumes 目录非生产环境可以先升 v1.6.0 体验双向 MCP。配置跑通后把 settings.json 和 config.toml 存一份模板下次接新 MCP 服务只改 URL 和名称就行。
