Documentação MCP

O MCP de documentação da AIVAX expõe a documentação da AIVAX, o conteúdo de referência da API e metadados de modelo para clientes compatíveis com MCP. Ele é projetado para assistentes, IDEs, agentes internos e fluxos de trabalho de implementação que precisam do contexto atual da AIVAX antes de responder, escrever código, configurar um gateway ou solucionar problemas de integração.

Este MCP é orientado à leitura. Ele não expõe uma ferramenta genérica de invocação de API de conta. Use-o quando um agente precisar entender os recursos da AIVAX, encontrar a rota correta da API, comparar capacidades de modelo ou basear sua resposta no manual do produto. Use o account management MCP apenas quando o cliente também precisar inspecionar ou alterar recursos de conta autenticados via chamadas de API.

Endpoint #

https://inference.aivax.net/v1/mcp/documentation

Autentique com uma chave de API de conta da AIVAX:

Authorization: Bearer <AIVAX_PRIVATE_API_KEY>

Para tipos de chave e opções de autenticação, veja Authentication.

Exemplo de configuração #

A configuração exata depende do cliente MCP. Para clientes que aceitam uma entrada de servidor HTTP streamável, configure o endpoint de documentação da AIVAX e passe a chave de API como cabeçalho.

{
  "servers": {
    "aivax-docs": {
      "type": "http",
      "url": "https://inference.aivax.net/v1/mcp/documentation",
      "headers": {
        "Authorization": "Bearer <AIVAX_PRIVATE_API_KEY>"
      }
    }
  }
}

Após o cliente se conectar, ele pode descobrir as ferramentas expostas pelo servidor. Os nomes das ferramentas são prefixados com aivax_ para que permaneçam claros quando o cliente também possui ferramentas de projeto, banco de dados, navegador ou código disponíveis.

Ferramentas disponíveis #

aivax_search_documentation #

Busca na documentação da AIVAX e no conteúdo de referência da API. Use esta ferramenta quando o assistente precisar de contexto do produto antes de responder ou agir.

A ferramenta aceita:

A busca pode consultar o manual de documentação, a referência de funções da API ou ambos. Ela devolve trechos relevantes da documentação em formato de texto para que o cliente possa usá-los diretamente como contexto. A busca está limitada a 10 termos por chamada e 500 caracteres totais entre todos os termos.

Exemplo de argumentos:

{
  "search_terms": [
    "AI Gateway MCP headers",
    "tool metadata"
  ],
  "search_type": "all"
}

Use frases mais completas quando a pergunta tiver uma intenção clara, como semantic search reranker settings ou public key chat completion restrictions. Use múltiplos termos quando quiser cobrir conceitos vizinhos, nomes alternativos ou termos prováveis da referência da API.

Chamadas de busca utilizam as cotas por conta documentadas em Plans and limits.

aivax_list_models #

Lista modelos de chat integrados da AIVAX e devolve um resumo legível por modelo para cada correspondência. Use-a quando o assistente precisar escolher um modelo, explicar se um modelo está disponível no plano atual, comparar capacidades ou entender preços (veja Pricing).

A ferramenta aceita:

A resposta inclui a descrição de cada modelo, estabilidade, tipo, capacidades, sinalizadores e disponibilidade para o plano da conta autenticada. Para preços atuais, veja Pricing.

Exemplo de argumentos:

{
  "name_filter": "gemini flash"
}

Chamadas de listagem de modelos utilizam as cotas por conta documentadas em Plans and limits.

Quando usar #

Use o MCP de documentação quando quiser que um assistente responda perguntas da AIVAX a partir de contexto baseado em fonte ao invés de memória. Isso é útil em IDEs, ferramentas de suporte, agentes de integração, copilotos internos de implementação e fluxos de avaliação onde o assistente deve buscar no manual antes de recomendar uma rota, parâmetro, recurso, modelo ou passo de depuração.

Também é útil para fluxos de construção de agentes. Antes de criar ou editar um AI Gateway, um assistente pode buscar o recurso relevante, verificar capacidades de modelo e, em seguida, explicar qual configuração deve ser usada e por quê. Por exemplo, ele pode comparar ferramentas embutidas, funções MCP, funções do lado do servidor, workers, coleções RAG, respostas estruturadas e pré-processamento multimodal antes de sugerir um design.

Para solução de problemas, o MCP de documentação ajuda o assistente a passar de uma mensagem de erro para o provável limite do produto. Ele pode buscar regras de autenticação, limites de plano, requisitos de balanceamento multimodal, parâmetros de busca RAG, comportamento do gateway ou restrições de chave pública, e então gerar uma lista de verificação focada que reflita o comportamento da AIVAX.

Para seleção de modelo, combine aivax_search_documentation com aivax_list_models. Busque no manual o requisito de recurso, como chamada de ferramenta, entrada de vídeo, saída estruturada ou contexto longo, depois liste os modelos correspondentes e escolha um que esteja disponível no plano da conta.

Escolhendo termos de busca #

Bons termos de busca devem descrever o objetivo do usuário, não apenas uma palavra‑chave. Prefira:

public key chat completion restrictions
semantic search include references
AI Gateway MCP source headers
multimodal preprocess video

Em vez de:

key
search
headers
video

Quando o assistente não souber qual página contém a resposta, use search_type: "all". Quando precisar de nomes de rotas, corpos de requisição ou comportamento de endpoint, use api-function-reference. Quando precisar de orientações conceituais, trade‑offs ou explicações de fluxo de trabalho, use documentation-manual.

Orientação de segurança #

O MCP de documentação é mais seguro que uma ferramenta de gerenciamento porque é orientado à leitura, mas ainda autentica como uma conta AIVAX e pode expor disponibilidade de modelo sensível ao plano da conta. Conecte‑o apenas a clientes que devam conhecer os modelos disponíveis da conta e o contexto da documentação.

Use uma chave de API dedicada para cada cliente MCP. Armazene‑a no mecanismo de segredos do cliente ou em armazenamento de configuração local, nunca em controle de versão. Se um cliente precisar apenas de documentação pública e não precisar de disponibilidade de modelo específica da conta, prefira vincular diretamente ao site de documentação pública ao invés de conectar a um servidor MCP autenticado.