Google używa technologii AI do tłumaczenia treści na Twój preferowany język. Tłumaczenia wygenerowane przez AI mogą zawierać błędy.

Połącz się z serwerem MCP Developer Knowledge

Serwer MCP Google Developer Knowledge zapewnia narzędziom dla programistów opartym na AI bezpośredni dostęp do wyszukiwania i pobierania oficjalnej dokumentacji dla deweloperów Google dotyczącej produktów takich jak Firebase, Google Cloud, Android czy Google Maps Platform. Połączenie asystenta wspomagania kodowania z autorytatywną biblioteką dokumentacji Google pozwala uniknąć ręcznego wyszukiwania w internecie, nieaktualnego kontekstu i scrapingu.

Aby połączyć się z serwerem MCP Developer Knowledge z własnej aplikacji lub kodu agenta zamiast z IDE, zapoznaj się z sekcją Łączenie za pomocą pakietów SDK MCP.

Możliwości serwera MCP

Serwer MCP Google Developer Knowledge udostępnia Twojemu asystentowi wspomagania kodowania opartego na AI 3 podstawowe narzędzia:

Nazwa narzędzia	Opis
`search_documents`	Przeszukuje dokumentację Google dla deweloperów i zwraca najbardziej trafne fragmenty stron wraz z nazwami dokumentów.
`get_documents`	Pobiera pełną treść dokumentów w formacie Markdown, używając nazw zwróconych przez `search_documents`.
`answer_query`	Generuje ustrukturyzowane odpowiedzi na podstawie zasobów wiedzy dla deweloperów.

Narzędzie search_documents przeszukuje dokumentację Google, aby znaleźć najbardziej trafne sekcje pasujące do Twojego zapytania. Gdy zadajesz pytanie, narzędzie zwraca krótkie fragmenty tekstu. Jeśli agent potrzebuje pełnego kontekstu strony otaczającego fragment, może przekazać nazwę zasobu dokumentu do get_documents, aby pobrać całą stronę.

Użyj narzędzia answer_query, gdy chcesz uzyskać bezpośrednią odpowiedź na pytanie z bazy wiedzy dla deweloperów, a nie nieprzetworzone wyniki wyszukiwania lub pełne pliki Markdown.

Wybieranie metody uwierzytelniania

Serwer MCP Developer Knowledge obsługuje 2 metody uwierzytelniania w zależności od środowiska programistycznego i asystenta AI:

Klucz interfejsu API: najlepszy w przypadku środowisk IDE innych firm i agentów CLI, takich jak Claude Code, Cursor, GitHub Copilot, Codex i innych zdalnych klientów MCP. Przekaż klucz interfejsu API w nagłówku X-Goog-Api-Key za pomocą protokołu HTTPS.
OAuth i ADC: najlepsze rozwiązanie w przypadku Google Antigravity, które ma wbudowaną obsługę domyślnego uwierzytelniania aplikacji (ADC), lub w przypadku procesów w firmach, które zamiast klucza interfejsu API wymagają tokena okaziciela OAuth 2.0 lub samodzielnego identyfikatora klienta OAuth 2.0.

Wygeneruj dane logowania wymagane przez wybraną metodę uwierzytelniania, aby umożliwić asystentowi AI lub agentowi kodowania uwierzytelnianie żądań za pomocą usługi serwera MCP Developer Knowledge.

Wybierz kartę, aby utworzyć dane logowania:

Klucz interfejsu API

Wymagania wstępne

Zanim utworzysz klucz interfejsu API, upewnij się, że masz:

Projekt Google Cloud.
Zainstalowany interfejs wiersza poleceń gcloud (jeśli konfigurujesz z wiersza poleceń).

Włączanie interfejsu API i tworzenie klucza interfejsu API

Klucz interfejsu API możesz wygenerować za pomocą konsoli Google Cloud lub gcloud CLI:

Google Cloud Console

W konsoli Google Cloud otwórz stronę Developer Knowledge API.
Wybierz projekt w chmurze Google Cloud i kliknij Włącz.
Otwórz stronę Dane logowania.
Kliknij Utwórz dane logowania i wybierz Klucz interfejsu API.
Aby skonfigurować ograniczenia, kliknij Edytuj klucz interfejsu API:
- W sekcji Ograniczenia interfejsów API wybierz Ogranicz klucz.
- Wybierz Developer Knowledge API.
- Jeśli planujesz używać tego samego klucza do wywołań modelu (takich jak GEMINI_API_KEY), wybierz też Generative Language API.
Kliknij Zapisz, a następnie skopiuj klucz interfejsu API.

interfejs wiersza poleceń gcloud

