Conversor de OpenAPI para MCP

De um documento OpenAPI a um servidor MCP que funciona

Cole acima um documento OpenAPI (ou Swagger) em JSON e o conversor mapeia cada operação para uma ferramenta MCP: a operação vira o nome da ferramenta, o resumo vira a descrição que o modelo lê, e os parâmetros de caminho, query e corpo são achatados em um único esquema JSON de entrada. Você recebe as definições de ferramentas separadamente e um servidor FastMCP em Python construído em volta delas, pronto para rodar assim que você acrescentar a autenticação.

Toda a conversão acontece no seu navegador. Nenhuma requisição é feita, nada é enviado e nada é armazenado — o que importa, porque um documento OpenAPI muitas vezes descreve uma API interna que não tem por que ir parar no servidor de outra pessoa. Você pode conferir isso na aba de rede do navegador.

O erro que quase todo mundo comete primeiro

Converter a API inteira é o movimento óbvio e quase sempre o errado. As definições de ferramentas de um servidor MCP são enviadas ao modelo a cada turno, então oitenta endpoints viram oitenta descrições e oitenta esquemas na janela de contexto de toda requisição — e a capacidade do modelo de escolher a certa cai bastante conforme essa lista cresce.

Comece pelo punhado de operações de que um agente realmente precisa. Acrescente mais só quando algo se revelar ausente. Dá para medir exatamente quanto custa uma lista de ferramentas com a calculadora de tokens MCP.

O que o código gerado faz e o que não faz

• Autenticação não está incluída. O esqueleto chama a sua API sem credenciais; ligar o cabeçalho, o token ou o fluxo OAuth é com você.
• Parâmetros de caminho são marcadores. Eles são interpolados no caminho da requisição, mas confira se cada um substitui o argumento que você espera.
• Corpos de requisição atrás de um $ref saem como objeto genérico em vez de expandidos, porque resolvê-los exige a seção components. Isso fica indicado na saída em vez de sumir silenciosamente.
• Somente JSON. Um parser de YAML não pode ser carregado aqui sem um script de terceiros, e este site não carrega nenhum. Exporte a especificação como JSON antes — a maioria das ferramentas faz isso em um comando.

Ferramentas e guias relacionados

• Transformar uma API REST em servidor MCP — o guia completo, incluindo autenticação e publicação.
• MCP Inspector — depois de publicado, confirme que ele expõe o que você espera.
• Scanner de segurança MCP — uma API convertida costuma herdar parâmetros que merecem um segundo olhar.
• Proteger um servidor MCP

Um servidor gerado é um ponto de partida, não uma demonstração

Que ele rode prova que o mapeamento funcionou. Isso não ajuda mais ninguém a entender para que serve o servidor — e um cliente avaliando a sua integração MCP não sabe ler um arquivo Python. Publique-o, aponte o MCP Showcase para a URL e você terá um playground ao vivo com documentação gerada por ferramenta, onde um cliente em potencial experimenta a coisa no navegador em vez de ter que acreditar em você.