Serveur MCP

Connectez n’importe quel client Model Context Protocol à Api.Airforce — utilisez nos modèles, images, la liste des modèles et votre solde comme outils MCP, facturés sur votre compte.

Qu’est-ce que MCP ?

Le Model Context Protocol (MCP) permet aux clients agents IA — comme Claude Desktop, Cursor ou toute application compatible MCP — d’appeler des services externes en tant qu’outils. Api.Airforce exploite un serveur MCP distant pour que ces clients utilisent directement nos modèles.

Point de terminaison & transport

Le serveur parle JSON-RPC 2.0 via Streamable HTTP sur un seul point de terminaison, version de protocole 2025-06-18. Les réponses en streaming sont renvoyées lorsque vous envoyez l’en-tête Accept: text/event-stream.

POST https://api.airforce/mcp

Authentification

Envoyez votre clé API Api.Airforce — ou un jeton bearer OAuth 2.0 — dans l’en-tête Authorization. Les requêtes non authentifiées renvoient 401 avec un défi WWW-Authenticate pointant vers nos métadonnées OAuth, afin que les clients conformes démarrent automatiquement le flux OAuth.

Pour les jetons OAuth, les scopes concernés sont profile (pour get_balance), chat (pour chat_completion) et images (pour generate_image).

Connecter un client

La plupart des clients acceptent une URL de serveur MCP distant et un jeton bearer. Une configuration typique ressemble à ceci :

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

Vous pouvez vérifier la connexion manuellement avec un appel 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"}}}'

Outils disponibles

Appelez tools/list pour les découvrir à l’exécution. Quatre outils sont disponibles :

list_models

Liste les modèles disponibles avec les tarifs et les indicateurs de capacité.

get_balance

Renvoie votre solde pay-as-you-go (en cents US) et votre plan actuel. Nécessite le scope profile pour les jetons OAuth.

chat_completion

Exécute une complétion de chat compatible OpenAI. Facturée sur votre compte exactement comme POST /v1/chat/completions.

generate_image

Génère une image. Facturée sur votre compte exactement comme 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"}'

Facturation

chat_completion et generate_image sont facturés sur votre compte aux mêmes tarifs que l’API REST — il n’y a pas de tarification MCP distincte. list_models et get_balance sont gratuits.

Découverte

Une fiche serveur lisible par machine est publiée pour la découverte automatique :

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