Conversão de APIs REST Legadas: O Fim do Middleware MCP com Google Cloud API Gateway

Conversão apis rest legadas é o processo de transformar endpoints tradicionais em ferramentas nativas do Model Context Protocol (MCP) diretamente na camada de gerenciamento de tráfego, permitindo que agentes de IA consumam dados corporativos sem atrito. A adoção de Engenharia Agêntica em grandes corporações frequentemente esbarra na complexidade arquitetural de conectar Modelos de Linguagem de Grande Escala (LLMs) aos sistemas transacionais já estabelecidos.

A abordagem convencional exige o desenvolvimento de um servidor MCP intermediário — um middleware cuja única função é traduzir as intenções do agente para chamadas que a infraestrutura compreenda. Essa topologia adiciona latência, duplica as regras de segurança e aumenta o custo de manutenção da plataforma. Segundo anúncio feito pelo Google em 24 de setembro de 2026, essa arquitetura fragmentada tornou-se obsoleta.

O Google Cloud API Gateway introduziu capacidades remotas de servidor MCP em fase de Public Preview. Essa atualização fornece um caminho expresso e seguro para gerenciar e expor serviços do Cloud Run diretamente para os agentes.

A Eliminação do Servidor Intermediário MCP

Para líderes de TI e arquitetos de nuvem, a principal vantagem técnica desta atualização é a drástica redução da complexidade na integração de agentes. Antes desta atualização, integrar um agente a um banco de dados legado significava implementar um serviço Node.js ou Python que se registrava como um servidor MCP, recebia as invocações via JSON-RPC, re-autenticava a requisição, executava a chamada REST e, em seguida, formatava a resposta de volta para o agente.

Essa abordagem é arriscada sob a ótica de segurança. Cada middleware introduzido na arquitetura é um novo vetor de ataque e um novo ponto de falha que deve ser monitorado, atualizado e escalado paralelamente ao tráfego do agente.

Com a capacidade de atuar nativamente como um servidor remoto MCP, o Google Cloud API Gateway intercepta essa necessidade. Os desenvolvedores agora podem expor suas operações REST já existentes como ferramentas MCP prontas para uso por agentes sem precisar construir, hospedar ou manter uma infraestrutura apartada.

Transcoding JSON-RPC e Preservação de Políticas de Segurança

A orquestração de ferramentas por agentes de IA exige protocolos rígidos de comunicação. O Model Context Protocol opera majoritariamente com payloads estruturados e chamadas remotas de procedimentos. A engenharia por trás do novo recurso foca em uma abstração elegante desse processo de comunicação.

De acordo com a especificação técnica liberada publicamente pelo Google, o API Gateway passa a aceitar requisições padrão MCP JSON-RPC centralizadas em um único endpoint. Quando um agente decide que precisa consultar uma base de dados ou disparar um fluxo de trabalho, ele envia a instrução tools/call.

O gateway recebe essa instrução e realiza a transcodificação (transcoding) automática da solicitação JSON-RPC para o formato da requisição REST correspondente no backend corporativo. Após a execução, ele também traduz a resposta REST de volta para a semântica MCP.

O grande diferencial arquitetural aqui reside na governança: esse processo ocorre mantendo todas as políticas de segurança existentes completamente inalteradas.

Esta garantia de não regressão na segurança é fundamental para adoções em larga escala, abordagens que discutimos aprofundadamente em nossas análises sobre a fundação de implantações enterprise de agentes. Quando o CTO sabe que o LLM não conseguirá burlar cotas de uso do banco de dados e será barrado caso o token JWT expire, a adoção ganha tração executiva imediata.

Implementação e Requisitos OpenAPI

Transformar um legado corporativo de endpoints REST em ferramentas disponíveis não é automático sem a aderência a padrões rígidos de documentação de APIs. A infraestrutura de nuvem exige contratos formais claros para conseguir mapear os parâmetros do MCP para os parâmetros HTTP (Path, Query, Body).

Para que o servidor MCP interno do gateway seja habilitado, existe um pré-requisito estrito em relação à documentação técnica: a especificação precisa estar obrigatoriamente no formato OpenAPI 3.0.x ou 3.1.x.

Versões anteriores, como o OpenAPI 2.0 (anteriormente conhecido como Swagger), não são suportadas nativamente por esse recurso de roteamento. Empresas que possuem legados operando sob a versão 2.0 deverão executar a migração técnica de suas especificações para a versão 3.0.x ou superior antes de tentar expor as ferramentas.

