无头环境连 MCP 要用 API Key 而非 OAuth

更新于 2026-07-15

**要不要用 OAuth 取决于运行形态，不取决于客户端名字：有 GUI 的桌面版能弹窗就走 OAuth，无头 / CI / 服务器场景没有浏览器，只能预先换成 API Key（Bearer Token）。**

- OAuth 首次连接需要人盯着屏幕点授权，无头环境会卡住或失败。

  • 替代方案是提前生成 Personal API Key，放进 Authorization: Bearer ...，服务器直接放行，不需要任何弹窗。
  • 反过来的误判也要避免：桌面版客户端跑在本地 Mac 上、有浏览器，照样可以 OAuth，不能因为它跑在终端里就归到「无头」。
  • 统一用 API Key 的好处是多个客户端配置一致、能跑在无人值守环境；代价是密钥要自己保管与轮换。

相关