JustOneAPI MCP Server

简体中文 | English

Используйте JustOneAPI в MCP-клиентах, таких как ChatGPT, Codex, Cursor, Hermes Agent и другие инструменты ИИ-ассистентов.

JustOneAPI MCP помогает вашему ассистенту найти нужную конечную точку JustOneAPI, проверить требуемые параметры и вызывать API через вашу авторизацию JustOneAPI.

Поддерживаемые клиенты

JustOneAPI MCP поддерживает удалённый Streamable HTTP и локальный stdio. Текущие проверенные и совместимые пути включают:

• Подключения MCP в веб-версии ChatGPT в режиме разработчика: OAuth, проверено.

• Codex CLI и расширение Codex для IDE: OAuth, проверено.

• Cursor, Hermes Agent и другие клиенты с пользовательскими заголовками: существующий метод совместимости с API-токеном.

• Claude.ai, Claude Desktop и Claude Code: OAuth остаётся на этапе проверки совместимости; Claude Code может использовать существующий заголовок API-токена.

Клиенты с совместимым процессом регистрации OAuth могут подключиться, указав только удалённый URL, и завершить авторизацию в браузере. Совместимость также зависит от поддержки регистрации в клиенте и политики учётной записи или рабочей области. Клиенты без OAuth могут продолжать использовать устаревший заголовок API-токена или локальный stdio.

Related MCP server: MCP from API

Быстрый старт

Удалённый HTTP с OAuth

OAuth включён на производственном сервисе. Добавьте этот URL как MCP-подключение:

https://mcp.justoneapi.com/mcp

Совместимые клиенты обнаруживают метаданные защищённого ресурса, перенаправляют вас на auth.justoneapi.com и запрашивают области MCP, показанные на странице согласия. В клиент не нужно вставлять API-токен JustOneAPI. Точки входа, методы регистрации OAuth и ограничения учётной записи различаются в зависимости от клиента, поэтому в настройках ниже перечислены только проверенные пути OAuth.

Настройка клиента

• ChatGPT web: откройте Settings → Security and login, включите Developer mode, откройте Plugins и выберите +. Введите имя, описание и указанный выше URL /mcp, затем выберите 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 используют общую конфигурацию MCP на одном хосте Codex. Актуальные точки входа см. в официальной документации OpenAI по MCP и руководстве по тестированию подключения ChatGPT.

OAuth для Claude.ai, Claude Desktop и Claude Code остаётся на этапе проверки совместимости и пока не предлагается как общедоступное OAuth-подключение. Claude Code может использовать существующий API-токен с --header "Authorization: Bearer your_token"; не рассматривайте приведённый ниже общий JSON как конфигурацию Claude Code.

На странице авторизации показаны запрашиваемые области. Владелец учётной записи выбирает существующий API-токен или создаёт отдельный; участник с токеном может использовать только токен, назначенный этому участнику. Последующее отключение приложения отзывает только его OAuth-подключение; оно не отключает и не удаляет связанный API-токен.

Удалённый HTTP с существующим API-токеном

Существующее подключение на основе заголовка по-прежнему поддерживается для совместимости:

{
  "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-токен для привязки на странице авторизации и не вставляют его в клиент. Существующий метод удалённой совместимости с API-токеном использует:

Authorization: Bearer your_token

или для локального stdio:

JUSTONEAPI_TOKEN=your_token

Локальный stdio использует указанную выше переменную окружения. Никогда не коммитьте реальный токен в репозиторий.

Токены доступа OAuth используют три области с минимальными привилегиями:

• mcp:catalog:read — поиск конечных точек, просмотр схем и список платформ.

• mcp:api:call — вызов конечной точки JustOneAPI.

• mcp:account:read — просмотр баланса и использования.

call_endpoint может взимать плату в соответствии с API-токеном, привязанным во время OAuth, и его текущими тарифами, разрешениями, балансом и бюджетом. Он проверяет конечную точку и параметры перед получением кратковременного делегированного токена, а затем выполняет ровно одну отправку на вышестоящий сервис. Он не выполняет автоматический повтор при неопределённом таймауте, сетевом сбое или результате HTTP 502/503/504.

Устаревшие API-токены по-прежнему отправляются в бэкенд JustOneAPI в установленном формате query/form. Токены доступа и делегированные токены OAuth никогда не помещаются в URL бэкенда или тела форм; делегированные токены отправляются только как заголовок Authorization Bearer.

Развёртывание оператором

Продакшн в настоящее время работает в режиме dual. OAuth является аддитивным и управляется функциональным флагом, и эти переключатели остаются границей развёртывания и отката:

• JUSTONEAPI_OAUTH_MODE=off оставляет удалённый сервис только в устаревшем режиме и скрывает метаданные обнаружения OAuth.

• JUSTONEAPI_OAUTH_MODE=dual принимает как существующие API-токены, так и стандартный OAuth на точном origin https://mcp.justoneapi.com.

• Маршруты Preview и workers.dev остаются только в устаревшем режиме, даже если переменная установлена в dual.

Worker использует private_key_jwt для интроспекции Authorization Server и обмена токенов RFC 8693. Храните закрытый набор JWK и активный kid как секреты Worker; никогда не коммитьте .dev.vars, PEM-файлы или закрытые наборы JWK. Ротируйте ключи, сначала публикуя старые и новые открытые ключи, затем переключая активный kid, и удаляя выведенный из эксплуатации ключ только после периода перекрытия.

npm 2.0 будет сначала опубликован под dist-tag next через доверенную публикацию OIDC. После того как точно опубликованный артефакт пройдёт смоук-тесты на 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