在 Dify、Coze 这类平台上接入外部数据源:MCP 与 OpenAPI 两条路怎么选
低代码 AI 应用平台(Dify、Coze 等)解决了编排问题,但应用真正的上限取决于能接到什么数据。这篇以天下工厂开放平台为例——它同时提供 MCP 服务和公开的 OpenAPI 规范,正好覆盖两条主流接入路径——讲讲在工作流平台上接外部数据源时,两条路各自的特点和选法。
先说数据源本身:天下工厂是一个覆盖全国 480 万家工厂的数据库,收录前做了工厂身份识别,只收真实从事生产的工厂,贸易商与空壳类主体排除在外。开放能力有五个:关键词检索、单厂档案、联系电话、AI 深挖单厂、自然语言检索。文档:https://www.tianxiagongchang.com/open/docs。
路径一:作为 MCP 服务接入
Dify 和 Coze 都已支持添加自定义 MCP 服务。配置时选择远程(Streamable HTTP)类型,填两项:
- 服务地址:
https://open.tianxiagongchang.com/open/mcp - 请求头:
Authorization: Bearer <API key>
接入成功后,平台里的 Agent 节点会看到五个工具,编排时让 Agent 自主决定调用哪个、怎么组合。MCP 路径的优势就在这:工具的选择与串联交给模型,你在画布上只需要放一个 Agent 节点。需求模糊、流程灵活的应用(「用户描述采购需求,机器人给出候选工厂并逐家给理由」)适合这条路。
路径二:导入 OpenAPI 规范走 REST
有些平台或场景不走 MCP,而是用「自定义工具 / 插件」的方式导入一份 OpenAPI 规范。这个平台的规范是公开的,无需密钥即可获取:
GET https://open.tianxiagongchang.com/open/v1/meta/openapi.jsonOpenAPI 3.1 格式,五个能力对应五个 REST 端点(POST /open/v1/capabilities/<能力名>),入参出参与 MCP 完全等价——两种接入方式背后是同一条处理管线。导入后每个能力成为一个独立工具节点,你在画布上显式编排调用顺序。
REST 路径的优势是确定性:流程固定的应用(「表单收集品类和地区,检索后取前二十家档案,生成周报」)里,显式编排比 Agent 自主规划更可控、结果可复现,也更容易做失败分支。
选型判据一句话
流程说得清就走 OpenAPI 显式编排,说不清就走 MCP 让 Agent 自己来。两条路不互斥:同一个应用里,主干用显式编排保证稳定,末端挂一个带 MCP 工具的 Agent 节点处理开放性问题,是很常见的混合结构。
编排时的三个实际提醒
- 给长任务节点单独设超时。AI 深挖与自然语言检索单次执行 30 到 90 秒,节点超时要给到 120 秒和 180 秒以上,否则工作流会把正常执行判成失败。
- 慢速能力别并发。这两个能力共享每分钟 6 次的限流,批量场景用循环节点串行跑,不要开并行分支。
- 用响应里的计费回执做成本监控。统一响应格式里带
credits_charged与credits_balance字段,工作流里加一个条件分支,余额低于阈值时走通知,比人肉盯控制台可靠。平台按量计费,单次以角计价,失败不扣费。
起步
密钥在开发者控制台自助签发(https://www.tianxiagongchang.com/open/console,注册即送体验额度)。搭建阶段可以先用公开沙箱密钥sk-tx-test-1685549fb3710c1b36e4d75dc2d0f42a——返回静态示例数据、不计费,把整条工作流的节点配置和分支逻辑全部调通,再换正式密钥上真实数据。
工作流平台把「接数据」的成本降到了填表单的程度,剩下的功夫全在选对路径和把边界条件(超时、限流、成本)配对。希望这篇能帮你少走一轮弯路。