Włącz w projekcie interfejs Developer Knowledge API, zastępując PROJECT_ID identyfikatorem projektu:
```
gcloud services enable developerknowledge.googleapis.com \
  --project=PROJECT_ID
```
Utwórz klucz interfejsu API:
```
gcloud services api-keys create \
  --project=PROJECT_ID \
  --display-name="DK API Key"
```
To polecenie zwraca szczegółowe metadane dotyczące nowego klucza. Skopiuj i zapisz obie te wartości z wyniku polecenia:
- keyString: to jest nieprzetworzony klucz interfejsu API (na przykład AIzaSy...). Wkleisz tę wartość do konfiguracji IDE.
- name: to ścieżka do zasobu klucza (np. projects/PROJECT_ID/locations/global/keys/UNIQUE_ID). Użyjesz jej w następnym kroku, aby ograniczyć klucz.
Ogranicz klucz do interfejsu Developer Knowledge API, aby zapobiec nieautoryzowanemu użyciu. Zastąp KEY_NAME pełną ścieżką name skopiowaną w poprzednim kroku:
```
gcloud services api-keys update KEY_NAME \
  --api-target=service=developerknowledge.googleapis.com
```
Ważne: jeśli planujesz używać tego samego klucza do wywołań ogólnych modeli klienta AI (np. GEMINI_API_KEY), musisz też zezwolić na interfejs Generative Language API:
```
gcloud services api-keys update KEY_NAME \
  --api-target=service=developerknowledge.googleapis.com \
  --api-target=service=generativelanguage.googleapis.com
```

OAuth i ADC

Wymagania wstępne

Zanim skonfigurujesz protokół OAuth lub ADC, upewnij się, że masz:

Włącz API

Aby włączyć w projekcie interfejs Developer Knowledge API, uruchom to polecenie:

gcloud services enable developerknowledge.googleapis.com \
  --project=PROJECT_ID

Wybierz typ danych logowania OAuth

Wybierz metodę uwierzytelniania wymaganą przez narzędzie:

ADC

Usługa Google Antigravity ma wbudowaną obsługę ADC i automatycznie odświeża tokeny odświeżania. Inni klienci MCP mogą używać ADC, przekazując krótkotrwały token okaziciela w nagłówku Authorization:

Uwierzytelnij się za pomocą konta Google i ustaw projekt z limitami:

gcloud auth application-default login \
  --project=PROJECT_ID

Gdy otworzy się przeglądarka, zaloguj się na konto Google i przyznaj wymagane uprawnienia.
(Opcjonalnie) Jeśli konfigurujesz klienta MCP innej firmy, który nie ma wbudowanej obsługi ADC, wygeneruj token okaziciela (ważny przez godzinę), który będzie używany w nagłówku Authorization klienta:
```
gcloud auth application-default print-access-token
```

Identyfikator klienta OAuth

Jeśli Twój asystent AI korzysta z interaktywnego przepływu OAuth, utwórz identyfikator klienta OAuth 2.0 i klucz tajny, ponieważ zdalne serwery MCP Google nie obsługują dynamicznej rejestracji klientów (DCR) OAuth.

Otwórz stronę Marka i wybierz projekt. Wpisz nazwę aplikacji i adres e-mail dla użytkowników potrzebujących pomocy, a następnie kliknij Zapisz.
Otwórz stronę Odbiorcy i ustaw Typ użytkownika na Zewnętrzny.
Na tej samej stronie kliknij Dodaj użytkowników w sekcji Użytkownicy testowi, wpisz swój adres e-mail Google i kliknij Zapisz.
Otwórz stronę Klienci, kliknij Utwórz klienta i wybierz typ aplikacji wymagany przez klienta MCP:
- Wybierz Aplikacja komputerowa w przypadku klientów na komputery, którzy proszą o podanie identyfikatora klienta i tajnego klucza (np. VS Code).
- Wybierz Aplikacja internetowa i dodaj identyfikator URI przekierowania klienta w przypadku klientów, którzy wymagają statycznych wywołań zwrotnych przekierowania OAuth (takich jak łączniki niestandardowe Cursor lub Claude Code). Użyj dokładnego identyfikatora URI przekierowania, który jest podany w dokumentacji klienta. Niestandardowe identyfikatory URI przekierowania nie są obsługiwane. W przypadku identyfikatorów URI przekierowania specyficznych dla klienta zapoznaj się z artykułem Konfigurowanie MCP w aplikacji AI.
Kliknij Utwórz, a następnie skopiuj Identyfikator klienta i Tajny klucz klienta (lub pobierz plik JSON z danymi logowania klienta).

zakresów protokołu OAuth

Serwer MCP Developer Knowledge akceptuje te zakresy OAuth:

https://www.googleapis.com/auth/cloud-platform: domyślny zakres używany przez domyślne uwierzytelnianie aplikacji (ADC) i gcloud CLI.
https://www.googleapis.com/auth/devprofiles.full_control: zakres używany w przepływach zgody na identyfikator klienta OAuth 2.0 i do wykrywania serwerów MCP.
https://www.googleapis.com/auth/developerprofiles.readonly: zakres tylko do odczytu obsługiwany w przypadku kont usługi i danych logowania, które nie wymagają ekranu zgody OAuth użytkownika.

