MCP-сервер

Подключите любой клиент Model Context Protocol к Api.Airforce — используйте наши модели, изображения, список моделей и баланс как инструменты MCP, с оплатой со счёта.

Что такое MCP?

Model Context Protocol (MCP) позволяет клиентам ИИ-агентов — таким как Claude Desktop, Cursor или любому приложению с поддержкой MCP — вызывать внешние сервисы как инструменты. Api.Airforce предоставляет удалённый MCP-сервер, чтобы такие клиенты могли напрямую использовать наши модели.

Эндпоинт и транспорт

Сервер использует JSON-RPC 2.0 поверх Streamable HTTP на одном эндпоинте, версия протокола 2025-06-18. Потоковые ответы возвращаются, если отправить заголовок Accept: text/event-stream.

POST https://api.airforce/mcp

Аутентификация

Отправьте ваш API-ключ Api.Airforce — или OAuth 2.0 bearer-токен — в заголовке Authorization. Неаутентифицированные запросы возвращают 401 с заголовком WWW-Authenticate, указывающим на наши метаданные OAuth, чтобы совместимые клиенты могли автоматически начать OAuth-поток.

Для OAuth-токенов используются скоупы profile (для get_balance), chat (для chat_completion) и images (для generate_image).

Подключение клиента

Большинство клиентов принимают URL удалённого MCP-сервера и bearer-токен. Типичная конфигурация выглядит так:

{
  "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, чтобы получить их во время выполнения. Доступны четыре инструмента:

list_models

Возвращает список доступных моделей с ценами и флагами возможностей.

get_balance

Возвращает баланс pay-as-you-go (в центах США) и текущий план. Требует скоуп profile для OAuth-токенов.

chat_completion

Выполняет OpenAI-совместимый chat completion. Списывается со счёта так же, как 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