Arquitetura
O OpenAPI (Swagger) descreve uma API para desenvolvedores. O MCP descreve ferramentas para um modelo. São camadas, não rivais, e a escolha aparece na descoberta, na segurança e nas tarefas longas.
6 de nov. de 2026 · 6 min de leitura
O diagrama e as fontes estão em inglês.
A maioria das empresas já tem APIs, documentadas em OpenAPI, a especificação por trás do Swagger. A pergunta para um projeto de agentes é se devemos ligar o agente a essas APIs à mão ou colocar um servidor MCP na frente delas. A resposta honesta é que não é uma coisa ou outra: um servidor MCP, muitas vezes, envolve a mesma API REST.
A especificação OpenAPI descreve APIs HTTP: caminhos, parâmetros, corpos de requisição e de resposta. A versão 3.1 define o seu Schema Object como um superconjunto do JSON Schema draft 2020-12. O seu leitor é um desenvolvedor ou um gerador de código, em tempo de construção.
O Model Context Protocol foi feito para outro leitor: o modelo, em tempo de execução. As mensagens são JSON-RPC. Um cliente envia uma requisição tools/list para descobrir as ferramentas que um servidor oferece, e o servidor deve responder com o conjunto disponível naquele momento para aquele cliente. Um servidor também pode avisar o cliente de que a sua lista de ferramentas mudou.
Nenhum dos desenhos dá segurança de graça. A especificação do MCP diz que, por confiança e segurança, sempre deveria haver uma pessoa no circuito com a capacidade de negar as invocações de ferramentas, e a sua autorização HTTP se baseia em OAuth 2.1. Escopos, limites, aprovações e auditoria ainda precisam ser construídos, e devem ficar fora do modelo.
Uma tarefa que leva minutos não deve manter uma conexão aberta. O 202 Accepted do HTTP significa que a requisição foi aceita para processamento, mas o processamento ainda não terminou. Devolva-o com um identificador de trabalho, deixe o cliente consultar e descreva os eventos por trás, por exemplo com AsyncAPI. A segunda aba acima mostra esse fluxo.
Conte para a gente sobre um processo. Mostramos como um agente poderia resolvê-lo e o que medir para saber que está funcionando.