Konfigurowanie środowiska IDE lub agenta kodowania

Po uzyskaniu danych logowania postępuj zgodnie z instrukcjami konfiguracji środowiska kodowania. Instrukcje dla poszczególnych środowisk programistycznych obsługują te metody uwierzytelniania:

Środowisko kodowania	Metody uwierzytelniania
Google Antigravity	Wbudowane dane logowania Google (ADC) lub klucz interfejsu API
Claude Code, Cursor, GitHub Copilot, Codex	Klucz interfejsu API
Inne	Klucz interfejsu API, token okaziciela ADC lub identyfikator klienta OAuth 2.0

Aby używać tokena okaziciela ADC lub identyfikatora klienta OAuth 2.0 z Claude Code, Cursor, GitHub Copilot lub Codex, postępuj zgodnie z instrukcjami na karcie Inne.

W zależności od używanego szablonu zastąp te obiekty zastępcze:

API key (YOUR_API_KEY): zastąp ciągiem klucza interfejsu API.
Project ID (PROJECT_ID): zastąp identyfikatorem projektu Google Cloud.
Token dostępu (ACCESS_TOKEN): zastąp tokenem okaziciela z gcloud auth application-default print-access-token.

Google Antigravity

Antigravity IDE i rozszerzenia

Aby skonfigurować serwer MCP w środowisku IDE Antigravity lub rozszerzeniu Antigravity (np. w VS Code), wybierz metodę uwierzytelniania:

Dane logowania Google

Aby zainstalować serwer MCP za pomocą konfiguracji jednym kliknięciem:

W panelu agenta kliknij menu Dodatkowe opcje () i wybierz Serwery MCP.
Wyszukaj Google Developer Knowledge.
Kliknij ikonę Zainstaluj (). Antigravity automatycznie konfiguruje serwer i łączy się z nim za pomocą aktywnych danych logowania Google.

Klucz interfejsu API

Aby skonfigurować klucz interfejsu API w środowisku IDE Antigravity lub rozszerzeniu Antigravity:

W panelu agenta kliknij menu Opcje dodatkowe () > Serwery MCP > Zarządzaj serwerami MCP > Wyświetl nieprzetworzoną konfigurację (lub otwórz .agents/mcp_config.json).

Dodaj tę konfigurację serwera:

{
  "mcpServers": {
    "google-developer-knowledge": {
      "serverUrl": "https://developerknowledge.googleapis.com/mcp",
      "headers": {
        "X-Goog-Api-Key": "YOUR_API_KEY"
      }
    }
  }
}

Antigravity CLI

Skonfiguruj serwer MCP w pliku .agents/mcp_config.json projektu (lub globalnie w ~/.gemini/config/mcp_config.json):

Dane logowania Google

{
  "mcpServers": {
    "google-developer-knowledge": {
      "httpUrl": "https://developerknowledge.googleapis.com/mcp",
      "authProviderType": "google_credentials",
      "oauth": {
        "scopes": [
          "https://www.googleapis.com/auth/cloud-platform"
        ]
      },
      "timeout": 30000,
      "headers": {
        "X-goog-user-project": "PROJECT_ID"
      }
    }
  }
}

Klucz interfejsu API

{
  "mcpServers": {
    "google-developer-knowledge": {
      "serverUrl": "https://developerknowledge.googleapis.com/mcp",
      "headers": {
        "X-Goog-Api-Key": "YOUR_API_KEY"
      }
    }
  }
}

Claude Code

Uruchom w terminalu to polecenie:

claude mcp add google-developer-knowledge \
  --transport http https://developerknowledge.googleapis.com/mcp \
  --header "X-Goog-Api-Key: YOUR_API_KEY"

Kursor

Aby skonfigurować Cursor, zmień .cursor/mcp.json w katalogu głównym projektu lub ~/.cursor/mcp.json, aby uzyskać dostęp globalny:

{
  "mcpServers": {
    "google-developer-knowledge": {
      "url": "https://developerknowledge.googleapis.com/mcp",
      "headers": {
        "X-Goog-Api-Key": "YOUR_API_KEY"
      }
    }
  }
}

GitHub Copilot

Ustawienia obszaru roboczego

Aby skonfigurować GitHub Copilot w VS Code dla konkretnego obszaru roboczego, utwórz lub zmodyfikuj .vscode/mcp.json:

{
  "servers": {
    "google-developer-knowledge": {
      "url": "https://developerknowledge.googleapis.com/mcp",
      "headers": {
        "X-Goog-Api-Key": "YOUR_API_KEY"
      }
    }
  }
}

Globalne ustawienia użytkownika

Aby serwer był dostępny we wszystkich obszarach roboczych VS Code, otwórz paletę poleceń, uruchom MCP: Open User Configuration i dodaj do pliku mcp.json w profilu użytkownika te wiersze:

