JustOneAPI MCP Server

简体中文 | 英語

ChatGPT、Codex、Cursor、Hermes Agent、その他のAIアシスタントツールなどのMCPクライアントでJustOneAPIを使用します。

JustOneAPI MCPは、アシスタントが適切なJustOneAPIエンドポイントを見つけ、必要なパラメータを確認し、JustOneAPIの認証を通じてAPIを呼び出すのに役立ちます。

対応クライアント

JustOneAPI MCPは、リモートのStreamable HTTPとローカルのstdioをサポートしています。現在検証済みおよび互換性のある経路は次のとおりです。

• ChatGPT webのDeveloper modeでの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は認証メタデータを検出し、接続時または保護されたツールが最初に呼び出されたときに認証を開始します。Developer modeの利用可否は、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は、--header "Authorization: Bearer your_token"を使用して既存のAPI Tokenを使用できます。以下の一般的なJSONをClaude Codeの設定として扱わないでください。

認証ページには要求されたスコープが表示されます。アカウント所有者は既存のAPI Tokenを選択するか、専用のAPI Tokenを作成します。Token Memberは、そのメンバーに割り当てられた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アクセストークンは、最小権限の3つのスコープを使用します。

• mcp:catalog:read — エンドポイントの検索、スキーマの確認、プラットフォームの一覧表示。

• mcp:api:call — JustOneAPIエンドポイントの呼び出し。

• mcp:account:read — 残高と使用量の表示。

call_endpointは、OAuth中にリンクされたAPI Tokenと、その現在の料金、権限、残高、予算に応じて料金が発生する場合があります。エンドポイントとパラメータを検証してから、短期間有効な委任トークンを取得し、アップストリームへのディスパッチを正確に1回実行します。不確実なタイムアウト、ネットワーク障害、または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は、Authorization ServerのイントロスペクションとRFC 8693トークン交換にprivate_key_jwtを使用します。秘密の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