Poradniki · 9 min czytania · 22 listopada 2026

Jak połączyć prywatny serwer MCP z Cloud Run z Gemini Enterprise

Przejdź do treści i przykładów
Jak połączyć prywatny serwer MCP z Cloud Run z Gemini Enterprise

Dział bezpieczeństwa mówi: żadnego publicznego ruchu do serwera MCP. Włączasz więc internal ingress w Cloud Run, odpalasz test w Gemini Enterprise i dostajesz 404. Nic się nie zepsuło. Tak właśnie działa zamek, który sam zamontowałeś.

Google opublikowało na Developers Blog poradnik, jak to rozwiązać. Autorem jest Neeraj Agrawal, Forward Deployed Engineer w Google Cloud. Poniżej dostajesz ten sam przepis w wersji, którą da się czytać bez kawy numer cztery. Bez technobełkotu: wyjaśniam, co się dzieje na każdym etapie, żebyś mógł zlecić wdrożenie adminowi albo samodzielnie sprawdzić, czy zrobił je dobrze.

Serwer zamknięty przed internetem, ale dostępny dla jednej, wskazanej instancji Gemini Enterprise

Trzy problemy, które wyskoczą po zamknięciu serwera

MCP (Model Context Protocol) to sposób, w jaki agenci AI podłączają się do Twoich wewnętrznych API, baz danych i procesów. Cloud Run świetnie nadaje się na hostowanie lekkich serwerów MCP typu StreamableHTTP: skaluje się automatycznie, sam zarządza certyfikatami TLS i działa z Cloud IAM. Kłopoty zaczynają się przy przejściu z prototypu na produkcję.

  1. Brak publicznego internetu. Po włączeniu internal ingress domyślne publiczne wywołania z Gemini Enterprise są odrzucane na brzegu Google z kodem HTTP 404.
  2. Dwie tożsamości na każde wywołanie. Cloud Run IAM musi sprawdzić, że żądanie przyszło z Twojej instancji Gemini Enterprise. Kod serwera MCP musi dodatkowo zwalidować token OAuth 2.0 zalogowanego człowieka, zanim cokolwiek zrobi w jego imieniu.
  3. Kolizje DNS we wspólnej sieci. Duże firmy trzymają setki usług Cloud Run w jednej centralnej sieci Shared VPC. Nadpisanie całej domeny *.run.app w prywatnym Cloud DNS dla jednego serwera MCP może przejąć rozwiązywanie nazw i zepsuć routing pozostałych usług Cloud Run w tej sieci.

Ten trzeci punkt to klasyk: żeby wymienić żarówkę w jednym pokoju, wyłączasz prąd w całym budynku. Rozwiązanie z poradnika omija ten problem, bo ogranicza prywatny DNS do jednej, konkretnej nazwy.

Zanim zaczniesz

Kroki wykonuje osoba z dostępem administracyjnym do projektu Google Cloud. Jeśli to nie Ty, wydrukuj sobie listę poniżej i odhaczaj z adminem.

  • Działający serwer MCP w wariancie StreamableHTTP (gotowy przykład w Pythonie jest w repozytorium na GitHubie, link niżej).
  • Aplikacja w Gemini Enterprise, do której podłączysz serwer.
  • Regionalna podsieć VPC. Poradnik wymienia regiony us-central1 i europe-west1.
  • Poświadczenia klienta OAuth 2.0 (będą potrzebne przy rejestracji serwera w konsoli Gemini Enterprise).
  • Decyzja, której z dwóch opcji routingu użyjesz. Rozstrzyga ją jedno pytanie: czy Twoja sieć VPC nadal ma domyślną trasę 0.0.0.0/0 do bramy internetowej.

Koszty poszczególnych elementów (Agent Gateway, Private Service Connect, Cloud DNS) sprawdzisz w cenniku Google Cloud i dokumentacji produktów.

Darmowy webinar na żywo z Janem Gajosem · w najbliższą środę o 19:00

Czytasz o AI, a w pracy dalej robisz wszystko ręcznie? Znam to.

