Importar um documento OpenAPI como um conjunto de ferramentas
Analisa um documento OpenAPI 3.0 ou 3.1 (JSON ou YAML, enviado no corpo; ele nunca é obtido de uma URL) e armazena suas operações compatíveis como ferramentas que um agente pode chamar. Operações que não podem ser chamadas com fidelidade são listadas em skipped_operations; selecionar uma delas em operations rejeita a importação. Credenciais nunca fazem parte do documento: faça referência a um servidor de cofre de credenciais registrado para a URL base da API.
Autorizações
Gateway auth: send Authorization: Bearer <mka1-api-key>. For multi-user server-side integrations, you can also send X-On-Behalf-Of: <external-user-id>.
Cabeçalhos
Optional external end-user identifier forwarded by the API gateway.
Corpo
O documento OpenAPI 3.0 ou 3.1, como um objeto ou como texto JSON ou YAML (no máximo 4 MiB).
1Rótulo para o conjunto de ferramentas. O padrão é um slug do info.title do documento.
^[a-zA-Z0-9_-]{1,64}$A URL base pública da API. Por padrão, é o primeiro servidor do documento, com as variáveis definidas para seus valores padrão.
2048operationIds a importar. O padrão é cada operação suportada (no máximo 128).
1 - 128 elements1 - 64Servidor do cofre de credenciais, registrado para a URL base da API, cuja credencial autentica todas as chamadas.
Credencial de mcp_server_id a ser usada. Por padrão, a credencial ativa mais recente do servidor no momento da execução.
Resposta
Conjunto de ferramentas OpenAPI
agent.openapi_tool_set O info.title do documento.
O info.version do documento.
A definição de ferramenta normalizada enviada por uma execução do agente. Ela contém referências de credenciais, nunca os valores das credenciais.
Operações do documento que não foram importadas e o motivo.
O que os esquemas de segurança do documento esperam que a credencial do cofre envie.