Server MCP

Hubungkan klien Model Context Protocol mana pun ke Api.Airforce — gunakan model, gambar, daftar model, dan saldo Anda sebagai alat MCP, ditagih ke akun Anda.

Apa itu MCP?

Model Context Protocol (MCP) memungkinkan klien agen AI — seperti Claude Desktop, Cursor, atau aplikasi apa pun yang mendukung MCP — memanggil layanan eksternal sebagai alat. Api.Airforce menjalankan server MCP jarak jauh agar klien-klien ini dapat menggunakan model kami secara langsung.

Endpoint & transport

Server berbicara JSON-RPC 2.0 melalui Streamable HTTP di satu endpoint, versi protokol 2025-06-18. Respons streaming dikembalikan saat Anda mengirim header Accept: text/event-stream.

POST https://api.airforce/mcp

Autentikasi

Kirim kunci API Api.Airforce — atau token bearer OAuth 2.0 — di header Authorization. Permintaan yang tidak terautentikasi mengembalikan 401 dengan tantangan WWW-Authenticate yang menunjuk ke metadata OAuth kami, sehingga klien yang patuh dapat memulai alur OAuth secara otomatis.

Untuk token OAuth, scope yang relevan adalah profile (untuk get_balance), chat (untuk chat_completion), dan images (untuk generate_image).

Menghubungkan klien

Sebagian besar klien menerima URL server MCP jarak jauh ditambah token bearer. Konfigurasi tipikal terlihat seperti ini:

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

Anda dapat memverifikasi koneksi secara manual dengan panggilan 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"}}}'

Alat yang tersedia

Panggil tools/list untuk menemukannya saat runtime. Tersedia empat alat:

list_models

Menampilkan model yang tersedia beserta harga dan flag kemampuan.

get_balance

Mengembalikan saldo pay-as-you-go Anda (dalam sen AS) dan paket saat ini. Memerlukan scope profile untuk token OAuth.

chat_completion

Menjalankan chat completion yang kompatibel dengan OpenAI. Ditagih ke akun Anda persis seperti POST /v1/chat/completions.

generate_image

Menghasilkan gambar. Ditagih ke akun Anda persis seperti 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"}'

Penagihan

chat_completion dan generate_image ditagih ke akun Anda dengan tarif yang sama seperti REST API — tidak ada harga MCP terpisah. list_models dan get_balance gratis.

Penemuan

Kartu server yang dapat dibaca mesin diterbitkan untuk penemuan otomatis:

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