资讯动态

Dify+DeepSeek+MCP:手把手教你将工作流秒变智能工具 ——从“本地工作流”到“跨平台复用”的效率革命

发布时间:2026/9/27 18:36:22 来源:尧图企业网站定制
1. 为什么你的 Dify 工作流还困在本地你花了两天调好的 Dify 工作流智能客服也好、会议纪要生成也好在 Dify 的调试面板里跑得挺顺。但一旦要把它接到 Cline、Cursor 这类编程 IDE或者公司内部的办公系统里麻烦就来了对方不认 Dify 的 API 格式你得写适配层参数结构对不上你得手动转换换个平台适配层还得重写一遍。这个问题的本质是Dify 工作流是一个「应用」而其他平台需要的是一个「工具」。应用有自己完整的输入输出和界面工具则要求标准化的调用协议。MCPModel Context Protocol就是干这个的——它把 Dify 工作流包装成一个符合统一协议的工具任何支持 MCP 的客户端都能直接调用不用关心底层是 Dify 还是别的什么。我试过把一套「订单异常处理」工作流从 Dify 发布成 MCP 工具然后在三个不同平台里调用整个过程没有改一行工作流本身的逻辑。这篇就按这个路径把 config.toml 和 settings.json 的骨架、TaoToken 统一 Key 的配置、跨平台调用的验证动作一步步拆开讲。适合已经有一两个跑通的 Dify 工作流、想把它变成可复用智能工具的开发者。2. 前置准备TaoToken 统一 Key 与 Dify 侧配置在动手改配置之前先把两件事定下来模型调用的通道和 Dify 工作流的发布状态。2.1 用 TaoToken 统一模型调用入口Dify 工作流里如果调了 DeepSeek 模型默认走的是 Dify 自己配的模型供应商。但当你把工作流发布成 MCP 工具、被多个平台调用时模型调用的稳定性和 Key 管理就成了问题——每个平台各配一套 Key轮换和限额都难管。TaoToken 的做法是提供一个统一的 API 通道Dify 侧只需要配一次后面所有通过 MCP 调进来的请求都走这个通道。具体操作登录 TaoToken 控制台在 API Keys 页面创建一个 Key然后拿到 API 地址https://taotoken.net/api。这个地址不加 UTM 参数直接用于程序调用。在 Dify 的模型供应商设置里选择「OpenAI-API-compatible」类型Base URL 填https://taotoken.net/apiAPI Key 填你刚创建的那串。模型名称按 TaoToken 文档里支持的写比如deepseek-chat。配完之后在 Dify 里跑一次工作流确认模型节点能正常返回再往下走。注意TaoToken 的官网入口是https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content控制台和 API Keys 页面都从这里进。API 地址不要带 UTM 参数否则某些客户端会解析异常。2.2 确认 Dify 工作流已发布为工具打开 Dify 控制台进入你要发布的工作流点右上角「发布」→「发布为工具」。工具名称用英文小写加下划线比如generate_email或handle_order_issue。描述写清楚这个工具干什么因为 MCP 客户端会把这个描述展示给模型看模型靠它决定什么时候调用。输入参数的 schema 要提前定好。比如一个邮件生成工具输入是{subject: string, recipients: array}输出是{draft: string}。这个 schema 后面要原样填到 MCP 配置里所以先在 Dify 的工具详情页复制出来备用。发布完成后Dify 会给你一个工具调用地址形如http://your-dify-ip:port/api/tools/generate_email。记下这个地址和对应的 API Token下一步配置 MCP 插件时要用。3. 可复制配置MCP 插件与跨平台 settings.json这一步是整个流程的核心。MCP 插件负责把 Dify 的工具暴露成标准 MCP 服务跨平台客户端则通过 settings.json 或 config.toml 来连接这个服务。3.1 Dify 侧安装 MCP SSE 插件在 Dify 的插件市场搜索「MCP SSE」或「MCP-server」安装支持 SSEServer-Sent Events的那个。安装完成后进入插件配置页面填入 MCP 服务器信息。下面是一个可复制的配置骨架{ server_name: { url: http://your-dify-ip:port/sse, headers: { Authorization: Bearer your-dify-tool-token }, timeout: 60 } }把your-dify-ip:port换成你 Dify 实例的实际地址your-dify-tool-token换成发布工具时拿到的 Token。timeout 设 60 秒是因为有些工作流里带了模型调用和外部 API 请求太短容易断。然后在插件里绑定你刚发布的工具输入参数的 schema 按 Dify 工具详情页里的原样填{ name: generate_email, description: 根据主题和收件人生成邮件草稿, inputSchema: { type: object, properties: { subject: {type: string}, recipients: {type: array, items: {type: string}} }, required: [subject, recipients] } }保存后插件会生成一个 MCP 服务端点形如http://your-dify-ip:port/mcp/sse。这个地址就是跨平台调用的入口。3.2 跨平台客户端配置config.toml 与 settings.json不同客户端的配置文件格式不一样。Cline 这类 VS Code 插件用 settings.jsonClaude Code 用 config.toml。下面分别给骨架。Cline 的 settings.json 里加一段 MCP 服务器配置{ mcpServers: { dify-tools: { url: http://your-dify-ip:port/mcp/sse, headers: { Authorization: Bearer your-dify-tool-token }, disabled: false, autoApprove: [generate_email] } } }autoApprove里列的工具名调用时不会弹确认框适合已经测试稳定的工具。刚开始建议先不填手动确认几次没问题再加。Claude Code 的 config.toml 写法[mcp_servers.dify-tools] url http://your-dify-ip:port/mcp/sse headers { Authorization Bearer your-dify-tool-token }如果你在 Claude Code 里同时配了 TaoToken 的模型通道config.toml 里还可以加一段模型配置让 Claude Code 走 TaoToken 调 DeepSeek[model_providers.taotoken] base_url https://taotoken.net/api api_key your-taotoken-key model deepseek-chat这样 Claude Code 既用 TaoToken 跑模型又通过 MCP 调 Dify 工作流两条链路互不干扰。4. 验证请求从 IDE 到企业系统的调用实测配置写完得实际跑一次才算数。分两个场景验证IDE 里的自然语言调用和企业系统里的 API 调用。4.1 IDE 内自然语言调用在 Cline 或 Claude Code 里新建一个对话直接说「请用 generate_email 工具生成一封主题为‘会议提醒’的邮件收件人是张三和李四。」如果配置正确客户端会识别出generate_email这个工具弹出参数确认如果没开 autoApprove确认后请求发到 Dify 的 MCP 端点Dify 执行工作流返回邮件草稿。整个过程你在 IDE 里只看到最终结果中间的模型调用、参数转换都由 MCP 协议处理掉了。实测下来从发出指令到拿到草稿大概 3 到 5 秒取决于工作流里模型节点的响应速度。如果超过 10 秒没返回先检查 Dify 那边工作流是否卡在某个节点。4.2 企业系统 API 调用对于没有 MCP 客户端的系统可以直接用 HTTP 请求调 MCP 服务端点。下面是一个 Python 示例import requests url http://your-dify-ip:port/mcp/call headers { Authorization: Bearer your-dify-tool-token, Content-Type: application/json } data { tool_name: generate_email, params: { subject: 会议提醒, recipients: [zhangsanexample.com, lisiexample.com] } } response requests.post(url, jsondata, headersheaders, timeout60) print(response.json())返回的 JSON 里应该包含draft字段内容是生成的邮件草稿。如果返回NoneType错误多半是工作流输出格式和 schema 对不上去 Dify 工作流末尾加一个格式校验节点确保输出是标准 JSON。4.3 回滚验证发布成 MCP 工具后如果发现某个平台调用异常想回滚到「只在 Dify 本地用」的状态操作很简单在 Dify 控制台把工具取消发布MCP 插件里的绑定会失效跨平台调用自然断开。Dify 工作流本身不受影响本地调试照常。建议在发布工具前先复制一份工作流作为备份。这样即使发布后的版本有问题也能快速切回备份版本重新调。5. 本篇常见错排查配置过程中有几个坑比较集中单独列出来。MCP 连接超时先确认 Dify 实例的防火墙是否放行了 MCP 插件用的端口。如果是内网部署跨平台客户端和 Dify 要在同一网络段或者通过内网穿透暴露端口。timeout 参数建议不低于 60 秒。工具调用返回参数不匹配Dify 工作流的输出结构必须和 MCP 配置里的 outputSchema 一致。比如 schema 里写draft: string工作流输出就不能是对象或数组。在 Dify 工作流末尾加一个「代码执行」节点用 Python 把输出强制转成目标格式。TaoToken Key 在 Dify 里报 401检查 Base URL 是否填了https://taotoken.net/api注意末尾不要多斜杠。API Key 复制时不要带空格。如果 Dify 版本较老模型供应商类型选「OpenAI」而不是「OpenAI-API-compatible」试试。跨平台调用时模型不响应如果 MCP 工具内部调了 DeepSeek但返回空结果去 TaoToken 控制台看调用日志确认请求是否到达。有时候是 Dify 工作流里的模型节点没配好和 MCP 无关。autoApprove 导致误调用autoApprove 列表里的工具会跳过确认直接执行。如果工具涉及写操作比如发邮件、改数据库建议不要开 autoApprove或者只在测试环境开。6. 把工作流变成可复用资产的下一步走到这里你的 Dify 工作流已经不再是一个只能在本地面板里跑的应用了。通过 MCP 协议它变成了一个标准工具Cline 能调、Claude Code 能调、企业系统也能通过 HTTP 调。模型通道用 TaoToken 统一管Key 不用到处散。接下来可以做的把常用的几个工作流都发布成 MCP 工具在 TaoToken 控制台里给它们分配不同的 API Key按工具维度做限额和监控。如果团队里有人用 Coding Plan 做长期编码可以把 MCP 工具配置直接写进项目的 settings.json新成员拉下代码就能用。接入文档和 API Keys 管理都在 TaoToken 控制台里模型对话入口适合快速验证 DeepSeek 的返回是否符合预期。先把一个工作流跑通再批量复制比一上来铺开要稳。

读完文章,也想定制专属网站?

尧图设计师 24 小时内与您沟通定制方案

免费获取报价 →
↑