Polar MCP 用 mcp.polar.sh/mcp/polar-mcp,再完成 OAuth

官方 Codex:mcp add polar --url https://mcp.polar.sh/mcp/polar-mcp,随后完成 OAuth。URL 是 /mcp/polar-mcp,不是光 /mcp。沙箱另开 polar-sandbox。不要抄 Claude 的 --transport http。

Polar(polar.sh)给 Codex 有专节。官方 CLI 主路径是远程 Streamable HTTP + OAuth,不要 API key,也不要 bearer_token_env_var

codex mcp add polar --url https://mcp.polar.sh/mcp/polar-mcp

官方文档把表名写成带引号的 "polar",和 polar 一样。URL 是 https://mcp.polar.sh/mcp/polar-mcp不是https://mcp.polar.sh/mcp。加完后按提示在浏览器完成 OAuth。只写进了表、浏览器没弹时再跑:

codex mcp login polar
[mcp_servers.polar]
url = "https://mcp.polar.sh/mcp/polar-mcp"
enabled = true

不要抄 Claude 的 claude mcp add --transport http polar https://mcp.polar.sh/mcp/polar-mcp。不要抄 Cursor 的 .cursor/mcp.json。不要抄 ChatGPT / Claude Desktop 的 Connectors。不要抄 npx mcp-remote。不要发明 codex plugin add polar@…。不要把 Polar API key 写进 URL、http_headersargsenv 表。

沙箱是另一张表,官方名字就是 polar-sandbox,终点是 https://mcp.polar.sh/mcp/polar-sandbox

codex mcp add polar-sandbox --url https://mcp.polar.sh/mcp/polar-sandbox

浏览器没弹时再 codex mcp login polar-sandbox。两张表可以同时配,不要合成一台。不要抄旧镜像文档里的 [features] rmcp_client = truetype = "http",或把表名写成 polar_sandbox

Polar 只暴露三把元工具:search_toolsdescribe_toolsexecute_tool。会话里不会一次列出 100 个业务工具。先只读:问 Search Polar tools for listing products, then list my products. execute_tool 能建商品、退款、删客户、立刻撤销订阅,保持工具批准。不要一上来 --yolo。不要 required = true。网页 Cloud 不读 ~/.codex/config.toml

改完彻底新开会话。用 codex mcp get polar 看传输是 streamable_http。会话里 /mcp 应显示 Auth: OAuth。旧票卡住时先 codex mcp logout polar,再重新 login。

不要做这些:

  • 不要发明 codex plugin add polar@openai-curated
  • 不要抄 Claude 的 --transport http 或 Cursor JSON。
  • 不要把生产 polar-mcp 和沙箱 polar-sandbox 配成一张表。
  • 不要给它 required = true 挂全局。

来源