O Fluxo de Anotação (Opt-in)

O controle granular sobre o que é ou não exposto aos agentes é feito via anotações diretas no arquivo de especificação OpenAPI (YAML ou JSON), eliminando configurações em painéis visuais fragmentados. Este modelo de infraestrutura como código (IaC) favorece esteiras de CI/CD.

# Exemplo conceitual de estrutura de anotação na especificação OpenAPI 3.0.x
openapi: 3.0.3
info:
  title: API Corporativa de Clientes
  version: 1.0.0
x-google-api-management.mcp: true # Opt-in global
paths:
  /clientes/{id}:
    get:
      summary: Retorna dados do cliente
      description: Busca os detalhes completos de um cliente específico pelo ID. # Obrigatório não ser vazio
      x-google-mcp-tool: true # Exposição da operação
      x-google-backend:
        address: https://backend-service.internal

Descoberta Automatizada: O Papel do API Hub e Agent Registry

A criação técnica das ferramentas é apenas a primeira metade do desafio. Em grandes corporações, saber quais ferramentas existem, quais estão depreciadas e quais devem ser utilizadas para determinados fluxos de dados é um problema de governança (discoverability).

O ecossistema do Google Cloud endereça isso integrando o processo ao API Hub. Ao conectar o gateway de APIs a este hub, o servidor MCP configurado é automaticamente publicado com seus metadados específicos da camada MCP.

Uma vez publicado, esse servidor e suas respectivas ferramentas de back-end passam a figurar no Agent Registry. Isso significa que as ferramentas corporativas tornam-se instantaneamente descobríveis por agentes de IA e também pelos desenvolvedores que os orquestram.

Esse nível de automação da governança elimina a fricção presente na arquitetura legada, onde os times de dados precisavam documentar manualmente os endpoints MCP em repositórios internos e fornecer o host do middleware aos times que gerenciam os LLMs. Para organizações que já aproveitam estratégias de aplicativos conectados no workspace, expandir essa capacidade de autodescoberta para suas APIs proprietárias é a evolução natural do orquestramento.

Semelhante ao que é executado em integrações mais complexas com processos assíncronos e estratégias com webhooks, centralizar as rotas e seus contratos diretamente no gateway remove pontos de opacidade na arquitetura corporativa.

Perspectivas Finais para Engenharia de Nuvem

A conversão de APIs REST legadas por meio de gerenciadores de API com suporte nativo ao Model Context Protocol redefine o trabalho de equipes de infraestrutura.

O modelo imposto pelo Public Preview do Google Cloud API Gateway prova que o futuro dos agentes corporativos não se apoiará na criação de mais silos de aplicação (como os middlewares Node.js isolados), mas sim na adaptação da borda da rede (o gateway) para entender as requisições geradas pelas Inteligências Artificiais.

A responsabilidade volta a repousar nos contratos de API. Uma especificação OpenAPI rigorosa, devidamente anotada e suportando políticas nativas de JWT, torna-se o verdadeiro ativo de longo prazo. O tráfego de agentes passa a ser tratado apenas como mais um consumidor B2B da infraestrutura pré-existente da empresa, mantendo custos de infraestrutura adicionais próximos a zero e uma conformidade de segurança hermética.

Perguntas Frequentes

O que é necessário para habilitar o servidor MCP no Google Cloud API Gateway? É necessário possuir uma especificação OpenAPI 3.0.x ou 3.1.x devidamente configurada. Versões em OpenAPI 2.0 não são suportadas e devem obrigatoriamente ser migradas para as versões mais recentes antes da exposição.

Como as regras de autenticação e cotas são tratadas durante a conversão MCP? O API Gateway executa o transcoding mantendo as políticas originais de autenticação baseada em JWT ou API Keys. Além disso, as cotas de consumo e as regras de logs de acesso permanecem ativas e inalteradas perante as requisições do agente.

De que maneira os agentes e desenvolvedores conseguem descobrir essas novas ferramentas? Quando o API Gateway está conectado ao API Hub, o servidor MCP é publicado automaticamente, enviando seus metadados para o Agent Registry. Isso torna o inventário de ferramentas instantaneamente descobrível e pronto para ser orquestrado.

Fontes:

• Turn your REST APIs into MCP tools with Google Cloud API Gateway - Google Developers Blog (24 de setembro de 2026)