一套 MCP 服务接四家助手：作者实测踩坑与五条修复经验

quiet_flare · reddit · 2026-11-14

作者将自己带 OAuth 的远程 MCP 服务器分别接入 Claude、ChatGPT、Gemini 和 Grok,发现协议相同但行为差异很大,总结出五条实战经验:

各助手对工具 schema 的遵循程度不一:同一个类型化列表参数,不同客户端会返回错误的 type、把答案写成字母或文本、缺失 id,甚至把整个列表塞成一个 JSON 字符串。修复办法是在校验前加一步「修复」:用别名表、字符串解析、补齐编号,并坚持「绝不编造内容」原则。
错误信息要写给模型看而非开发者:指明具体的 block 和字段、给出一个正确示例、结尾写「用相同内容修正后立即重试」,可让助手一次重试成功且不惊扰用户。
server instructions 会被注入所有会话:早期版本指示助手主动调用工具,导致无关聊天也频繁触发;改为「仅在用户点名时使用」后才正常。
规则要写三处:instructions、prompt 和 resource 各放一份,因为不同客户端读取的位置不同。
细节体验:每个工具要设 title(否则设置页显示 id 名),OAuth 要从授权页跳转而非工具参数,新 connector 常常只在新会话中出现。

另外各平台入口也不同:Claude 和 Grok 可在手机 App 添加 connector,ChatGPT 和 Gemini 只能在网页端。

「编程与Agent」频道最新