Api.Airforce
MCPサーバー

MCPサーバー

任意の Model Context Protocol クライアントを Api.Airforce に接続します。モデル・画像・モデル一覧・残高を MCP ツールとして利用でき、料金はアカウントに請求されます。

MCP とは？

Model Context Protocol（MCP）は、Claude Desktop・Cursor などの AI エージェントクライアント（MCP 対応アプリ全般）が外部サービスをツールとして呼び出せるようにする仕組みです。Api.Airforce はリモート MCP サーバーを提供し、これらのクライアントが当社のモデルを直接利用できます。

エンドポイントとトランスポート

サーバーは単一のエンドポイントで Streamable HTTP 上の JSON-RPC 2.0 を使用します（プロトコルバージョン 2025-06-18）。Accept: text/event-stream ヘッダーを送るとストリーミング応答が返ります。

POST https://api.airforce/mcp

認証

Api.Airforce の API キー、または OAuth 2.0 ベアラートークンを Authorization ヘッダーで送信します。未認証のリクエストには 401 と、当社の OAuth メタデータを指す WWW-Authenticate チャレンジが返るため、対応クライアントは OAuth フローを自動的に開始できます。

OAuth トークンでは、関連するスコープは profile（get_balance 用）、chat（chat_completion 用）、images（generate_image 用）です。

クライアントの接続

ほとんどのクライアントはリモート MCP サーバーの URL とベアラートークンを受け付けます。一般的な設定は次のとおりです。

{
  "mcpServers": {
    "api-airforce": {
      "url": "https://api.airforce/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

JSON-RPC の initialize 呼び出しで接続を手動で確認できます。

curl -X POST https://api.airforce/mcp \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"my-app","version":"1.0.0"}}}'

利用可能なツール

実行時に tools/list を呼び出して取得します。4 つのツールが利用できます。

list_models

価格と機能フラグ付きで、利用可能なモデルを一覧表示します。

get_balance

ペイ・アズ・ユー・ゴーの残高（米セント）と現在のプランを返します。OAuth トークンでは profile スコープが必要です。

chat_completion

OpenAI 互換のチャット補完を実行します。POST /v1/chat/completions とまったく同じようにアカウントへ請求されます。

generate_image

画像を生成します。POST /v1/images/generations とまったく同じようにアカウントへ請求されます。

curl -X POST https://api.airforce/mcp \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list"}'

請求

chat_completion と generate_image は REST API と同じ料金でアカウントに請求されます。MCP 専用の料金はありません。list_models と get_balance は無料です。

ディスカバリー

自動検出のために、機械可読のサーバーカードが公開されています。

https://api.airforce/.well-known/mcp/server-card.json