Sam tak robiłem. Na webinarze pokazuję na swoim ekranie, jak oddać AI powtarzalne zadania: maile, proste automatyzacje, asystenta do pracy. Bez programowania i bez teorii. 90 minut, a na końcu pytasz, o co chcesz.

Link do pokoju przyjdzie mailem. Zapisując się, zgadzasz się na wiadomości e-mail zgodnie z polityką prywatności. Wolisz zacząć od lektury? Zobacz e-booki Jana Gajosa

Jak wygląda prywatna droga: dwa mosty, jeden wpis DNS, dwa nagłówki

Gemini Enterprise działa w projekcie zarządzanym przez Google. Cloud Run jest bezserwerowy, więc nie ma w Twojej podsieci adresu IP, do którego dałoby się po prostu zadzwonić. Dlatego ruch przechodzi przez dwa mosty.

Most 1: wejście do Twojej sieci

Regionalny Egress Agent Gateway w trybie Agent-to-Anywhere łączy się z PSC Network Attachment w Twojej podsieci. W efekcie zarządzany interfejs sieciowy ląduje wewnątrz Twojego VPC, bez publicznych adresów IP i bez przychodzących reguł firewall.

Most 2: wejście z sieci do Cloud Run

Pakiet, który wpadł do podsieci, musi prywatnie dotrzeć do frontendu Cloud Run. Dzięki temu frontend rozpozna sieć źródłową i uzna, że wymóg internal ingress jest spełniony. Do wyboru są dwie opcje:

OpcjaAdresJak działaKiedy ją wybrać
A: Private Google Access w podsieci199.36.153.8/30Wbudowane wirtualne adresy IP Google, bez dodatkowych endpointów VPCStandardowe VPC, które zachowują domyślną trasę 0.0.0.0/0
B: globalny endpoint PSC dla Google APIs240.0.0.10Globalny wewnętrzny adres i reguła przekazywania do pakietu all-apis, bez wewnętrznego load balancera po stronie Cloud Run. Google automatycznie dodaje do VPC dedykowaną trasę /32Zablokowane VPC, w których trasę 0.0.0.0/0 usunięto

Prywatny DNS tylko dla jednej nazwy

Gdy Egress Agent Gateway dostaje wywołanie narzędzia, raz rozwiązuje nazwę hosta, zanim wpuści pakiet do Twojej sieci. Bez prywatnego Cloud DNS domeny .run.app wskazują na publiczne adresy IP. Kończy się to timeoutem i kodem 502, bo PSC Network Attachment nie wychodzi do publicznego internetu.

Nie twórz więc strefy z *.run.app. Utwórz prywatną strefę Cloud DNS dla dokładnej nazwy FQDN swojej usługi MCP i przekaż przez peering do bramy tylko tę domenę. Cloud DNS stosuje dopasowanie najdłuższego sufiksu, więc wszystkie pozostałe usługi Cloud Run w Shared VPC rozwiązują się normalnie. Brama łączy się po HTTPS z prywatnym adresem (199.36.153.8 lub 240.0.0.10), ale zachowuje nazwę hosta Twojej usługi w TLS SNI i nagłówku Host. Dzięki temu Cloud Run kieruje żądanie do właściwego kontenera.

Dwa mosty i jeden wpis DNS: tak prywatny ruch dociera do kontenera

Dwa nagłówki, dwie kontrole

Przy każdym żądaniu Gemini Enterprise wysyła dwa osobne nagłówki autoryzacji:

  • X-Serverless-Authorization (warstwa infrastruktury): podpisany przez Google token OIDC agenta usługi Gemini Enterprise z Twojego projektu. Cloud Run IAM weryfikuje go na brzegu względem roli Cloud Run Invoker i usuwa nagłówek, zanim żądanie trafi do kontenera.
  • Authorization: Bearer (warstwa aplikacji): token OAuth 2.0 zalogowanego użytkownika, przekazany bez zmian. Middleware w Twoim serwerze MCP sprawdza, kim jest wywołujący, i egzekwuje uprawnienia per użytkownik.

