Servidor MCP

Conecte qualquer cliente do Model Context Protocol à Api.Airforce — use nossos modelos, imagens, a lista de modelos e seu saldo como ferramentas MCP, cobrado na sua conta.

O que é MCP?

O Model Context Protocol (MCP) permite que clientes de agentes de IA — como Claude Desktop, Cursor ou qualquer app compatível com MCP — chamem serviços externos como ferramentas. A Api.Airforce executa um servidor MCP remoto para que esses clientes usem nossos modelos diretamente.

Endpoint e transporte

O servidor fala JSON-RPC 2.0 sobre Streamable HTTP em um único endpoint, versão do protocolo 2025-06-18. Respostas em streaming são retornadas quando você envia o cabeçalho Accept: text/event-stream.

POST https://api.airforce/mcp

Autenticação

Envie sua chave de API Api.Airforce — ou um token bearer OAuth 2.0 — no cabeçalho Authorization. Requisições não autenticadas retornam 401 com um desafio WWW-Authenticate apontando para nossos metadados OAuth, para que clientes compatíveis iniciem o fluxo OAuth automaticamente.

Para tokens OAuth, os scopes relevantes são profile (para get_balance), chat (para chat_completion) e images (para generate_image).

Conectar um cliente

A maioria dos clientes aceita uma URL de servidor MCP remoto mais um token bearer. Uma configuração típica é assim:

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

Você pode verificar a conexão manualmente com uma chamada 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"}}}'

Ferramentas disponíveis

Chame tools/list para descobri-las em tempo de execução. Quatro ferramentas estão disponíveis:

list_models

Lista os modelos disponíveis com preços e flags de capacidade.

get_balance

Retorna seu saldo pay-as-you-go (em centavos de USD) e o plano atual. Requer o scope profile para tokens OAuth.

chat_completion

Executa uma chat completion compatível com OpenAI. Cobrada na sua conta exatamente como POST /v1/chat/completions.

generate_image

Gera uma imagem. Cobrada na sua conta exatamente como 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"}'

Cobrança

chat_completion e generate_image são cobrados na sua conta com as mesmas tarifas da API REST — não há preço de MCP separado. list_models e get_balance são gratuitos.

Descoberta

Um cartão de servidor legível por máquina é publicado para descoberta automática:

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