Serwer MCP

Podłącz dowolnego klienta Model Context Protocol do Api.Airforce — korzystaj z naszych modeli, obrazów, listy modeli i swojego salda jako narzędzi MCP, rozliczanych na Twoim koncie.

Czym jest MCP?

Model Context Protocol (MCP) pozwala klientom agentów AI — takim jak Claude Desktop, Cursor czy dowolna aplikacja obsługująca MCP — wywoływać usługi zewnętrzne jako narzędzia. Api.Airforce udostępnia zdalny serwer MCP, aby ci klienci mogli bezpośrednio korzystać z naszych modeli.

Punkt końcowy i transport

Serwer używa JSON-RPC 2.0 przez Streamable HTTP w jednym punkcie końcowym, wersja protokołu 2025-06-18. Odpowiedzi strumieniowe są zwracane, gdy wyślesz nagłówek Accept: text/event-stream.

POST https://api.airforce/mcp

Uwierzytelnianie

Wyślij swój klucz API Api.Airforce — lub token bearer OAuth 2.0 — w nagłówku Authorization. Nieuwierzytelnione żądania zwracają 401 z wyzwaniem WWW-Authenticate wskazującym na nasze metadane OAuth, aby zgodni klienci mogli automatycznie rozpocząć przepływ OAuth.

Dla tokenów OAuth istotne zakresy to profile (dla get_balance), chat (dla chat_completion) i images (dla generate_image).

Podłączanie klienta

Większość klientów akceptuje adres URL zdalnego serwera MCP oraz token bearer. Typowa konfiguracja wygląda tak:

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

Połączenie możesz zweryfikować ręcznie wywołaniem 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"}}}'

Dostępne narzędzia

Wywołaj tools/list, aby odkryć je w czasie działania. Dostępne są cztery narzędzia:

list_models

Wyświetla dostępne modele z cenami i flagami możliwości.

get_balance

Zwraca Twoje saldo pay-as-you-go (w centach USD) i bieżący plan. Wymaga zakresu profile dla tokenów OAuth.

chat_completion

Uruchamia chat completion zgodny z OpenAI. Rozliczany na Twoim koncie dokładnie jak POST /v1/chat/completions.

generate_image

Generuje obraz. Rozliczany na Twoim koncie dokładnie jak 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"}'

Rozliczenia

chat_completion i generate_image są rozliczane na Twoim koncie według tych samych stawek co API REST — nie ma osobnego cennika MCP. list_models i get_balance są bezpłatne.

Wykrywanie

Publikowana jest czytelna maszynowo karta serwera do automatycznego wykrywania:

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