Połącz się z serwerem MCP Developer Knowledge

Podgląd

Ten produkt podlega „Warunkom oferty przed GA” z sekcji Ogólne warunki korzystania z usługi w Szczegółowych warunkach korzystania z usługi. Usługi w wersji przed GA są dostępne w stanie „takim, jaki jest” i mogą mieć ograniczone wsparcie. Więcej informacji znajdziesz w opisach etapu uruchamiania.

Serwer Google Developer Knowledge MCP umożliwia narzędziom deweloperskim opartym na AI wyszukiwanie oficjalnej dokumentacji Google dla deweloperów i pobieranie informacji o usługach Google, takich jak Firebase, Google Cloud, Android, Mapy i inne. Połączenie aplikacji AI bezpośrednio z naszą oficjalną biblioteką dokumentacji zapewnia, że otrzymywany kod i wskazówki są aktualne i oparte na wiarygodnych informacjach.

Po skonfigurowaniu serwera zintegrowane narzędzia mogą pomagać w obsłudze takich żądań jak:

• Wskazówki dotyczące implementacji

  • Na przykład: Jaki jest najlepszy sposób na wdrożenie powiadomień push w aplikacji na Androida za pomocą Komunikacji w chmurze Firebase?

• Generowanie i wyjaśnianie kodu

  • Na przykład: Wyszukaj w dokumentacji Google przykład w Pythonie, który wyświetla wszystkie zasobniki w projekcie Cloud Storage.

• Rozwiązywanie problemów i debugowanie

  • Przykład: Dlaczego w przypadku mojego klucza interfejsu API Map Google wyświetla się znak wodny „Tylko na potrzeby programowania”?

• Analiza porównawcza i podsumowanie

  • Przykład: Pomóż mi wybrać między Cloud Run a Cloud Functions na potrzeby nowej mikrousługi. Utwórz tabelę w języku Markdown, która porównuje kluczowe aspekty, takie jak podstawowy przypadek użycia, współbieżność i model cenowy.

Możliwości serwera MCP

Serwer MCP Google Developer Knowledge udostępnia aplikacji opartej na AI te narzędzia:

Nazwa narzędzia	Opis
search_documents	Przeszukuje dokumentację Google dla deweloperów (Firebase, Google Cloud, Android, Mapy i inne usługi), aby znaleźć odpowiednie strony i fragmenty kodu dla Twojego zapytania. Użyj get_documents z parent z wyników wyszukiwania, aby uzyskać pełną treść strony.
get_documents	Pobiera pełną treść wielu dokumentów za pomocą parent z search_documents wyników.

Narzędzie search_documents dzieli dokumentację na mniejsze fragmenty tekstu, które są zoptymalizowane pod kątem wyszukiwania i pobierania z wykorzystaniem AI. Gdy wyszukujesz, narzędzie zwraca co najmniej 1 fragment dokumentu, który jest powiązany z Twoim zapytaniem. Jeśli chcesz wyświetlić pełną treść strony, która otacza fragment, użyj get_documents z parametrem parent podanym w wynikach wyszukiwania, aby pobrać pełną treść strony.

Instalacja

Serwer MCP Google Developer Knowledge to zdalny serwer MCP, który używa interfejsu Developer Knowledge API do wyszukiwania i pobierania dokumentacji. Uwierzytelnianie może się odbywać z wykorzystaniem OAuth lub klucza API.

Uwaga: nie wszystkie aplikacje AI są zgodne z każdą metodą uwierzytelniania. Jeśli w sekcji konfiguracji nie widzisz preferowanej aplikacji, spróbuj użyć innej obsługiwanej metody uwierzytelniania.

Uwierzytelnianie przy użyciu OAuth

W tej sekcji znajdziesz instrukcje uwierzytelniania aplikacji AI na serwerze MCP Developer Knowledge za pomocą OAuth.

Wymaganie wstępne: skonfiguruj Google Cloud CLI

Zanim przejdziesz dalej, upewnij się, że masz:

• projekt Google Cloud,
• Lokalna instalacja gcloud CLI

Krok 1. Włączanie interfejsu Developer Knowledge API w projekcie

1. Otwórz stronę interfejsu Developer Knowledge API w bibliotece interfejsów API Google.
2. Sprawdź, czy masz wybrany odpowiedni projekt, w którym zamierzasz używać interfejsu API.
3. Kliknij Włącz. Do włączenia i korzystania z interfejsu API nie są wymagane żadne konkretne role uprawnień.

Krok 2. Wybierz metodę uwierzytelniania

