身份认证

UnifAPI 有两条身份认证路径：

• MCP OAuth 用于智能体工作流和 Skills。
• API key 用于来自产品代码、脚本或自定义运行时的直接 HTTP 调用。

OAuth 和 API key 授权访问 UnifAPI 工作区 credits。它们不是来源提供方的令牌，也不授予对 Twitter/X、Google、CRM 或其他 SaaS 平台上私有用户账户的访问权限。

MCP OAuth

支持 OAuth 的 MCP 客户端应当使用它。添加托管的 MCP 服务器 URL，在智能体首次需要工具时于浏览器中认证，OAuth 令牌即绑定到你的 UnifAPI 工作区：

https://mcp.unifapi.com

MCP 受保护资源元数据可在以下地址获取：

https://mcp.unifapi.com/.well-known/oauth-protected-resource

所需作用域：

unifapi:mcp

用户可以在注册之前浏览 Skills。注册发生在 OAuth 流程期间，即当客户端需要调用 list_operations、get_operation 或 call_api 时。

关于 Claude、ChatGPT 自定义 MCP 应用、OpenClaw、Hermes、Codex、Claude Code、Cursor、VS Code 以及其他 MCP 客户端的配置，请参见 MCP 集成。

API key

直接的 HTTP API 调用使用单一的 bearer 令牌进行认证：

Authorization: Bearer $UNIFAPI_KEY

• Key 是工作区范围的——每位团队成员看到相同的用量和账单。
• Key 针对工作区 credit 余额授权用量。
• Key 自身永不过期。如果你怀疑泄露，请吊销并重新创建。

当你直接调用 https://api.unifapi.com 时使用 API key。当一个支持 MCP 的智能体可以完成基于浏览器的流程时使用 OAuth。

错误

401 意味着 key 缺失、格式错误、被吊销、被禁用、已过期或以其他方式无效：

{
  "error": {
    "type": "unauthorized",
    "message": "Missing or invalid API key."
  }
}

完整词汇表请参见 错误。