Máy chủ MCP

Kết nối bất kỳ client Model Context Protocol nào với Api.Airforce — dùng các mô hình, hình ảnh, danh sách mô hình và số dư của bạn như các công cụ MCP, tính phí vào tài khoản của bạn.

MCP là gì?

Model Context Protocol (MCP) cho phép các client tác nhân AI — như Claude Desktop, Cursor hoặc bất kỳ ứng dụng hỗ trợ MCP nào — gọi các dịch vụ bên ngoài như công cụ. Api.Airforce vận hành một máy chủ MCP từ xa để các client này dùng trực tiếp các mô hình của chúng tôi.

Endpoint và truyền tải

Máy chủ dùng JSON-RPC 2.0 trên Streamable HTTP tại một endpoint duy nhất, phiên bản giao thức 2025-06-18. Phản hồi dạng streaming được trả về khi bạn gửi header Accept: text/event-stream.

POST https://api.airforce/mcp

Xác thực

Gửi khóa API Api.Airforce — hoặc token bearer OAuth 2.0 — trong header Authorization. Các yêu cầu chưa xác thực trả về 401 kèm thử thách WWW-Authenticate trỏ tới metadata OAuth của chúng tôi, để các client tương thích tự động bắt đầu luồng OAuth.

Đối với token OAuth, các scope liên quan là profile (cho get_balance), chat (cho chat_completion) và images (cho generate_image).

Kết nối một client

Hầu hết client chấp nhận một URL máy chủ MCP từ xa cùng token bearer. Cấu hình điển hình như sau:

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

Bạn có thể kiểm tra kết nối thủ công bằng lệnh gọi 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"}}}'

Công cụ có sẵn

Gọi tools/list để khám phá chúng khi chạy. Có bốn công cụ:

list_models

Liệt kê các mô hình có sẵn kèm giá và cờ khả năng.

get_balance

Trả về số dư trả-theo-mức-dùng (tính bằng cent Mỹ) và gói hiện tại. Yêu cầu scope profile cho token OAuth.

chat_completion

Chạy chat completion tương thích OpenAI. Tính phí vào tài khoản của bạn y như POST /v1/chat/completions.

generate_image

Tạo một hình ảnh. Tính phí vào tài khoản của bạn y như 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"}'

Thanh toán

chat_completion và generate_image được tính phí vào tài khoản của bạn với cùng mức giá như REST API — không có bảng giá MCP riêng. list_models và get_balance miễn phí.

Khám phá

Một thẻ máy chủ có thể đọc bằng máy được công bố để tự động khám phá:

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