Wybrana metoda uwierzytelniania zależy od tego, czy Twój asystent AI obsługuje domyślne uwierzytelnianie aplikacji (ADC) za pomocą gcloud CLI, czy wymaga osobnego identyfikatora klienta OAuth. Asystenci tacy jak interfejs wiersza poleceń Gemini mogą używać Twoich dotychczasowych danych logowania w Google Cloud, co ułatwia konfigurację. Inni, np. Antigravity, wymagają ręcznego utworzenia i podania własnych danych logowania w celu nawiązania bezpiecznego połączenia.

Wybierz kartę odpowiadającą wymaganiom dotyczącym konfiguracji konkretnego asystenta AI.

ADC

Połącz swoje konto

1. Aby przyznać serwerowi MCP uprawnienia do działania w Twoim imieniu, uruchom to polecenie, zastępując PROJECT_ID identyfikatorem projektu Google Cloud:

   gcloud auth application-default login
   --project=PROJECT_ID
   

2. Gdy pojawi się prośba, wybierz konto, a następnie kliknij Dalej.

Konfigurowanie aplikacji AI

Po uwierzytelnieniu ostatnim krokiem jest podanie aplikacji AI szczegółów konfiguracji serwera. Dokładna struktura JSON różni się w zależności od aplikacji, ale możesz użyć poniższego przykładu jako szablonu.

1. Aby skonfigurować interfejs wiersza poleceń Gemini lub Gemini Code Assist, edytuj lub utwórz jeden z tych plików konfiguracyjnych:

   • W projekcie: .gemini/settings.json
   • W katalogu głównym: ~/.gemini/settings.json

   {
     "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"
         }
       }
     }
   }
   

   Aby sprawdzić, czy serwer MCP działa zgodnie z oczekiwaniami, przejdź do sekcji weryfikacja instalacji.

Dane logowania wpisywane ręcznie

Konfigurowanie ekranu zgody OAuth

Skonfiguruj ekran zgody OAuth w projekcie i dodaj siebie jako użytkownika testowego. Jeśli ten krok został już wykonany w przypadku Twojego projektu Google Cloud, przejdź do następnego kroku.

1. Otwórz stronę przeglądu uwierzytelniania w konsoli Google Cloud i kliknij Rozpocznij.
2. Wpisz nazwę aplikacji, wybierz adres e-mail pomocy i kliknij Dalej.
3. W sekcji Odbiorcy wybierz Zewnętrzny i kliknij Dalej.
4. Wpisz adres e-mail w sekcji Dane kontaktowe i kliknij Dalej.
5. Zapoznaj się z zasadami dotyczącymi danych użytkownika w usługach interfejsu API Google i zaakceptuj je, a potem kliknij Dalej.
6. Kliknij Utwórz.

Dodawanie użytkowników testowych

1. Na platformie Google Auth kliknij Odbiorcy.
2. W sekcji Użytkownicy testowi kliknij Dodaj użytkowników.
3. Wpisz swój adres e-mail i adresy e-mail innych autoryzowanych testerów, a potem kliknij Zapisz.

Tworzenie klienta OAuth

Aby uwierzytelnić się jako użytkownik i uzyskać dostęp do danych użytkownika w aplikacji, musisz utworzyć identyfikatory klienta OAuth 2.0. Identyfikator klienta wskazuje konkretną aplikację na serwerach OAuth Google.

1. Na platformie Google Auth kliknij Klienci.
2. Kliknij Utwórz klienta.
3. W selektorze Typ aplikacji wybierz Aplikacja na komputer.
4. W polu Nazwa wpisz nazwę danych logowania. Ta nazwa jest wyświetlana tylko w konsoli Google Cloud.
5. Kliknij Utwórz. Wyświetli się ekran utworzonego klienta OAuth z nowym identyfikatorem klienta i tajnym kluczem klienta.
6. Kliknij OK. Nowo utworzone dane logowania pojawią się w sekcji Identyfikatory klientów OAuth 2.0.
7. Kliknij nowo utworzony identyfikator klienta. W sekcji Tajne klucze klienta kliknij ikonę pobierania, aby zapisać plik JSON. Wartości client_id i client_secret z tego pliku wykorzystasz w kolejnym kroku.

Konfigurowanie aplikacji AI

Następnie musisz podać aplikacji AI szczegóły konfiguracji serwera. Dokładna kolejność czynności różni się w zależności od aplikacji, ale możesz użyć poniższego przykładu jako szablonu.

Aby skonfigurować Antigravity do korzystania z serwera MCP:

1. W Antigravity kliknij menu Opcje dodatkowe w panelu Agent > Serwery MCP > Zarządzaj serwerami MCP.

2. U góry otwartego panelu Zarządzaj serwerami MCP kliknij Wyświetl surową konfigurację, aby edytować plik mcp_config.json:

   {
     "mcpServers": {
       "google-developer-knowledge": {
         "serverUrl": "https://developerknowledge.googleapis.com/mcp"
       }
     }
   }
   

3. Wróć do sekcji Zarządzaj serwerami MCP i kliknij Odśwież.

