MCP Sunucusu

Herhangi bir Model Context Protocol istemcisini Api.Airforce’a bağlayın — modellerimizi, görselleri, model listesini ve bakiyenizi MCP araçları olarak kullanın, ücret hesabınıza yansır.

MCP nedir?

Model Context Protocol (MCP), Claude Desktop, Cursor veya MCP destekleyen herhangi bir uygulama gibi yapay zekâ ajan istemcilerinin harici hizmetleri araç olarak çağırmasını sağlar. Api.Airforce, bu istemcilerin modellerimizi doğrudan kullanabilmesi için uzak bir MCP sunucusu çalıştırır.

Uç nokta ve taşıma

Sunucu tek bir uç noktada Streamable HTTP üzerinden JSON-RPC 2.0 konuşur, protokol sürümü 2025-06-18. Accept: text/event-stream başlığını gönderdiğinizde akış yanıtları döner.

POST https://api.airforce/mcp

Kimlik doğrulama

Api.Airforce API anahtarınızı — veya bir OAuth 2.0 bearer belirtecini — Authorization başlığında gönderin. Kimliği doğrulanmamış istekler, OAuth meta verilerimize işaret eden bir WWW-Authenticate sınamasıyla 401 döndürür; böylece uyumlu istemciler OAuth akışını otomatik başlatabilir.

OAuth belirteçleri için ilgili kapsamlar profile (get_balance için), chat (chat_completion için) ve images (generate_image için) şeklindedir.

Bir istemciyi bağlama

Çoğu istemci, uzak bir MCP sunucu URL’si ve bir bearer belirteci kabul eder. Tipik bir yapılandırma şöyledir:

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

Bağlantıyı bir JSON-RPC initialize çağrısıyla elle doğrulayabilirsiniz:

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

Kullanılabilir araçlar

Çalışma zamanında keşfetmek için tools/list çağırın. Dört araç mevcuttur:

list_models

Kullanılabilir modelleri fiyatlar ve yetenek bayraklarıyla listeler.

get_balance

Kullandıkça öde bakiyenizi (ABD senti olarak) ve mevcut planınızı döndürür. OAuth belirteçleri için profile kapsamını gerektirir.

chat_completion

OpenAI uyumlu bir sohbet tamamlaması çalıştırır. Tıpkı POST /v1/chat/completions gibi hesabınıza yansıtılır.

generate_image

Bir görsel üretir. Tıpkı POST /v1/images/generations gibi hesabınıza yansıtılır.

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

Faturalandırma

chat_completion ve generate_image, REST API ile aynı ücretlerle hesabınıza yansıtılır — ayrı bir MCP fiyatlandırması yoktur. list_models ve get_balance ücretsizdir.

Keşif

Otomatik keşif için makine tarafından okunabilir bir sunucu kartı yayımlanır:

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