ClickHouse Cloud MCP 用 mcp.clickhouse.cloud/mcp,不要抄 Claude 的 --transport http
先在 Cloud 控制台给服务打开 MCP。CLI:codex mcp add clickhouse-cloud --url https://mcp.clickhouse.cloud/mcp,再 OAuth。公共目录也可 /plugins 搜 ClickHouse。不要抄 Claude 的 --transport http,也不要和 clickstack 端点搞混。
ClickHouse Cloud 远程 MCP 要先在控制台打开:服务 → Connect → Connect with MCP,打开开关。地址是 https://mcp.clickhouse.cloud/mcp,有 /mcp 后缀。鉴权是 OAuth,不要造 API key。
官方 Codex 节就是:
codex mcp add clickhouse-cloud --url https://mcp.clickhouse.cloud/mcp
codex mcp get clickhouse-cloud
[mcp_servers.clickhouse-cloud]
url = "https://mcp.clickhouse.cloud/mcp"
enabled = true
连上时会开浏览器登录 ClickHouse Cloud。若 add 完还没票,再 codex mcp login clickhouse-cloud。用户层表名官方就是带连字符的 clickhouse-cloud(这不是插件 mcp.json)。访问范围跟你这个 Cloud 账号能看到的组织和服一致。
ChatGPT Work / Codex 公共插件目录里也有 ClickHouse 插件,捆绑这台远程 MCP 和 Agent Skills。TUI /plugins 或桌面 Plugins 搜 ClickHouse 再装,效果是连 MCP 并带上技能。官方没给 codex plugin add clickhouse@… 那种 id,不要自己编。插件已经带了 MCP 时,不要再 mcp add 同一张表。
run_select_query 只接受 SELECT。官方写明插件里的工具都是只读,改不了数据和服配置。自建集群不要用这台 Cloud 端点。
不要做这些:
- 不要抄 Claude 的
claude mcp add --transport http clickhouse-cloud https://mcp.clickhouse.cloud/mcp。Codex 是add名字--url地址。 - 不要抄 Windsurf 的
npx -y mcp-remote,也不要抄 Cursor / VS Code 的 JSON。 - 不要和 ClickStack 端点
https://mcp.clickhouse.cloud/clickstack搞混。那是另一台。 - 不要把 Sequel 的
api.sequel.sh/mcp当成 ClickHouse 官方路径。 - 不要抄本地
uv run示例里的--env CLICKHOUSE_PASSWORD=。自建 stdio 才用mcp-clickhouse,密钥走env_vars。 - 不要用
npx skills add clickhouse/agent-skills当 Codex 插件安装器。那会改所有检测到的客户端,还可能写进~/.codex/skills(Codex 主路径是~/.agents/skills)。 - 不要给它
required = true挂全局。不要一上来--yolo。
网页 Cloud 不读 ~/.codex/config.toml。Cloud 用 Plugins 搜 ClickHouse。改完新开会话,用 codex mcp get clickhouse-cloud 看传输是 streamable_http。