Dodawanie danych logowania OAuth

Gdy po raz pierwszy spróbujesz użyć serwera MCP Developer Knowledge, asystent AI poprosi Cię o dokończenie konfiguracji:

1. Poproś agenta o użycie serwera MCP Developer Knowledge za pomocą prompta, np.:

   How do I list Cloud Storage buckets?
   

2. Jeśli zobaczysz komunikat z prośbą o zarejestrowanie co najmniej jednego identyfikatora URI przekierowania, kliknij opcję, aby kontynuować. Identyfikator klienta został skonfigurowany jako aplikacja na komputer, więc nie musisz dodawać tych konkretnych identyfikatorów URI na platformie Google Auth.

3. Gdy asystent AI poprosi Cię o podanie identyfikatora klienta i tajnego klucza klienta, wklej odpowiednie klucze z zapisanego wcześniej pliku JSON z tajnym kluczem klienta.

4. Gdy pojawi się prośba, wybierz konto, a następnie kliknij Dalej.

5. Wróć do asystenta AI. Agent przetworzy teraz Twoją prośbę za pomocą nowo uwierzytelnionego serwera.

Uwierzytelnianie za pomocą klucza interfejsu API

W tej sekcji znajdziesz instrukcje uwierzytelniania aplikacji AI na serwerze MCP Developer Knowledge za pomocą klucza interfejsu API.

Krok 1. Utwórz klucz interfejsu API

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

Google Cloud Console

Włącz API

1. Otwórz stronę interfejsu Developer Knowledge API w bibliotece interfejsów API Google.
2. Sprawdź, czy masz wybrany odpowiedni projekt, w którym zamierzasz używać interfejsu API.
3. Kliknij Włącz. Do włączenia i korzystania z interfejsu API nie są wymagane żadne konkretne role uprawnień.

Tworzenie i zabezpieczanie klucza interfejsu API

1. W konsoli Google Cloud w projekcie, w którym został włączony interfejs API, otwórz stronę Dane logowania.
2. Kliknij Utwórz dane logowania, a potem w menu wybierz Klucz interfejsu API. W oknie Utworzono klucz API wyświetli się ciąg znaków nowo utworzonego klucza.
3. Kliknij Edytuj klucz API.
4. W polu Nazwa podaj nazwę klucza.
5. W sekcji Ograniczenia interfejsów API kliknij Ogranicz klucz.
6. Na liście Wybierz interfejsy API włącz Developer Knowledge API i kliknij OK.
   • Uwaga: jeśli interfejs Developer Knowledge API został dopiero włączony, może minąć trochę czasu, zanim pojawi się na liście Wybierz interfejsy API.
7. Kliknij Zapisz.

Po utworzeniu klucza kliknij Pokaż klucz, aby go wyświetlić. Zapisz go, aby użyć go podczas konfigurowania aplikacji AI.

interfejs wiersza poleceń gcloud

1. Jeśli jeszcze tego nie zrobisz, pobierz i zainstaluj gcloud CLI.

2. Włącz Developer Knowledge API, zastępując PROJECT_ID identyfikatorem projektu w chmurze Google Cloud:

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

3. Utwórz klucz interfejsu API, używając tego samego identyfikatora projektu Google Cloud:

   gcloud services api-keys create --project=PROJECT_ID --display-name="DK API Key"
   

   To polecenie zwraca ciąg znaków klucza interfejsu API. Zapisz go, aby użyć go podczas konfigurowania aplikacji AI.

4. Zabezpiecz klucz interfejsu API, dodając ograniczenia. Aby zwiększyć bezpieczeństwo, ogranicz klucz interfejsu API do interfejsu Developer Knowledge API.

Uwaga: wykorzystanie limitu przydziału prywatnego interfejsu API możesz wyświetlić i nim zarządzać, otwierając stronę Uprawnienia i administracja > Limity przydziału i limity systemowe w konsoli Google Cloud, wybierając Usługa, a następnie Developer Knowledge API w polu filtra.

Krok 2. Włącz serwer MCP Developer Knowledge w projekcie

Uwaga: po 17 marca serwer MCP Developer Knowledge jest automatycznie włączany, gdy włączysz interfejs API Developer Knowledge.

Aby włączyć serwer Developer Knowledge MCP w projekcie Google Cloud, pobierz i zainstaluj gcloud CLI, a następnie uruchom to polecenie, zastępując PROJECT_ID identyfikatorem projektu Google Cloud:

gcloud beta services mcp enable developerknowledge.googleapis.com --project=PROJECT_ID

Jeśli usługa Developer Knowledge nie jest włączona w Twoim projekcie Google Cloud, przed włączeniem zdalnego serwera MCP pojawi się prośba o jej włączenie.

