---
title: "连接 Wherobots MCP"
summary: "使用 --url 添加远程服务，再通过 OAuth 登录。也可通过环境变量提供 X-API-Key 请求头。"
category: mcp
level: starter
surfaces: [cli, app, ide]
tags: ["MCP", "Wherobots", "OAuth", "HTTP"]
canonical: /tips/wherobots-mcp-http/
---

# 连接 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`：

```bash
codex mcp add wherobots-mcp-server --url https://api.cloud.wherobots.com/mcp/
codex mcp login wherobots-mcp-server
```

```toml
[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 的环境中设置变量值：

```toml
[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。

## 来源

- [Wherobots · Set Up Wherobots in Codex](https://docs.wherobots.com/develop/agentic-tools/codex)
- [wherobots/agent-skills](https://github.com/wherobots/agent-skills)