MCP 서버

모든 Model Context Protocol 클라이언트를 Api.Airforce에 연결하세요. 모델, 이미지, 모델 목록, 잔액을 MCP 도구로 사용할 수 있으며 비용은 계정으로 청구됩니다.

MCP란?

Model Context Protocol(MCP)은 Claude Desktop, Cursor 등 AI 에이전트 클라이언트(MCP 지원 앱)가 외부 서비스를 도구로 호출할 수 있게 합니다. Api.Airforce는 원격 MCP 서버를 운영하여 이러한 클라이언트가 당사 모델을 직접 사용할 수 있도록 합니다.

엔드포인트 및 전송

서버는 단일 엔드포인트에서 Streamable HTTP 기반 JSON-RPC 2.0을 사용합니다(프로토콜 버전 2025-06-18). Accept: text/event-stream 헤더를 보내면 스트리밍 응답이 반환됩니다.

POST https://api.airforce/mcp

인증

Api.Airforce API 키 또는 OAuth 2.0 베어러 토큰을 Authorization 헤더로 보내세요. 인증되지 않은 요청은 OAuth 메타데이터를 가리키는 WWW-Authenticate 챌린지와 함께 401을 반환하므로, 호환 클라이언트가 OAuth 플로우를 자동으로 시작할 수 있습니다.

OAuth 토큰의 경우 관련 스코프는 profile(get_balance용), chat(chat_completion용), images(generate_image용)입니다.

클라이언트 연결

대부분의 클라이언트는 원격 MCP 서버 URL과 베어러 토큰을 허용합니다. 일반적인 구성은 다음과 같습니다:

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

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

사용 가능한 도구

런타임에 tools/list를 호출하여 확인하세요. 네 가지 도구를 사용할 수 있습니다:

list_models

가격 및 기능 플래그와 함께 사용 가능한 모델을 나열합니다.

get_balance

사용한 만큼 지불(pay-as-you-go) 잔액(미국 센트)과 현재 요금제를 반환합니다. OAuth 토큰에는 profile 스코프가 필요합니다.

chat_completion

OpenAI 호환 채팅 완성을 실행합니다. POST /v1/chat/completions와 똑같이 계정에 청구됩니다.

generate_image

이미지를 생성합니다. 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"}'

청구

chat_completion과 generate_image는 REST API와 동일한 요율로 계정에 청구됩니다. 별도의 MCP 요금은 없습니다. list_models와 get_balance는 무료입니다.

디스커버리

자동 검색을 위해 기계가 읽을 수 있는 서버 카드가 게시됩니다:

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