---
title: "Circle 支付 MCP 用 api.circle.com/v1/codegen/mcp，不是 CircleCI"
summary: "官方 Codex 节：codex mcp add circle --url https://api.circle.com/v1/codegen/mcp。这是 Wallets / Contracts / CCTP / Gateway 的代码生成 MCP，无账号。不要和 mcp.circleci.com 的 CircleCI 搞混，也不要抄 Kiro 的 npx @circle/mcp-server。"
category: mcp
level: intermediate
surfaces: [cli, app, ide]
tags: ["MCP", "Circle", "HTTP"]
canonical: /tips/mcp-circle-remote/
---

# Circle 支付 MCP 用 api.circle.com/v1/codegen/mcp，不是 CircleCI

官方 Codex 节：codex mcp add circle --url https://api.circle.com/v1/codegen/mcp。这是 Wallets / Contracts / CCTP / Gateway 的代码生成 MCP，无账号。不要和 mcp.circleci.com 的 CircleCI 搞混，也不要抄 Kiro 的 npx @circle/mcp-server。

Circle（circle.com，稳定币 / 钱包）官方给 Codex 的是托管 Streamable HTTP，用来**生成和修代码**，不是去扣你的生产余额：

```bash
codex mcp add circle --url https://api.circle.com/v1/codegen/mcp
```

```toml
[mcp_servers.circle]
url = "https://api.circle.com/v1/codegen/mcp"
enabled = true
```

服务器名用 `circle`。官方没要求 `mcp login`，也没要求 API key。连上后按 Wallets、Contracts、CCTP、Gateway 问它要示例和修法。

这**不是** CircleCI。CI 那台是 `mcp.circleci.com/v1/mcp`，表名 `circleci`，还要 `circleci auth login` 或 `CIRCLE_TOKEN`。两家不要写成同一张表，也不要共用 `CIRCLE_TOKEN`。

不要抄 Kiro 文档里的本地 `npx -y @circle/mcp-server` 加 `CIRCLE_BASE_URL`。那是另一套 stdio 包装。Codex 主路径就是上面的 `--url`。社区包 `@codespar/mcp-circle` / `circle-agent-stack-mcp` 会动钱包和打款，**不是**这条官方 codegen MCP。

不要做这些：

- 不要抄 `mcpServers` JSON，也不要抄 Claude 的 `--transport http`。
- 不要把 `https://api.circle.com/v1/codegen/mcp` 当成 CircleCI 托管地址。
- 不要给它 `required = true` 挂全局。
- 不要一上来 `--yolo`。生成出来的钱包 / 合约代码仍要人审。

网页 Cloud 不读 `~/.codex/config.toml`。改完新开会话。用 `codex mcp get circle` 看传输是 streamable_http。`codex mcp list` 里应同时能分清 `circle` 和 `circleci`。

## 来源

- [Circle · MCP server](https://developers.circle.com/ai/mcp)
- [OpenAI · Model Context Protocol](https://learn.chatgpt.com/docs/extend/mcp)