A Google Cloud API Gateway REST API-kat alakít MCP-eszközökké

A Google Cloud API Gateway mostantól MCP-szerverként is használható Public Previewban. A fejlesztők meglévő OpenAPI-leírásuk kiegészítésével agentek számára elérhető MCP-eszközökké tehetik REST-műveleteiket, külön MCP-szerver építése és üzemeltetése nélkül.
- Az API Gateway Public Previewban távoli MCP-szerverként működik.
- A meglévő REST-műveletek OpenAPI 3.x-leírásból tehetők MCP-eszközökké.
- A hitelesítés, a kvóták és a naplózás a REST-tel közös szabályzati útvonalon maradnak.
- A tools/list alapértelmezés szerint nyilvános, éles környezetben JWT használata szükséges.
- Egy gateway legfeljebb 1000 eszközt szolgál ki, az MCP és a model routing nem használható közös konfigurációban.
Egy közös útvonalon működhet az MCP és a REST
A Google Developers Blog szeptember 24-i bejelentése szerint az API Gateway egyetlen végponton fogadja a szabványos MCP JSON-RPC-kéréseket. A tools/call hívásokat a megfelelő REST-kérésekké alakítja, alkalmazza a már beállított szabályokat, majd az API válaszát MCP-eredményként adja vissza.
A Google szerint az így létrehozott kérés a háttérrendszer számára megkülönböztethetetlen a hagyományos REST-hívástól. Emiatt az adott művelethez beállított JWT- vagy API-kulcsos hitelesítés, kvóta és naplózás változatlanul érvényes marad. Az MCP- és REST-forgalom ugyanazon szabályzati útvonalon halad, egy művelet pedig ugyanabból a kvótakeretből fogyaszt, függetlenül attól, hogyan hívták meg.
OpenAPI-bővítéssel tehetők elérhetővé a műveletek
A használathoz OpenAPI 3.0.x vagy 3.1.x specifikáció szükséges. Az OpenAPI 2.0 nem támogatott, ezért az ilyen leírást előbb át kell állítani egy támogatott verzióra. A teljes dokumentum szintjén az x-google-api-management.mcp beállítással lehet engedélyezni az MCP-t, az egyes műveletek pedig az x-google-mcp-tool beállítással szabhatók testre vagy hagyhatók ki.
Minden közzétett műveletnek háttérrendszerrel és nem üres leírással kell rendelkeznie. A Google kiemeli, hogy az eszköz leírása az egyik legfontosabb jelzés az LLM számára annak eldöntéséhez, mikor hívja meg az adott funkciót. Ezért a leírásnak azt is meg kell mutatnia, milyen helyzetben és milyen célra használható az eszköz.
A gateway-konfiguráció szokásos telepítése után az API Gateway MCP-kompatibilis konfigurációt hoz létre, és az /mcp alapútvonalon kezdi kiszolgálni a kéréseket. További infrastruktúrát ehhez nem kell létrehozni.
A felfedezés és a hozzáférés külön kezelhető
Alapértelmezés szerint a tools/list hitelesítés nélkül érhető el. Ez fejlesztés közben kényelmes lehet, ugyanakkor bárki megismerheti az eszközök nevét és bemeneti sémáját, aki lekérdezi őket. Éles környezetben a Google JWT használatát javasolja a felfedezés védelmére. Ezt a metódust API-kulccsal nem lehet biztosítani.
A tools/call minden esetben megköveteli az alapul szolgáló REST-művelethez beállított hitelesítést, függetlenül attól, hogy a tools/list védett-e. Az API Gateway végpontját bármely MCP-klienshez hozzá lehet kapcsolni. A Google példája szerint az Agent Development Kitben egy MCP-eszközkészlet és a gateway által elvárt hitelesítő adat használható.
A Public Preview jelenlegi korlátai
A gateway az API Hubhoz csatlakoztatva MCP-specifikus metaadatokkal publikálhatja a szervert, amely így automatikusan megjelenik az Agent Registryben. A Public Preview REST- és OpenAPI 3.x-alapú háttérrendszereket támogat a jelenlegi hitelesítéssel.
A Google közlése szerint az MCP-erőforrások, a promptok, a válaszok folyamatos továbbítása és a Model Armor payloadvizsgálata még az ütemtervben szerepel. Az üres törzset visszaadó műveletek, például a HTTP 204-es válaszok, nem jelennek meg. A mélyen egymásba ágyazott objektumsémák nem feltétlenül jelennek meg teljesen a tools/list eredményében, egy gateway pedig legfeljebb 1000 eszközt szolgálhat ki. Emellett az MCP és a model routing nem engedélyezhető ugyanabban az API-konfigurációban.
A támogatás már elérhető Public Previewban, így a fejlesztők a dokumentáció alapján meglévő API-jukat agentek számára használható eszközzé alakíthatják.
Google for Developers: Turn your REST APIs into MCP tools with Google Cloud API Gateway- Google Developers Blog