{
  "servers": {
    "google-developer-knowledge": {
      "url": "https://developerknowledge.googleapis.com/mcp",
      "headers": {
        "X-Goog-Api-Key": "YOUR_API_KEY"
      }
    }
  }
}

Codex

Aby skonfigurować interfejs wiersza poleceń Codex lub agenta Codex, dodaj konfigurację serwera do pliku ~/.codex/config.toml (lub do pliku .codex/config.toml w projekcie):

[mcp_servers.google-developer-knowledge]
  url = "https://developerknowledge.googleapis.com/mcp"
  http_headers = { "X-Goog-Api-Key" = "YOUR_API_KEY" }

Inne

Aby skonfigurować dowolnego innego klienta MCP (np. JetBrains AI Assistant, Windsurf, Cline, Zed, Continue lub Claude Desktop) albo użyć tokena dostępu ADC lub identyfikatora klienta OAuth 2.0 w kliencie innej firmy, wybierz metodę uwierzytelniania:

Klucz interfejsu API

Skonfiguruj serwer transportu HTTP, używając tych ustawień:

URL serwera: https://developerknowledge.googleapis.com/mcp
HTTP Header (Nagłówek HTTP): X-Goog-Api-Key: YOUR_API_KEY

Standardowy szablon konfiguracji JSON:

{
  "mcpServers": {
    "google-developer-knowledge": {
      "url": "https://developerknowledge.googleapis.com/mcp",
      "headers": {
        "X-Goog-Api-Key": "YOUR_API_KEY"
      }
    }
  }
}

Token okaziciela ADC

Jeśli klient MCP nie ma wbudowanej obsługi ADC, możesz uwierzytelnić się za pomocą ADC, przekazując token dostępu z gcloud auth application-default print-access-token i identyfikator projektu Google Cloud w nagłówkach żądania:

{
  "mcpServers": {
    "google-developer-knowledge": {
      "url": "https://developerknowledge.googleapis.com/mcp",
      "headers": {
        "Authorization": "Bearer ACCESS_TOKEN",
        "X-Goog-User-Project": "PROJECT_ID"
      }
    }
  }
}

Nagłówek X-Goog-User-Project wymaga uprawnienia serviceusage.services.use w projekcie. Właściciele projektów i edytujący mają to uprawnienie. Inni użytkownicy potrzebują roli, która ją obejmuje, np. konsument Wykorzystania usług (roles/serviceusage.serviceUsageConsumer).

Identyfikator klienta OAuth

Aby uwierzytelnić się za pomocą samodzielnego identyfikatora klienta OAuth 2.0 i obiektu tajnego:

Dodaj punkt końcowy serwera MCP do konfiguracji klienta bez nagłówka klucza interfejsu API:
```
{
  "mcpServers": {
    "google-developer-knowledge": {
      "url": "https://developerknowledge.googleapis.com/mcp"
    }
  }
}
```
Uwaga: VS Code używa klucza najwyższego poziomu servers zamiast mcpServers. Dodaj serwer do pliku .vscode/mcp.json w folderze, który otworzysz jako obszar roboczy, lub uruchom MCP: Open User Configuration (MCP: otwórz konfigurację użytkownika) z palety poleceń, aby był dostępny we wszystkich obszarach roboczych. Strukturę plików VS Code znajdziesz na karcie GitHub Copilot. Pomiń sekcję headers.
Dokończ konfigurację protokołu OAuth dla klienta:
- Interaktywny prompt (np. VS Code): wyślij do agenta prompt testowy. Gdy pojawi się komunikat, że dynamiczna rejestracja klienta nie jest obsługiwana, przejdź dalej i wpisz Identyfikator klienta oraz Klucz tajny klienta, a następnie zaloguj się na konto Google.
- Statyczna konfiguracja OAuth (np. Cursor lub Claude Code): podaj identyfikator klienta OAuth, tajny klucz klienta i identyfikator URI przekierowania w ustawieniach OAuth klienta. Instrukcje dotyczące konkretnych klientów znajdziesz w artykule Konfigurowanie MCP w aplikacji AI.
Jeśli klient poprosi Cię o określenie zakresów protokołu OAuth, użyj https://www.googleapis.com/auth/devprofiles.full_control.

W tej konfiguracji nie musisz podawać identyfikatora projektu Google Cloud. Żądania są przypisywane do projektu, który jest właścicielem Twojego identyfikatora klienta OAuth.

Weryfikowanie połączenia

Po skonfigurowaniu zrestartuj asystenta AI lub ponownie załaduj jego serwery MCP. Następnie wyślij prompta testowego, aby sprawdzić, czy integracja narzędzia działa:

How do I list Cloud Storage buckets using the Google Cloud Python SDK?

Jeśli agent wywoła search_documents lub answer_query i zwróci informacje z dokumentacji Google, Twój serwer jest połączony i aktywny.

Korzystanie z umiejętności agenta Developer Knowledge

