MCP-Server

Verbinde jeden Model-Context-Protocol-Client mit Api.Airforce — nutze unsere Modelle, Bilder, die Modellliste und dein Guthaben als MCP-Tools, abgerechnet über dein Konto.

Was ist MCP?

Das Model Context Protocol (MCP) erlaubt es KI-Agent-Clients — wie Claude Desktop, Cursor oder jeder MCP-fähigen App — externe Dienste als Tools aufzurufen. Api.Airforce betreibt einen Remote-MCP-Server, damit diese Clients unsere Modelle direkt nutzen können.

Endpunkt & Transport

Der Server spricht JSON-RPC 2.0 über Streamable HTTP an einem einzigen Endpunkt, Protokollversion 2025-06-18. Streaming-Antworten werden zurückgegeben, wenn du den Header Accept: text/event-stream sendest.

POST https://api.airforce/mcp

Authentifizierung

Sende deinen Api.Airforce-API-Key — oder ein OAuth-2.0-Bearer-Token — im Authorization-Header. Nicht authentifizierte Anfragen geben 401 mit einer WWW-Authenticate-Challenge zurück, die auf unsere OAuth-Metadaten zeigt, sodass kompatible Clients den OAuth-Flow automatisch starten können.

Für OAuth-Tokens sind die relevanten Scopes profile (für get_balance), chat (für chat_completion) und images (für generate_image).

Einen Client verbinden

Die meisten Clients akzeptieren eine Remote-MCP-Server-URL plus ein Bearer-Token. Eine typische Konfiguration sieht so aus:

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

Du kannst die Verbindung manuell mit einem JSON-RPC-initialize-Aufruf prüfen:

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"}}}'

Verfügbare Tools

Rufe tools/list auf, um sie zur Laufzeit zu entdecken. Vier Tools stehen zur Verfügung:

list_models

Listet die verfügbaren Modelle mit Preisen und Capability-Flags auf.

get_balance

Gibt dein Pay-as-you-go-Guthaben (in US-Cent) und den aktuellen Plan zurück. Erfordert den profile-Scope für OAuth-Tokens.

chat_completion

Führt eine OpenAI-kompatible Chat-Completion aus. Wird genau wie POST /v1/chat/completions über dein Konto abgerechnet.

generate_image

Generiert ein Bild. Wird genau wie POST /v1/images/generations über dein Konto abgerechnet.

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"}'

Abrechnung

chat_completion und generate_image werden zu denselben Preisen wie die REST-API über dein Konto abgerechnet — es gibt keine separate MCP-Preisliste. list_models und get_balance sind kostenlos.

Discovery

Eine maschinenlesbare Server-Card wird zur automatischen Erkennung veröffentlicht:

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