Ze względów bezpieczeństwa zalecamy włączanie serwerów MCP tylko w przypadku usług wymaganych do działania aplikacji AI.

Wskazówka: jeśli podczas wykonywania polecenia gcloud wystąpi błąd, uruchom polecenie gcloud components update beta, aby zaktualizować komponenty, a następnie spróbuj ponownie.

Krok 3. Skonfiguruj aplikację AI

Skonfiguruj popularne aplikacje AI, korzystając z tych instrukcji. Zastąp YOUR_API_KEY kluczem interfejsu Developer Knowledge API wygenerowanym w poprzednim kroku:

Interfejs wiersza poleceń Gemini

Aby skonfigurować interfejs wiersza poleceń Gemini, uruchom to polecenie:

gemini mcp add -t http -H "X-Goog-Api-Key: YOUR_API_KEY" google-developer-knowledge https://developerknowledge.googleapis.com/mcp --scope user

Możesz też edytować lub utworzyć jeden z tych plików konfiguracyjnych:

• W projekcie: .gemini/settings.json
• W katalogu głównym: ~/.gemini/settings.json

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

Gemini Code Assist

Aby skonfigurować Gemini Code Assist, edytuj lub utwórz jeden z tych plików konfiguracyjnych:

• W projekcie: .gemini/settings.json
• W katalogu głównym: ~/.gemini/settings.json

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

Claude Code

Aby skonfigurować Claude Code, uruchom to polecenie w folderze aplikacji.

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

Kursor

Aby skonfigurować Cursor, edytuj plik .cursor/mcp.json (dla konkretnego projektu) lub ~/.cursor/mcp.json (dla wszystkich projektów).

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

GitHub Copilot

Aby skonfigurować GitHub Copilot w VS Code dla jednego projektu, edytuj plik .vscode/mcp.json w obszarze roboczym.

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

Aby serwer był dostępny w każdym projekcie, zmień ustawienia użytkownika. Kliknij przycisk Otwórz ustawienia (JSON).

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

Windsurfing

Aby skonfigurować edytor Windsurf, edytuj plik ~/.codeium/windsurf/mcp_config.json.

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

Zweryfikuj instalację

Po skonfigurowaniu otwórz aplikację AI i wpisz prompt, np.:

How do I list Cloud Storage buckets?

Jeśli widzisz wywołanie narzędzia search_documents lub innego narzędzia serwera MCP Developer Knowledge, serwer działa prawidłowo.

Zarządzanie wykorzystaniem tokenów

Pobieranie treści dokumentu – zwłaszcza przy użyciu batch_get_documents – zużywa tokeny w oknie kontekstowym aplikacji AI. Niektóre strony dokumentacji dla deweloperów Google są dość duże, więc pobieranie wielu dokumentów może szybko prowadzić do wyższych kosztów, dłuższego czasu reakcji modelu i przepełnienia okna kontekstu.

Aby zoptymalizować wydajność i uniknąć nieoczekiwanego rachunku, twórz konkretne prompty, które będą dotyczyć tylko potrzebnych Ci informacji. Unikaj ogólnych próśb (np. „Porównaj wszystkie usługi Firebase”), które zmuszają agenta do jednoczesnego przetwarzania ogromnych ilości danych.

Dołączona dokumentacja

Informacje o tym, które dokumenty są przeszukiwane przez serwer, znajdziesz w dokumentacji korpusu.

Znane ograniczenia

• Zakres treści: obejmuje tylko publicznie widoczne strony w korpusie referencyjnym. Nie uwzględniamy treści z innych źródeł, takich jak GitHub, witryny OSS, blogi czy YouTube.
• Wyniki tylko w języku angielskim: serwer obsługuje tylko wyniki w języku angielskim.
• Zależne od sieci: narzędzia serwera korzystają z aktywnych usług Google Cloud. Jeśli błędy nadal będą występować, sprawdź połączenie z internetem i konfigurację klucza interfejsu Developer Knowledge API.

Rozwiązywanie problemów

Jeśli napotkasz problemy, sprawdź te kwestie:

• plik konfiguracyjny MCP dla narzędzia AI jest poprawnie sformatowany;
• Jeśli używasz metody uwierzytelniania API, w pliku konfiguracyjnym musisz użyć prawidłowego klucza Developer Knowledge API, który ma włączony interfejs Developer Knowledge API.
• Nie wykorzystano limitu interfejsu Developer Knowledge API.

Model Armor

Jeśli do ochrony aplikacji używasz Model Armor, w przypadku niektórych zapytań możesz napotkać błędy 403 PERMISSION_DENIED. Serwer Developer Knowledge MCP zwraca tylko publiczną dokumentację z zaufanych źródeł Google, dlatego zalecamy ustawienie filtrów Prompt Injection and Jailbreak (PIJB) na HIGH_AND_ABOVE poziomy ufności, 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.