Praktyczny wniosek: Twój kod nigdy nie zobaczy nagłówka infrastrukturalnego. Za tożsamość człowieka odpowiada wyłącznie Twoje middleware, więc nie zakładaj, że "IAM już sprawdził". IAM sprawdził tylko, skąd przyszło żądanie.

Pięć kroków wdrożenia

Repozytorium towarzyszące poradnikowi automatyzuje całość skryptami i opisuje te same kroki w konsoli Cloud Console. Ścieżka wygląda tak:

KrokCo robiszCo masz na koniec
1Wdrażasz serwer w Cloud Run z internal-only ingress i uwierzytelnianiem IAM, nadajesz rolę Cloud Run Invoker agentowi usługi Gemini EnterpriseKontener, który wywoła tylko Twoja instancja Gemini Enterprise
2Włączasz Private Google Access w podsieci, tworzysz PSC Network Attachment i Egress Agent GatewayZarządzany interfejs sieciowy w Twoim VPC
3Tworzysz prywatną strefę DNS tylko dla nazwy hosta usługi i peering na bramieJedna nazwa wskazująca prywatny adres
4W konsoli Gemini Enterprise wiążesz bramę z aplikacją i rejestrujesz serwer MCPDziałający konektor w trybie Actions
5Odpalasz test i czytasz Cloud LoggingDowód, że ruch idzie prywatnie

Krok 1: zamknij Cloud Run i wskaż, kto może wywołać

  1. Wdróż serwer MCP StreamableHTTP w Cloud Run z ingress tylko wewnętrznym i włączonym uwierzytelnianiem IAM.
  2. Nadaj rolę Cloud Run Invoker agentowi usługi Gemini Enterprise ze swojego projektu. Dzięki temu kontener wywoła tylko Twoja instancja.

Krok 2: zbuduj most w sieci

  1. Włącz Private Google Access w regionalnej podsieci VPC.
  2. Utwórz PSC Network Attachment ustawiony na automatyczne akceptowanie połączeń.
  3. Utwórz zarządzany przez Google Egress Agent Gateway w trybie Agent-to-Anywhere.
  4. Nadaj uprawnienia sieciowe i do peeringu DNS automatycznie utworzonym kontom serwisowym bramy.
  5. Podłącz do bramy swój network attachment i zastosuj politykę autoryzacji ruchu wychodzącego.

Jeśli wybrałeś opcję B, skrypty dla globalnego endpointu PSC (240.0.0.10) znajdziesz w repozytorium razem z powiązaniami IAM dla Shared VPC.

Krok 3: zawęź DNS do jednej nazwy

  1. W Cloud DNS utwórz prywatną strefę zarządzaną, podłączoną do VPC, wyłącznie dla dokładnej nazwy hosta Twojej usługi Cloud Run.
  2. Ustaw rekord A na wirtualne adresy Private Google Access. W izolowanym VPC bez domyślnej trasy internetowej wskaż zamiast tego adres wewnętrznego endpointu PSC.
  3. Skonfiguruj na Agent Gateway peering DNS dla tej jednej nazwy.

Krok 4: powiąż bramę i zarejestruj serwer w Gemini Enterprise

  1. W konsoli Gemini Enterprise, w sekcji Security Configuration, powiąż Egress Agent Gateway ze swoją aplikacją.
  2. Zarejestruj data store typu Custom MCP Server: podaj endpoint Cloud Run i poświadczenia klienta OAuth 2.0.
  3. Na konektorze włącz egress przez Agent Gateway i tryb Actions.

Krok 5: sprawdź w logach, że ruch idzie prywatnie

  1. Przeładuj custom actions w konsoli.
  2. Uruchom testowy prompt w aplikacji webowej Gemini Enterprise, na przykład:
Użyj narzędzia z mojego serwera MCP i napisz, jakie narzędzia masz dostępne.
Następnie wywołaj jedno z nich z przykładowymi danymi.

