JustOneAPI MCP Server

简体中文 | English

在 MCP 客户端（如 ChatGPT、Codex、Cursor、Hermes Agent 以及其他 AI 助手工具）中使用 JustOneAPI。

JustOneAPI MCP 可帮助你的助手找到正确的 JustOneAPI 端点、检查所需参数，并通过你的 JustOneAPI 授权调用 API。

支持的客户端

JustOneAPI MCP 支持远程 Streamable HTTP 和本地 stdio。当前已验证及兼容的路径包括：

• ChatGPT web 开发者模式 MCP 连接：OAuth，已验证。

• Codex CLI 和 Codex IDE 扩展：OAuth，已验证。

• Cursor、Hermes Agent 以及其他使用自定义请求头的客户端：现有 API Token 兼容方法。

• Claude.ai、Claude Desktop 和 Claude Code：OAuth 仍在兼容性测试中；Claude Code 可以使用现有 API Token 请求头。

支持兼容 OAuth 注册流程的客户端只需远程 URL 即可连接，并在浏览器中完成授权。兼容性还取决于客户端注册支持以及账户或工作区策略。不支持 OAuth 的客户端可以继续使用旧版 API Token 请求头或本地 stdio。

Related MCP server: MCP from API

快速开始

使用 OAuth 的远程 HTTP

生产服务已启用 OAuth。将以下 URL 添加为 MCP 连接：

https://mcp.justoneapi.com/mcp

兼容的客户端会发现受保护资源元数据，将你重定向到 auth.justoneapi.com，并请求同意页面上显示的 MCP 作用域。无需将任何 JustOneAPI API Token 粘贴到客户端中。入口点、OAuth 注册方法和账户限制因客户端而异，因此下面的设置只列出已验证的 OAuth 路径。

客户端设置

• ChatGPT web： 打开 Settings → Security and login，启用 Developer mode，打开 Plugins，然后选择 +。输入名称、描述以及上面的 /mcp URL，然后选择 OAuth 作为身份验证方式。创建连接后，ChatGPT 会发现身份验证元数据，并在连接期间或首次调用受保护工具时开始授权。开发者模式的可用性可能取决于 ChatGPT 账户和工作区策略。

• Codex CLI / IDE 扩展： 运行以下命令。当前推荐的设置明确使用已验证的 DCR 注册路径：

codex mcp add justoneapi \
  --url https://mcp.justoneapi.com/mcp

codex mcp login justoneapi \
  --oauth-client-registration dcr

ChatGPT 桌面应用、Codex CLI 和 Codex IDE 扩展在同一个 Codex 主机上共享 MCP 配置。有关当前入口点，请参阅 OpenAI MCP 官方文档 和 ChatGPT 连接测试指南。

Claude.ai、Claude Desktop 和 Claude Code 的 OAuth 仍处于兼容性测试阶段，尚未作为普遍支持的 OAuth 连接提供。Claude Code 可以使用现有 API Token，配合 --header "Authorization: Bearer your_token"；请勿将下面的通用 JSON 视为 Claude Code 配置。

授权页面会显示所请求的作用域。账户所有者选择现有 API Token 或创建一个专用 Token；Token 成员只能使用分配给该成员的 Token。之后断开应用连接只会撤销其 OAuth 连接；不会禁用或删除关联的 API Token。

使用现有 API Token 的远程 HTTP

现有的基于请求头的连接仍受支持，以保持兼容性：

{
  "mcpServers": {
    "justoneapi": {
      "url": "https://mcp.justoneapi.com/mcp",
      "headers": {
        "Authorization": "Bearer your_token"
      }
    }
  }
}

本地 stdio

截至 2026-08-25，npm latest 仍是旧版 1.0.1 包，而不是本仓库中的 v2 实现。如果需要本地 stdio，请锁定版本，以免将旧版 CLI 误认为是托管的 v2 服务：

