连接 Wherobots MCP
使用 --url 添加远程服务，再通过 OAuth 登录。也可通过环境变量提供 X-API-Key 请求头。
Wherobots 文档提供了 Codex CLI 和桌面端的配置说明。远程入口是 https://api.cloud.wherobots.com/mcp/，带 /mcp/ 尾斜杠。官方示例表名是 wherobots-mcp-server。需要 Professional、Innovation 或 Enterprise 组织；Admin 和 User 都能用。OAuth 不能在浏览器里注册新账号，需先创建 cloud.wherobots.com 账号。主机在 us-west-2。
官方 Codex 页还写「远程 HTTP 只能手改 TOML，codex mcp add 只支持本地 stdio」。远程服务可以使用 --url：
codex mcp add wherobots-mcp-server --url https://api.cloud.wherobots.com/mcp/
codex mcp login wherobots-mcp-server
[mcp_servers.wherobots-mcp-server]
url = "https://api.cloud.wherobots.com/mcp/"
enabled = true
mcp add 写进用户层 ~/.codex/config.toml。若浏览器未打开，运行 codex mcp login wherobots-mcp-server。登录后选组织和 Allow access。传输协议为 Streamable HTTP。
也可使用 API key 认证，通过环境变量提供 X-API-Key 请求头，避免在配置文件中直接保存密钥。codex mcp add 写不了自定义头，添加服务后设置 env_http_headers。左边是头名，右边写变量名 WHEROBOTS_API_KEY，在启动 Codex 的环境中设置变量值：
[mcp_servers.wherobots-mcp-server]
url = "https://api.cloud.wherobots.com/mcp/"
enabled = true
[mcp_servers.wherobots-mcp-server.env_http_headers]
X-API-Key = "WHEROBOTS_API_KEY"
从已经 export WHEROBOTS_API_KEY 的终端启动。从 Dock 或开始菜单启动的桌面应用通常不会加载终端的环境变量。Codex 不读 .env。变量缺失时该请求头会被静默丢掉。使用请求头认证时，无需运行 mcp login。
技能需要单独安装。仓库名是 wherobots/agent-skills。官方 Codex 页是 npx skills add -g wherobots/agent-skills。-g 装到用户目录。官方安装示例未指定 --agent codex。仓库包含三项技能： wherobots-usage、wherobots-explore、wherobots-develop。技能不会写出 mcp_servers.wherobots-mcp-server。
该服务支持浏览目录、生成 Spatial SQL、执行查询。默认 Tiny runtime，查询约 15 分钟超时，SQL Session 空闲约 5 分钟结束。在 Wherobots 上执行查询时按 Spatial Unit 计费。VS Code 命令面板里的 wherobotsjobsubmit.mcpServerQueryTimeout 仅适用于该扩展。
可以先询问「List the catalogs in my Wherobots Data Hub」。若工具未出现，请重新打开会话。
网页 Cloud 不读取 ~/.codex/config.toml。修改后重新打开会话。用 codex mcp get wherobots-mcp-server 看传输是 streamable_http。OAuth 路径的 /mcp 应显示 Auth: OAuth。