将 UnifAPI MCP 连接到 Claude、ChatGPT、Codex、Claude Code、Cursor、VS Code、OpenClaw 或 Hermes，并运行第一个公开数据 Skill。

一句话概括：这是面向 MCP 配置类查询的上手文章——添加托管的 UnifAPI 服务器、用 OAuth 鉴权，然后在你已经在用的 Agent 客户端里运行一个 Skill。

要让一个兼容的通用 Agent、研究型 Agent、编程 Agent 或支持 MCP 的客户端访问 UnifAPI 公开数据，最快的方式就是连接托管的 MCP 服务器。添加一个 URL，在客户端提示时完成鉴权，Agent 就能运行 Skills，而无需你编写胶水代码或粘贴各平台专属的 API 密钥。

UnifAPI MCP 服务器的规范 URL 是 https://mcp.unifapi.com 。在客户端支持的地方使用 OAuth。API 密钥 bearer 鉴权仍作为一条兼容路径保留，但对大多数操作者而言，它不应是首选的配置方式。

你正在连接的是什么

MCP 给 Agent 提供了一个工具接口。UnifAPI 的托管 MCP 服务器对外暴露三个目录工具：用于发现的 list_operations、用于查看 schema 和示例的 get_operation，以及用于调用某个具体公开数据操作的 call_api。Agent 无需为每一个 API 端点准备一个单独的工具。

项目	取值
服务器 URL	`https://mcp.unifapi.com`
推荐鉴权	通过 MCP 客户端的 OAuth
兼容鉴权	当客户端要求静态令牌时使用 API 密钥 bearer 头
会被计费的内容	实时 API 返回的公开数据记录
不会被 UnifAPI 计费的内容	你已经在付费的模型 token 或 Agent 套餐

开始之前

你需要一个支持 MCP 的客户端、一个 OAuth 开放后的 UnifAPI 账户，以及足够的工作空间积分来返回公开数据记录。你可以在登录前浏览 Skills。登录这一步应发生在 Agent 真正需要调用工具的时刻。

如果你在用 Claude Desktop 或 Claude.ai 的自定义连接器进行测试，请记住远程连接器是通过 Anthropic 的云端中转的。你的 MCP 服务器必须能从公共互联网访问到。对 https://mcp.unifapi.com 来说这没问题；只有私有的本地服务器才会遇到这个障碍。

Codex

Codex 通过 Codex CLI 和共享配置支持远程 HTTP MCP 服务器。用以下命令添加 UnifAPI：

codex mcp add unifapi --url https://mcp.unifapi.com

然后验证服务器已配置：

codex mcp list

打开一个新的 Codex 会话，让它执行一个 Skill 风格的任务，而不仅仅是一次泛泛的 API 调用。例如：Run a KOL pricing pass for these Twitter/X creators using UnifAPI public data. Return ranges, evidence, confidence, and follow-up questions.

Claude Code

Claude Code 当前的参考文档建议在可用时对云端 MCP 服务器使用远程 HTTP。在你希望 Claude Code 使用它的项目里添加 UnifAPI：

claude mcp add --transport http unifapi https://mcp.unifapi.com

如果你希望该服务器跨项目可用，使用 user 作用域：

claude mcp add --transport http --scope user unifapi https://mcp.unifapi.com

在 Claude Code 内，运行 /mcp 以确认连接状态，并在需要时完成 OAuth。如果该服务器是通过 .mcp.json 在项目作用域内配置的，Claude Code 可能会在使用前请求批准。

Claude Desktop 与 Claude.ai

要在 Claude Desktop 或 Claude.ai 中使用远程 MCP 连接器，请依次进入 Customize -> Connectors -> + -> Add custom connector。输入一个清晰的名称，例如 UnifAPI，并填入连接器 URL https://mcp.unifapi.com，然后点击 Connect 进行鉴权。

也可以不走菜单：这个链接会直接打开同一个对话框，名称和 URL 已填好。核对后点 Add，再点 Connect。

不要把远程连接器和旧的仅限本地的 Desktop MCP 配置混为一谈。远程连接器是在 Claude 设置界面里添加的，连接之后可以跨 Claude 各处使用。而通过桌面端配置设置的本地 stdio 服务器，是另一套机制。

Cursor

Cursor 通过 mcp.json 支持 MCP。若要做全局配置，创建或编辑 ~/.cursor/mcp.json。若只想做项目级配置，在项目里创建 .cursor/mcp.json。

使用这种远程服务器的写法：

{ "mcpServers": { "unifapi": { "url": "https://mcp.unifapi.com" } } }

如果服务器没有立即出现，重启 Cursor 或刷新 MCP 工具视图。Cursor 的 Agent 会在相关时使用已启用的 MCP 工具，并可能根据你的设置在运行工具前请求批准。

第一个要运行的 Skill

使用一段任务提示词，告诉 Agent 你想要什么结果、要检查什么证据。一个不错的首次运行是：

Find Twitter/X KOLs discussing AI coding tools and summarize the best outreach angles. Use UnifAPI public data through MCP. Return a ranked shortlist, public evidence, risk notes, and follow-up questions. Keep the workflow bounded to public data.

第二个有用的测试是：

Find the top three TikTok videos about Anthropic this week. Use UnifAPI MCP. Show the public records you used, then summarize the pattern in one paragraph.

Agent 应当发现操作、查看正确的操作、调用它，并综合结果。如果它试图不查看目录就猜测端点名称，让它先调用 list_operations 和 get_operation。

会被计费的内容

工作空间积分每个 $0.001。标准的计费记录为 1 积分，成本更高的操作会从 OpenAPI 公布其最低积分消耗。首充一次性赠送的 2,000 积分足以让你测试几个轻量工作流的形态。当你准备好反复运行时，再为按量付费的余额充值。

最重要的成本习惯是给提示词设界。先索要前 10 条或前 20 条记录，只在答案有用时再深入。一个含糊的请求，比如"研究关于这个市场的一切"，可能会在许多操作上扩散开来。而一个有边界的请求，比如"拉取 20 个 Reddit 主题串并总结反复出现的异议"，更容易审视和做预算。

故障排查

症状	可能原因	怎么做
服务器出现了，但没有工具被使用	Agent 没有选择那些 MCP 工具	先让它列出可用的 UnifAPI 操作
OAuth 没有完成	浏览器/鉴权流程没有走完	重新打开 `/mcp` 或客户端连接器设置并重新连接
工具调用返回未授权	鉴权路径错误或令牌过期	用 OAuth 重新鉴权，或检查 bearer 令牌配置
结果太宽泛	提示词缺少限制	加上平台、时间窗口、记录数和输出格式
答案过度断言	提示词没有设定边界	要求附上证据、置信度和未知项

已核查的来源

本配置指南于 2026 年 6 月 2 日依据官方 OpenAI Docs MCP 页面、Claude Code MCP 参考文档、Anthropic 的自定义连接器帮助中心文章以及 Cursor 的 MCP 文档进行了刷新。

接下来可以读什么

MCP 配置 —— 把当前的托管连接器说明集中在一处。

用 MCP 运行 KOL 报价 Agent —— 给出配置完成后的第一个任务。

MCP 目录工具设计 —— 解释 Agent 如何发现和调用操作。