{
  "mcpServers": {
    "justoneapi": {
      "command": "npx",
      "args": ["-y", "justoneapi-mcp@1.0.1"],
      "env": {
        "JUSTONEAPI_TOKEN": "your_token"
      }
    }
  }
}

旧版 1.0.1 支持 Node.js 18 或更高版本，其工具布局与托管的 v2 服务不同。OAuth 仅适用于远程 Worker；stdio 继续在本地读取 JUSTONEAPI_TOKEN。在 v2 实际发布到 npm dist-tag 后，请更新此版本说明。

目录构建和动态发布使用内置的公共安全验证，不需要操作员安全注册表或密钥。运行时 API 和账户调用返回上游负载，且不会在 MCP 层截断响应。

身份验证与作用域

OAuth 用户在授权页面选择要关联的 API Token，无需将其粘贴到客户端中。现有的 API Token 远程兼容方法使用：

Authorization: Bearer your_token

或者，对于本地 stdio：

JUSTONEAPI_TOKEN=your_token

本地 stdio 使用上面的环境变量。切勿将真实 Token 提交到仓库中。

OAuth 访问令牌使用三个最小权限作用域：

• mcp:catalog:read — 搜索端点、检查模式并列示平台。

• mcp:api:call — 调用 JustOneAPI 端点。

• mcp:account:read — 查看余额和使用情况。

call_endpoint 可能会根据 OAuth 期间关联的 API Token 及其当前定价、权限、余额和预算产生费用。它在获取短期委托令牌之前验证端点和参数，然后仅进行一次上游分发。它不会自动重试不确定的超时、网络故障或 HTTP 502/503/504 结果。

旧版 API Token 仍以既定的查询/表单格式发送到 JustOneAPI 后端。OAuth 访问令牌和委托令牌绝不会放入后端 URL 或表单正文中；委托令牌仅作为 Authorization Bearer 请求头发送。

操作员部署

生产环境当前运行在 dual 模式下。OAuth 是附加功能，受功能开关控制，以下开关仍是部署和回滚的边界：

• JUSTONEAPI_OAUTH_MODE=off 使远程服务仅保留旧版功能，并隐藏 OAuth 发现元数据。

• JUSTONEAPI_OAUTH_MODE=dual 在精确的 https://mcp.justoneapi.com 来源上同时接受现有 API Token 和标准 OAuth。

• 预览和 workers.dev 路由仍仅限旧版功能，即使该变量设置为 dual 也是如此。

Worker 使用 private_key_jwt 进行授权服务器内省和 RFC 8693 令牌交换。将私有 JWK 集和有效的 kid 作为 Worker 密钥存储；切勿提交 .dev.vars、PEM 文件或私有 JWK 集。轮换密钥时，先发布旧公钥和新公钥，再切换有效的 kid，并且只有在重叠期结束后才移除已退役的密钥。

npm 2.0 将首先通过 OIDC 可信发布在 next dist-tag 下发布。在精确发布的工件通过 Node.js 20、22 和 24 的冒烟检查后，操作员再使用 npm 2FA 单独将其提升，命令为 npm dist-tag add justoneapi-mcp@2.0.0 latest。此过程绝不会使用 NPM_TOKEN 自动化。参见 RELEASE.md。

你可以询问的内容

自然地询问你的 MCP 客户端：

Find the Xiaohongshu note comments API and tell me which parameters are required.

更多示例：

Which Douyin APIs can get video details?

Call the Xiaohongshu note comments API with this note ID: xxxxx.

List the Weibo search-related APIs and explain when to use each one.

Continue to the next page of results.

Check my JustOneAPI balance.

Show my recent API usage and spending.

The API returned code 400. Help me check which parameter might be wrong.

The API returned code 601 or 602. What does it mean?

助手可以搜索可用的 JustOneAPI 端点、解释所需参数、在你提供所需值后调用所选 API，并帮助解释常见的响应代码。

许可证

MIT