Zainstaluj oficjalną umiejętność agenta retrieving-developer-knowledge, aby nauczyć asystenta, kiedy i jak używać podstawowych narzędzi oferowanych przez serwer MCP Developer Knowledge.

Umiejętność agenta to zestaw instrukcji, które asystent wspomagania kodowania oparty na AI odczytuje przed rozpoczęciem zadania. retrieving-developer-knowledge umiejętność działa z każdym asystentem, który obsługuje otwarty standard umiejętności agenta i pomaga mu w tych czynnościach:

Wybierz odpowiednie narzędzie: instruuje asystenta, aby używał answer_query w przypadku ogólnych pytań typu „jak to zrobić” i porównań oraz search_documents (z 2–5 słowami kluczowymi) podczas wyszukiwania konkretnych flag CLI, uprawnień lub składni kodu.
Sprawdzanie błędów przed udzieleniem odpowiedzi: ta opcja nakazuje asystentowi upewnić się, że wyszukiwanie w dokumentacji zakończyło się powodzeniem, zanim napisze odpowiedź. Dzięki temu nie pomyli on błędu klucza interfejsu API lub limitu z brakującą dokumentacją ani nie będzie zgadywać na podstawie starszych danych treningowych.
Przełączanie się na interfejs API typu REST: udostępnia asystentowi polecenia curl, które umożliwiają bezpośrednie wywoływanie interfejsu Developer Knowledge API, jeśli edytor nie obsługuje serwerów MCP lub połączenie MCP się nie powiedzie.

Instalowanie umiejętności agenta

Wybierz asystenta wspomagania kodowania, aby zainstalować retrieving-developer-knowledge umiejętność w katalogu projektu:

Google Antigravity

npx skills add google/skills --skill retrieving-developer-knowledge \
  --agent=antigravity

Claude Code

npx skills add google/skills --skill retrieving-developer-knowledge \
  --agent=claude-code

Kursor

npx skills add google/skills --skill retrieving-developer-knowledge \
  --agent=cursor

Codex

npx skills add google/skills --skill retrieving-developer-knowledge \
  --agent=codex

Inne

W przypadku innych asystentów AI obsługujących otwarty standard umiejętności agenta uruchom:

npx skills add google/skills --skill retrieving-developer-knowledge

Aby zaktualizować zainstalowane umiejętności do najnowszej wersji, uruchom:

npx skills update

Aby wyświetlić pełne instrukcje i przewodniki, zapoznaj się z katalogiem retrieving-developer-knowledge na GitHubie.

Optymalizacja okna kontekstu i wykorzystania tokenów

Pobieranie pełnych stron dokumentacji do okna kontekstu modelu AI zużywa znaczną liczbę tokenów. Pozyskiwanie wielu dużych dokumentów może spowodować wysokie koszty tokenów, zwiększone opóźnienie i przepełnienie okna kontekstu.

Aby zapewnić szybkie i ekonomiczne odpowiedzi, postępuj zgodnie z tymi sprawdzonymi metodami inżynierii promptów:

Zainstaluj umiejętność agenta (zalecane): zainstaluj umiejętność agenta retrieving-developer-knowledge, aby asystent automatycznie wybierał odpowiednie narzędzie wyszukiwania (answer_query lub search_documents), używał krótkich wyszukiwań słów kluczowych i pobierał pełne strony tylko wtedy, gdy jest to konieczne.
Polegaj na dwuetapowym pobieraniu: pozwól agentowi rozpocząć od wywołania search_documents. Zwraca to wybrane fragmenty (bloki), które często zawierają dokładną składnię lub sygnaturę interfejsu API, których potrzebujesz, bez zużywania tokenów na całą stronę. Poinstruuj agenta, aby wywoływał get_documents tylko wtedy, gdy kontekst otoczenia jest absolutnie niezbędny.
Preferuj answer_query w przypadku pytań koncepcyjnych: gdy potrzebujesz wygenerowanego wyjaśnienia lub porównania projektów, poproś agenta o użycie answer_query. To narzędzie generuje odpowiedź bezpośrednio z korpusu wiedzy dla deweloperów, nie zwracając pełnych stron w formacie Markdown.
Pisz konkretne, zawężone prompty: unikaj zbyt ogólnych promptów, takich jak „Wyjaśnij wszystko o Firebase”. Zamiast tego określ docelową usługę, platformę i język:
```
How do I write a Firestore transaction in Dart with error handling?
```
Dodaj niestandardowe reguły agenta: jeśli nie używasz umiejętności retrieving-developer-knowledge, dodaj wytyczne na poziomie projektu do plików instrukcji asystenta (np. .cursorrules, CLAUDE.md lub .github/copilot-instructions.md), aby ograniczyć automatyczne pobieranie całej strony:
```
When searching Google developer documentation, inspect search_documents
snippets first. Do not call get_documents unless the snippet lacks
necessary code context.
```

Opcjonalne konfiguracje zabezpieczeń i bezpieczeństwa

