MCP-palvelin

Yhdistä mikä tahansa Model Context Protocol -asiakas Api.Airforceen — käytä mallejamme, kuvia, mallilistaa ja saldoasi MCP-työkaluina, veloitus tililtäsi.

Mikä MCP on?

Model Context Protocol (MCP) antaa tekoälyagenttien asiakkaiden — kuten Claude Desktopin, Cursorin tai minkä tahansa MCP-yhteensopivan sovelluksen — kutsua ulkoisia palveluja työkaluina. Api.Airforce ylläpitää etä-MCP-palvelinta, jotta nämä asiakkaat voivat käyttää mallejamme suoraan.

Päätepiste ja siirto

Palvelin puhuu JSON-RPC 2.0:aa Streamable HTTP:n päällä yhdessä päätepisteessä, protokollaversio 2025-06-18. Striimausvastaukset palautetaan, kun lähetät otsakkeen Accept: text/event-stream.

POST https://api.airforce/mcp

Todennus

Lähetä Api.Airforce-API-avaimesi — tai OAuth 2.0 -bearer-token — Authorization-otsakkeessa. Todentamattomat pyynnöt palauttavat 401:n ja WWW-Authenticate-haasteen, joka osoittaa OAuth-metatietoihimme, jotta yhteensopivat asiakkaat voivat aloittaa OAuth-kulun automaattisesti.

OAuth-tokeneille olennaiset scopet ovat profile (get_balancea varten), chat (chat_completionia varten) ja images (generate_imagea varten).

Asiakkaan yhdistäminen

Useimmat asiakkaat hyväksyvät etä-MCP-palvelimen URL-osoitteen ja bearer-tokenin. Tyypillinen kokoonpano näyttää tältä:

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

Voit varmistaa yhteyden manuaalisesti JSON-RPC initialize -kutsulla:

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

Saatavilla olevat työkalut

Kutsu tools/list löytääksesi ne ajonaikaisesti. Neljä työkalua on saatavilla:

list_models

Listaa saatavilla olevat mallit hintoineen ja ominaisuuslippuineen.

get_balance

Palauttaa pay-as-you-go-saldosi (Yhdysvaltain sentteinä) ja nykyisen tilauksesi. Vaatii profile-scopen OAuth-tokeneille.

chat_completion

Suorittaa OpenAI-yhteensopivan chat completionin. Veloitetaan tililtäsi täsmälleen kuten POST /v1/chat/completions.

generate_image

Luo kuvan. Veloitetaan tililtäsi täsmälleen kuten 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"}'

Laskutus

chat_completion ja generate_image veloitetaan tililtäsi samoilla hinnoilla kuin REST-API — erillistä MCP-hinnoittelua ei ole. list_models ja get_balance ovat ilmaisia.

Löytäminen

Koneluettava palvelinkortti julkaistaan automaattista löytämistä varten:

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