Zmień treść pod swój serwer: wpisz nazwę narzędzia, które faktycznie wystawiłeś, i dane, które nie są wrażliwe.

  1. W Cloud Logging potwierdź, że inicjalizacja, discovery (wykrycie narzędzi) i wykonanie narzędzia przechodzą prywatnie przez Egress Agent Gateway do wewnętrznego kontenera, a obie kontrole, IAM usługi i OAuth 2.0 użytkownika, kończą się sukcesem.
Trzy zielone wpisy w logach: inicjalizacja, discovery i wykonanie narzędzia

Dwa kody błędów, które powiedzą Ci, gdzie szukać

ObjawNajbardziej prawdopodobna przyczyna według poradnikaGdzie zajrzeć
HTTP 404 z Cloud RunInternal ingress jest włączony, a wywołanie idzie domyślną, publiczną drogąKonektor: czy jest włączony egress przez Agent Gateway i czy brama jest powiązana z aplikacją
HTTP 502, timeoutNazwa .run.app rozwiązuje się do publicznego IP, bo brakuje prywatnej strefy DNS (PSC Network Attachment nie wychodzi do internetu)Strefa DNS dla dokładnej nazwy hosta i peering na bramie

Całość obejmuje dwie niezależne kontrole i prywatną trasę, więc rozsądnie jest przejść ją raz na środowisku testowym, zanim ktokolwiek dotknie produkcji. Jeśli budujesz w firmie więcej takich połączeń, przyda Ci się też artykuł o przygotowaniu infrastruktury IT firmy na AI, a dla większych organizacji bywa przydatny przewodnik o pilotażach AI w firmie przemysłowej. Jeśli porównujesz koszty rozwiązań enterprise, zajrzyj do tekstu o kosztach Claude Enterprise.

Gotowy serwer w Pythonie z middleware OAuth 2.0, Dockerfile i testami lokalnymi oraz skrypty dla obu opcji routingu znajdziesz w repozytorium na GitHubie. Dokumentację Google o konfiguracji własnego serwera MCP i łączności VPC dla Agent Gateway znajdziesz w dokumentacji Gemini Enterprise.

Na dziś wystarczy 10 minut: otwórz konsolę Google Cloud, wejdź w ustawienia swojej sieci VPC i sprawdź, czy w tabeli tras nadal jest domyślna trasa 0.0.0.0/0. Jeśli jest, bierz opcję A. Jeśli ją usunięto, zapisz, że przed Tobą opcja B z globalnym endpointem PSC. Ta jedna informacja ustawia cały dalszy plan.

Na podstawie: Google Developers Blog

Informacje o artykule

Darmowy webinar na żywo z Janem Gajosem · w najbliższą środę o 19:00

Czytasz o AI, a w pracy dalej robisz wszystko ręcznie? Znam to.

Sam tak robiłem. Na webinarze pokazuję na swoim ekranie, jak oddać AI powtarzalne zadania: maile, proste automatyzacje, asystenta do pracy. Bez programowania i bez teorii. 90 minut, a na końcu pytasz, o co chcesz.

Link do pokoju przyjdzie mailem. Zapisując się, zgadzasz się na wiadomości e-mail zgodnie z polityką prywatności. Wolisz zacząć od lektury? Zobacz e-booki Jana Gajosa

Udostępnij:
Nie przegap nowych artykułów - dodaj SukcesAI do swoich źródeł w wyszukiwarce Google.
Dodaj do preferowanych źródeł
Jan Gajos

Ekspert AI & Founder, AI Evolution

Pasjonat sztucznej inteligencji, który od 18 lat działa z sukcesem biznesowo i szkoleniowo. Wprowadzam AI do swoich firm oraz codziennego życia. Fascynują mnie nowe technologie, gry wideo i składanie klocków Lego - tam też widzę logikę i kreatywność, które AI potrafi wzmacniać. Wierzę, że dobrze użyta sztuczna inteligencja to nie ogłupiające ułatwienie, lecz prawdziwy przełom w sposobie, w jaki myślimy, tworzymy i pracujemy.

Newsletter SukcesAI

Raz w tygodniu najważniejsze nowości z AI i nowe poradniki z tego bloga.

Link do wypisania się jest w każdym mailu. Polityka prywatności