MCP wprowadza nowe zagrożenia dla bezpieczeństwa i kwestie, które należy wziąć pod uwagę ze względu na szeroki zakres działań, jakie można wykonywać za pomocą narzędzi MCP. Aby zminimalizować te zagrożenia i nimi zarządzać, Google Cloud oferuje ustawienia domyślne i możliwe do dostosowania zasady, które pozwalają kontrolować korzystanie z narzędzi MCP w organizacji lub projekcie Google Cloud.

Więcej informacji o bezpieczeństwie i zarządzaniu MCP znajdziesz w artykule Bezpieczeństwo i ochrona AI.

Korzystanie z Model Armor

Model Armor to usługa Google Cloud, która zwiększa bezpieczeństwo aplikacji AI. Działa ona przez proaktywne sprawdzanie promptów i odpowiedzi LLM, chroniąc przed różnymi zagrożeniami i wspierając odpowiedzialne działania w zakresie AI. Niezależnie od tego, czy wdrażasz AI w środowisku chmury, czy u zewnętrznych dostawców usług w chmurze, Model Armor może pomóc Ci zapobiegać złośliwym danym wejściowym, weryfikować bezpieczeństwo treści, chronić dane wrażliwe, zachowywać zgodność z przepisami oraz konsekwentnie egzekwować zasady bezpieczeństwa AI w różnorodnym środowisku AI.

Gdy Model Armor jest włączony z włączonym logowaniem, rejestruje cały ładunek. Może to spowodować ujawnienie informacji poufnych w logach.

Kierowanie żądań MCP do Model Armor

Model Armor jest dostępny w niektórych regionach. Gdy Model Armor jest włączony i używasz serwera MCP w jurysdykcji, która nie jest obsługiwana przez Model Armor, zachowanie routingu wywołania może się różnić w zależności od serwera MCP i może naruszać zgodność z przepisami dotyczącymi miejsca przechowywania danych w przypadku danych używanych i przesyłanych. Więcej informacji o działaniu poszczególnych serwerów MCP znajdziesz w artykule o usługach obsługujących Model Armor.

Włącz Model Armor

Aby włączyć Model Armor, wykonaj czynności opisane w artykule Integracja z serwerami MCP Google i Google Cloud.

Konfigurowanie ochrony zdalnych serwerów MCP

Aby chronić wywołania i odpowiedzi narzędzia MCP, możesz użyć ustawień progu Model Armor. Ustawienie progu określa minimalne filtry zabezpieczeń, które mają zastosowanie w całym projekcie. Ta konfiguracja stosuje spójny zestaw filtrów do wszystkich wywołań i odpowiedzi narzędzi MCP w projekcie.

Skonfiguruj ustawienie progu Model Armor z włączonym oczyszczaniem danych MCP. Więcej informacji znajdziesz w artykule Konfigurowanie ustawień progu Model Armor.

Oto przykładowe polecenie:

gcloud model-armor floorsettings update \
--full-uri='projects/PROJECT_ID/locations/global/floorSetting' \
--enable-floor-setting-enforcement=TRUE \
--add-integrated-services=GOOGLE_MCP_SERVER \
--google-mcp-server-enforcement-type=INSPECT_AND_BLOCK \
--enable-google-mcp-server-cloud-logging \
--malicious-uri-filter-settings-enforcement=ENABLED \
--add-rai-settings-filters='[{"confidenceLevel": "MEDIUM_AND_ABOVE", "filterType": "DANGEROUS"}]'

Zastąp PROJECT_ID identyfikatorem projektu Google Cloud.

Zwróć uwagę na te ustawienia:

INSPECT_AND_BLOCK: typ egzekwowania, który sprawdza treści na serwerze MCP Google i blokuje prompty oraz odpowiedzi pasujące do filtrów.
ENABLED: ustawienie, które włącza filtr lub egzekwowanie.
MEDIUM_AND_ABOVE: poziom ufności dla ustawień filtra odpowiedzialnej AI – niebezpieczne. Możesz zmodyfikować to ustawienie, ale niższe wartości mogą powodować więcej wyników fałszywie pozytywnych. Więcej informacji znajdziesz w artykule Poziomy ufności Model Armor.

Wyłączanie skanowania ruchu MCP za pomocą Model Armor

Aby uniemożliwić usłudze Model Armor automatyczne skanowanie ruchu do i z serwerów MCP Google na podstawie ustawień progów projektu, uruchom to polecenie:

gcloud model-armor floorsettings update \
  --full-uri='projects/PROJECT_ID/locations/global/floorSetting' \
  --remove-integrated-services=GOOGLE_MCP_SERVER

Zastąp PROJECT_ID identyfikatorem projektu Google Cloud. Model Armor nie stosuje automatycznie reguł zdefiniowanych w ustawieniach progu tego projektu do ruchu na serwerach MCP Google.

