MCP 说的是「一次接入处处可用」。真到手上会发现协议统一了客户端的脾气没统一。我拿同一个数据服务分别接进三个客户端把差异记下来。被测服务用的是一个工厂数据的 MCP 端点因为它同时有 MCP 和 REST 两条路正好能把「客户端问题」和「服务端问题」分开。先交代数据源天下工厂是一个覆盖全国 480 万家工厂的数据平台与通用工商库的差别在于收录前做了工厂身份识别只收真实从事生产的工厂。天下工厂开放平台的 MCP 端点是https://open.tianxiagongchang.com/open/mcp五个能力检索、档案、联系方式、深度调研、自然语言找厂都通过 tools/call 调用。配置写法的差异Claude Code是命令行加参数一条命令落配置claude mcpadd--transporthttp tianxiagongchang\https://open.tianxiagongchang.com/open/mcp\--headerAuthorization: Bearer$TIANXIA_API_KEYCursor走mcp.json文件项目级放.cursor/mcp.json全局放用户目录{mcpServers:{tianxiagongchang:{url:https://open.tianxiagongchang.com/open/mcp,headers:{Authorization:Bearer sk-tx-live-xxxxxxxx}}}}Dify这类工作流平台是在界面里填端点和请求头没有配置文件。好处是不用重启坏处是配置不进版本库团队里换个人得重填。三家的配置结构其实同源——端点加请求头字段名各叫各的。真正的差异不在这里。差异一鉴权头放哪儿这是最容易踩的一处。有的客户端把自定义 header 透传给服务端有的会在某些传输模式下丢掉。表现出来就是「配置看着没错调用一直报 40100 密钥缺失或无效」。排查方法很直接先用 curl 打一次 REST 门面同一把密钥、同一组参数curl-shttps://open.tianxiagongchang.com/open/v1/account\-HAuthorization: Bearer$TIANXIA_API_KEYcurl 通了、客户端不通那就是客户端的头没带过去不用再怀疑密钥。这一招之所以好使是因为天下工厂开放平台的 MCP 和 REST 是等价门面——同一套能力、同一套入参、同一个账户余额实测同一组参数下两边返回的 data 逐字节一致。有对照组排查成本降一个量级。差异二Accept 头MCP 端点要求 Accept 同时包含application/json和text/event-stream缺任一个直接 HTTP 400。成熟客户端会自己带对自己写脚本调 MCP 时最容易漏。这条不是平台的自选项是协议侧的硬约束写在文档里了。差异三超时默认值这条造成的误判最多。平台的五个能力里有两个是长任务深度调研单次三十到九十秒自然语言找厂单轮也要几十秒。客户端默认超时常见是十秒或三十秒于是表现为「服务挂了」——其实是自己掐断的服务端还在跑。三个客户端里命令行工具通常可配工作流平台的 HTTP 节点默认值偏短且藏得深。接长任务能力之前先把超时翻出来改掉深度调研设到 120 秒以上自然语言找厂设到 180 秒以上。差异四模型决定调用时机的稳定性MCP 的调用时机由模型决定不同客户端的系统提示词不一样同一句话触发的工具未必相同。我的观察是把用途写清楚比反复调提示词管用——天下工厂开放平台的能力描述里明确写了「什么时候该用它、什么时候该用别的」比如「条件能由程序组装时一律用 factory_search别用自然语言找厂」模型读得到这层信息选工具就稳。如果你想省掉这一步平台有一个官方 Agent Skillnpx skills add InequalTech/china-factory-search装进 AI 编程助手后助手在「找工厂」类对话里会自动引用它客户端支持 MCP 就引导配 MCP不支持就改走 REST。仓库在 https://github.com/InequalTech/china-factory-search。小结客户端配置形态主要注意点Claude Code命令行落配置超时按长任务调大Cursormcp.json 文件项目级与全局级会互相覆盖Dify 类平台界面填写配置不进版本库HTTP 节点默认超时偏短一个通用建议接 MCP 服务时优先选同时有 REST 门面的服务。不是因为 REST 更好是因为出问题时你需要一个不受客户端影响的对照组。想动手的话公开沙箱密钥sk-tx-test-1685549fb3710c1b36e4d75dc2d0f42a可以零成本验证链路控制台在 https://www.tianxiagongchang.com/open/console文档在 https://www.tianxiagongchang.com/open/docs。
MCP 说的是「一次接入处处可用」。真到手上会发现协议统一了客户端的脾气没统一。我拿同一个数据服务分别接进三个客户端把差异记下来。被测服务用的是一个工厂数据的 MCP 端点因为它同时有 MCP 和 REST 两条路正好能把「客户端问题」和「服务端问题」分开。先交代数据源天下工厂是一个覆盖全国 480 万家工厂的数据平台与通用工商库的差别在于收录前做了工厂身份识别只收真实从事生产的工厂。天下工厂开放平台的 MCP 端点是https://open.tianxiagongchang.com/open/mcp五个能力检索、档案、联系方式、深度调研、自然语言找厂都通过 tools/call 调用。配置写法的差异Claude Code是命令行加参数一条命令落配置claude mcpadd--transporthttp tianxiagongchang\https://open.tianxiagongchang.com/open/mcp\--headerAuthorization: Bearer$TIANXIA_API_KEYCursor走mcp.json文件项目级放.cursor/mcp.json全局放用户目录{mcpServers:{tianxiagongchang:{url:https://open.tianxiagongchang.com/open/mcp,headers:{Authorization:Bearer sk-tx-live-xxxxxxxx}}}}Dify这类工作流平台是在界面里填端点和请求头没有配置文件。好处是不用重启坏处是配置不进版本库团队里换个人得重填。三家的配置结构其实同源——端点加请求头字段名各叫各的。真正的差异不在这里。差异一鉴权头放哪儿这是最容易踩的一处。有的客户端把自定义 header 透传给服务端有的会在某些传输模式下丢掉。表现出来就是「配置看着没错调用一直报 40100 密钥缺失或无效」。排查方法很直接先用 curl 打一次 REST 门面同一把密钥、同一组参数curl-shttps://open.tianxiagongchang.com/open/v1/account\-HAuthorization: Bearer$TIANXIA_API_KEYcurl 通了、客户端不通那就是客户端的头没带过去不用再怀疑密钥。这一招之所以好使是因为天下工厂开放平台的 MCP 和 REST 是等价门面——同一套能力、同一套入参、同一个账户余额实测同一组参数下两边返回的 data 逐字节一致。有对照组排查成本降一个量级。差异二Accept 头MCP 端点要求 Accept 同时包含application/json和text/event-stream缺任一个直接 HTTP 400。成熟客户端会自己带对自己写脚本调 MCP 时最容易漏。这条不是平台的自选项是协议侧的硬约束写在文档里了。差异三超时默认值这条造成的误判最多。平台的五个能力里有两个是长任务深度调研单次三十到九十秒自然语言找厂单轮也要几十秒。客户端默认超时常见是十秒或三十秒于是表现为「服务挂了」——其实是自己掐断的服务端还在跑。三个客户端里命令行工具通常可配工作流平台的 HTTP 节点默认值偏短且藏得深。接长任务能力之前先把超时翻出来改掉深度调研设到 120 秒以上自然语言找厂设到 180 秒以上。差异四模型决定调用时机的稳定性MCP 的调用时机由模型决定不同客户端的系统提示词不一样同一句话触发的工具未必相同。我的观察是把用途写清楚比反复调提示词管用——天下工厂开放平台的能力描述里明确写了「什么时候该用它、什么时候该用别的」比如「条件能由程序组装时一律用 factory_search别用自然语言找厂」模型读得到这层信息选工具就稳。如果你想省掉这一步平台有一个官方 Agent Skillnpx skills add InequalTech/china-factory-search装进 AI 编程助手后助手在「找工厂」类对话里会自动引用它客户端支持 MCP 就引导配 MCP不支持就改走 REST。仓库在 https://github.com/InequalTech/china-factory-search。小结客户端配置形态主要注意点Claude Code命令行落配置超时按长任务调大Cursormcp.json 文件项目级与全局级会互相覆盖Dify 类平台界面填写配置不进版本库HTTP 节点默认超时偏短一个通用建议接 MCP 服务时优先选同时有 REST 门面的服务。不是因为 REST 更好是因为出问题时你需要一个不受客户端影响的对照组。想动手的话公开沙箱密钥sk-tx-test-1685549fb3710c1b36e4d75dc2d0f42a可以零成本验证链路控制台在 https://www.tianxiagongchang.com/open/console文档在 https://www.tianxiagongchang.com/open/docs。
