MCP 到底改变了什么
MCP 是一套标准,让 AI 客户端可以发现并调用服务器上的工具。在 MCP 之前,每个智能体框架都有自己的插件格式,同一个能力要在 Claude Code、Cursor、Codex 里各实现一遍。
实际收益很直接:智能体获得一套稳定的能力接口,你也不必再维护多份并行的集成代码。
需要分别配置的两个层面
这是最容易混淆的地方,开始前先分清楚。
把 RockAPI 添加为 MCP 服务器时,它属于工具层。通过 OpenAI 兼容 API 使用 RockAPI 作为模型供应商时,它属于模型层。两者可以同时使用,但是两条独立的配置项。
开始前准备
- 创建 API Key。 在 rockapi.ai/keys 生成,放进环境变量,不要写进会提交到仓库的文件。
- 复制 MCP 配置。 控制台的 MCP 页面会展示你账号对应的 MCP 地址和请求头格式,用页面上给出的值,不要凭记忆手写 URL。
- 确认客户端支持 MCP。 Claude Code、Cursor、Codex、VS Code 和 Claude Desktop 都已支持。如果下面的命令被拒绝,先检查客户端版本。
- 确定使用的模型。 无论用哪个客户端,智能体仍然需要一个 LLM,在客户端的供应商设置里选择,或者经由 RockAPI 调用。
添加 MCP 服务器
各客户端的命令不同,但输入项一样:一个地址、一种传输方式、一个Authorization: Bearer 请求头。
Claude Code
Codex
在~/.codex/config.toml 中加入服务器条目。通过环境变量读取 token,可以避免密钥落在文件里:
Cursor 和 VS Code
两者都在 JSON 配置里接受 HTTP 类型的 MCP 服务器。请使用客户端支持的环境变量插值语法,避免把密钥明文写进配置:Claude Desktop
Claude Desktop 启动的是命令行型服务器,所以要用mcp-remote 做桥接:
验证连接
服务器显示已连接,并不等于可以上生产。请确认下面四项行为。
如果服务器连上了但调用失败,问题通常在 token 而不是传输方式。先轮换 Key 重试,再排查其他原因。
避免事故的几条规则
- 给 Key 划范围。 MCP 集成用独立的 Key,不要复用主账号的生产 Key,这样吊销其中一个不会影响另一个。
- 先只读。 只授予完成任务所需的最小能力,确有工作流需要时再放开。
- 单独观察花费。 工具型智能体会产生大量小请求,独立 Key 能让每个智能体的成本在面板里可分辨。
- 密钥放环境变量。 把 Key 粘贴进已提交的配置文件是智能体配置中最常见的泄漏方式,参见 API Key 安全管理。
- 记录工具调用。 智能体行为异常时,工具调用序列比最终答案更能说明问题。
常见问题
MCP 和 OpenAI 兼容 API 是一回事吗?
不是。OpenAI 兼容 API 规范的是代码怎么调用模型;MCP 规范的是 AI 客户端怎么发现和调用工具。RockAPI 两者都提供,配置位置不同。用了 MCP 还需要 API Key 吗?
需要。MCP 服务器是可访问的,但 Key 才是识别账号、执行限流和记录计费的依据。一个 MCP 服务器能给多个智能体用吗?
可以,这正是重点。同一份服务器配置可以跨客户端复用,Claude Code 和 Cursor 用同一把 Key 访问同一套能力。MCP 会改变模型计费方式吗?
不会。计费仍按实际模型调用计算,计费规则见 价格与计费。客户端还不支持 HTTP 类型的 MCP 服务器怎么办?
用 Claude Desktop 示例里的mcp-remote 桥接。它把 HTTP 地址转成本地 stdio 进程,任何命令行型客户端都能启动。
下一步
如果还没发过请求,先跟 快速开始 跑通,再看 模型与供应商 选择智能体背后的模型。需要跨多个智能体控制成本时,可以参考 AI API 网关 的思路。创建 API Key 并接入智能体
生成 Key,从控制台复制 MCP 配置,在接入生产流量前先验证连接。