Ustawienia progu i ogólna konfiguracja Model Armor mogą mieć wpływ nie tylko na MCP. Model Armor integruje się z usługami takimi jak Vertex AI, więc wszelkie zmiany wprowadzone w ustawieniach progu mogą wpłynąć na skanowanie ruchu i zachowania związane z bezpieczeństwem we wszystkich zintegrowanych usługach, nie tylko w MCP.

Dostosowywanie ustawień Model Armor

Jeśli używasz Model Armor do ochrony aplikacji, w przypadku niektórych zapytań mogą wystąpić błędy 403 PERMISSION_DENIED. Serwer MCP Developer Knowledge zwraca tylko publiczną dokumentację z zaufanych źródeł Google, dlatego zalecamy ustawienie filtrów wstrzykiwania promptów i jailbreaku (PIJB) na poziom ufności HIGH_AND_ABOVE, aby zmniejszyć liczbę fałszywych alarmów. Jeśli Twój przypadek użycia nie obejmuje innych narzędzi, które mają dostęp do danych prywatnych lub poufnych, możesz też wyłączyć filtry PIJB.

Rozwiązywanie problemów

Jeśli napotkasz problemy z połączeniem z serwerem MCP Developer Knowledge lub wysyłaniem do niego zapytań, znajdź objaw lub komunikat o błędzie w poniższych tabelach.

Błędy konfiguracji i połączenia

Objaw lub błąd	Prawdopodobna przyczyna	Rozdzielczość
`404 NOT_FOUND` na `/mcp` punkcie końcowym	Interfejs API nie jest włączony w Twoim projekcie.	Włącz Developer Knowledge API w konsoli Google Cloud lub uruchom `gcloud services enable developerknowledge.googleapis.com`.
`403 PERMISSION_DENIED`: `Developer Knowledge API has not been used`	Interfejs Developer Knowledge API nie jest włączony w projekcie Google Cloud.	Włącz interfejs API w konsoli Google Cloud lub uruchom polecenie`gcloud services enable developerknowledge.googleapis.com`.
Brak narzędzi MCP lub nieudane połączenie	Narzędzie do kodowania nie obsługuje zdalnych serwerów HTTP MCP lub nie może się z nimi połączyć.	Zainstaluj `retrieving-developer-knowledge`umiejętność agenta, która informuje asystenta, jak w przypadku niedostępności narzędzi MCP używać punktów końcowych interfejsu API REST `curl` Developer Knowledge.

Błędy klucza interfejsu API

Objaw lub błąd	Prawdopodobna przyczyna	Rozdzielczość
`400 Bad Request: API key not valid`	Ciąg znaków klucza interfejsu API jest nieprawidłowy, błędnie sformatowany lub nie ma go w żądaniu.	Sprawdź, czy klucz interfejsu API został prawidłowo skopiowany i skonfigurowany w obiekcie `headers` z kluczem `X-Goog-Api-Key`. Nie przekazuj klucza interfejsu API jako parametru zapytania w adresie URL.
`403 PERMISSION_DENIED: API target restriction`	Lista ograniczeń klucza interfejsu API nie obejmuje interfejsu Developer Knowledge API.	Zaktualizuj ograniczenia klucza interfejsu API na stronie Dane logowania w konsoli Google Cloud, aby uwzględnić interfejs Developer Knowledge API.

Błędy OAuth i ADC

Objaw lub błąd	Prawdopodobna przyczyna	Rozdzielczość
`401 UNAUTHENTICATED` lub brakujące dane logowania ADC	Domyślne uwierzytelnianie aplikacji lub tokeny na okaziciela ADC wygasły lub nie zostały zainicjowane.	Uruchom `gcloud auth application-default login --project=PROJECT_ID`, aby odświeżyć lokalne dane uwierzytelniające, lub `gcloud auth application-default print-access-token`, aby wygenerować nowy token okaziciela.
`403 PERMISSION_DENIED`: `API requires a quota project, which is not set by default`	Żądanie używa tokena okaziciela ADC bez nagłówka `X-Goog-User-Project`.	Dodaj nagłówek `X-Goog-User-Project` z identyfikatorem projektu Google Cloud do konfiguracji klienta MCP.
`403 PERMISSION_DENIED` z nagłówkiem `X-Goog-User-Project`	Twoje konto nie ma uprawnień `serviceusage.services.use` w projekcie w nagłówku.	Poproś administratora projektu o przypisanie Ci roli konsumenta Wykorzystania usług (`roles/serviceusage.serviceUsageConsumer`).
`403 access_denied` / „Dostęp zablokowany: błąd autoryzacji”	Ekran zgody OAuth używa typu użytkownika Zewnętrzny w trybie testowym, a Twoje konto nie jest wymienione jako użytkownik testowy.	W konsoli Google Cloud > Platforma uwierzytelniania > Odbiorcy dodaj aktywny adres e-mail Google w sekcji Użytkownicy testowi.
Błąd klienta OAuth lub nieprawidłowy identyfikator URI przekierowania	Klient OAuth został utworzony z nieobsługiwanym typem aplikacji lub brakującym identyfikatorem URI przekierowania.	W przypadku klientów z interaktywnymi promptami (np. VS Code) użyj opcji Aplikacja komputerowa, a w przypadku klientów z autoryzowanym identyfikatorem URI przekierowania (np. Cursor lub Claude Code) użyj opcji Aplikacja internetowa.

Błędy dotyczące limitów i filtrów bezpieczeństwa

Objaw lub błąd	Prawdopodobna przyczyna	Rozdzielczość
`429 RESOURCE_EXHAUSTED`	Osiągnięto limit projektu.	Wykorzystanie możesz sprawdzić na stronie limitów Developer Knowledge API w konsoli Google Cloud. Aby dowiedzieć się więcej o limitach i poprosić o ich zwiększenie, zapoznaj się z artykułem Limit Developer Knowledge API.
`403 PERMISSION_DENIED` z Model Armor	Fałszywie pozytywny wynik filtra PIJB usługi Model Armor zablokował bezpieczne zapytanie.	W ustawieniach szablonu Model Armor ustaw poziom ufności filtra PIJB na `HIGH_AND_ABOVE`.

Dołączona dokumentacja

Pełną listę usług Google i repozytoriów dokumentacji indeksowanych przez serwer znajdziesz w dokumentacji korpusu.

Znane ograniczenia

Tylko dokumentacja publiczna: serwer indeksuje tylko publicznie dostępną dokumentację wymienioną w odniesieniu do korpusu. Nie obejmuje to dokumentów wewnętrznych, prywatnych repozytoriów ani zasobów innych firm.
Język angielski: serwer indeksuje i zwraca dokumentację tylko w języku angielskim.
Zależność sieciowa i Ustawienia usługi VPC: ponieważ serwer MCP Developer Knowledge jest usługą hostowaną zdalnie, klient musi mieć połączenie sieciowe, aby uzyskać dostęp do https://developerknowledge.googleapis.com.
- W sieciach VPC Google Cloud: ruch wychodzący do publicznego internetu nie jest wymagany. Możesz uzyskać dostęp do developerknowledge.googleapis.com prywatnie bez zewnętrznych adresów IP lub Cloud NAT, kierując ruch za pomocą prywatnego dostępu do Google (private.googleapis.com / 199.36.153.8/30) lub punktu końcowego Private Service Connect (PSC) kierowanego na pakiet all-apis.
- Ustawienia usługi VPC (VPC-SC): developerknowledge.googleapis.com nie jest obsługiwana w przypadku punktów końcowych Restricted VIP (restricted.googleapis.com / 199.36.153.4/30) ani PSC vpc-sc. Jeśli Twoja sieć VPC kieruje ruch z *.googleapis.com do restricted.googleapis.com, skonfiguruj konkretną zasadę odpowiedzi Cloud DNS lub prywatny rekord DNS dla developerknowledge.googleapis.com, aby rozwiązywać nazwy do private.googleapis.com (199.36.153.8/30).

Połącz się z serwerem MCP Developer Knowledge Zadbaj o dobrą organizację dzięki kolekcji Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.

Możliwości serwera MCP

Wybieranie metody uwierzytelniania

Klucz interfejsu API

Wymagania wstępne

Włączanie interfejsu API i tworzenie klucza interfejsu API

Google Cloud Console

interfejs wiersza poleceń gcloud

OAuth i ADC

Wymagania wstępne

Włącz API

Wybierz typ danych logowania OAuth

ADC

Identyfikator klienta OAuth

zakresów protokołu OAuth

Konfigurowanie środowiska IDE lub agenta kodowania

Google Antigravity

Antigravity IDE i rozszerzenia

Dane logowania Google

Klucz interfejsu API

Antigravity CLI

Dane logowania Google

Klucz interfejsu API

Claude Code

Kursor

GitHub Copilot

Ustawienia obszaru roboczego

Globalne ustawienia użytkownika

Codex

Inne

Klucz interfejsu API

Token okaziciela ADC

Identyfikator klienta OAuth

Weryfikowanie połączenia

Korzystanie z umiejętności agenta Developer Knowledge

Instalowanie umiejętności agenta

Google Antigravity

Claude Code

Kursor

Codex

Inne

Optymalizacja okna kontekstu i wykorzystania tokenów

Opcjonalne konfiguracje zabezpieczeń i bezpieczeństwa

Korzystanie z Model Armor

Kierowanie żądań MCP do Model Armor

Włącz Model Armor

Konfigurowanie ochrony zdalnych serwerów MCP

Wyłączanie skanowania ruchu MCP za pomocą Model Armor

Dostosowywanie ustawień Model Armor

Rozwiązywanie problemów

Błędy konfiguracji i połączenia

Błędy klucza interfejsu API

Błędy OAuth i ADC

Błędy dotyczące limitów i filtrów bezpieczeństwa

Dołączona dokumentacja

Znane ograniczenia

Połącz się z serwerem MCP Developer Knowledge