Verbindung zum MCP-Server für Entwicklerwissen herstellen

Der MCP-Server für Google Developer Knowledge ermöglicht es KI-gestützten Entwicklungstools, die offizielle Google-Entwicklerdokumentation zu durchsuchen und Informationen zu Google-Produkten wie Firebase, Google Cloud, Android und Maps abzurufen. Wenn Sie Ihre KI-Anwendung direkt mit unserer offiziellen Dokumentationsbibliothek verbinden, erhalten Sie aktuellen Code und aktuelle Anleitungen, die auf einem maßgeblichen Kontext basieren.

Nachdem Sie den Server eingerichtet haben, können integrierte Tools bei Anfragen wie den folgenden helfen:

  • Implementierungsleitfaden

    • Beispiel: Wie implementiere ich Push-Benachrichtigungen am besten mit Firebase Cloud Messaging in einer Android-App?

  • Codegenerierung und ‑erklärung

    • Beispiel: Suche in der Google-Dokumentation nach einem Python-Beispiel, um alle Buckets in einem Cloud Storage-Projekt aufzulisten.

  • Fehlerbehebung und Debugging

    • Beispiel: Warum wird auf meinem Google Maps API-Schlüssel das Wasserzeichen „Nur für Entwicklungszwecke“ angezeigt?

  • Vergleichsanalyse und Zusammenfassung

    • Beispiel: Hilf mir bei der Auswahl zwischen Cloud Run und Cloud Functions für einen neuen Microservice. Erstelle eine Markdown-Tabelle, in der die wichtigsten Aspekte wie primärer Anwendungsfall, Parallelität und Preismodell verglichen werden.

Funktionen des MCP-Servers

Der MCP-Server für Google Developer Knowledge stellt Ihrer KI-Anwendung die folgenden Tools zur Verfügung:

Name des Tools Beschreibung
search_documents Durchsucht die Google-Entwicklerdokumentation (Firebase, Google Cloud, Android, Maps usw.) nach relevanten Seiten und Snippets für Ihre Anfrage. Verwenden Sie get_documents mit dem parent aus den Suchergebnissen, um den vollständigen Seiteninhalt abzurufen.
get_documents Ruft den vollständigen Inhalt mehrerer Dokumente mit parents aus den search_documents-Ergebnissen ab.

Das Tool search_documents unterteilt die Dokumentation in kleinere Textblöcke, die für die KI-gestützte Suche und den Abruf optimiert sind. Wenn Sie suchen, gibt das Tool ein oder mehrere Dokumentsnippets zurück, die für Ihre Anfrage relevant sind. Wenn Sie den vollständigen Seiteninhalt um ein Snippet herum sehen möchten, verwenden Sie get_documents mit dem in den Suchergebnissen angegebenen parent, um den vollständigen Seiteninhalt abzurufen.

Installation

Der MCP-Server für Google Developer Knowledge ist ein Remote-MCP-Server, der die Developer Knowledge API verwendet, um Dokumentation zu suchen und abzurufen. Sie können sich entweder mit OAuth oder einem API-Schlüssel authentifizieren.

Authentifizierung mit OAuth

In diesem Abschnitt wird beschrieben, wie Sie Ihre KI-Anwendung mit OAuth beim MCP-Server für Developer Knowledge authentifizieren.

Voraussetzung: Google Cloud CLI einrichten

Bevor Sie fortfahren, müssen Sie Folgendes haben:

Schritt 1: Developer Knowledge API in einem Projekt aktivieren

  1. Öffnen Sie die Seite Developer Knowledge API in der Google APIs-Bibliothek.
  2. Prüfen Sie, ob das richtige Projekt ausgewählt ist, in dem Sie die API verwenden möchten.
  3. Klicken Sie auf Aktivieren. Für die Aktivierung oder Verwendung der API sind keine bestimmten IAM-Rollen erforderlich.

Schritt 2: Authentifizierungsmethode auswählen

Die von Ihnen gewählte Authentifizierungsmethode hängt davon ab, ob Ihr KI-Assistent Standardanmeldedaten für Anwendungen (Application Default Credentials ADC) mit der gcloud CLI unterstützt oder eine eigenständige OAuth-Client-ID erfordert. Assistenten wie die Gemini CLI können Ihre vorhandene Google Cloud-Anmeldung für eine nahtlose Einrichtung verwenden, während Sie bei anderen wie Antigravity Ihre eigenen Anmeldedaten manuell erstellen und angeben müssen, um eine sichere Verbindung herzustellen.

Wählen Sie den Tab aus, der den Einrichtungsvoraussetzungen Ihres spezifischen KI-Assistenten entspricht.

ADC

Konto verbinden

  1. Wenn Sie dem MCP-Server die Möglichkeit geben möchten, in Ihrem Namen zu handeln, führen Sie den folgenden Befehl aus und ersetzen Sie PROJECT_ID durch Ihre Google Cloud-Projekt-ID:

    gcloud auth application-default login
--project=PROJECT_ID

  2. Wählen Sie bei Aufforderung ein Konto aus und klicken Sie auf Weiter.

KI-Anwendung konfigurieren

Nach der Authentifizierung müssen Sie Ihrer KI-Anwendung die Serverkonfigurationsdetails zur Verfügung stellen. Die genaue JSON-Struktur variiert je nach Anwendung. Sie können das folgende Beispiel als Vorlage verwenden.

  1. Wenn Sie Gemini CLI oder Gemini Code Assist konfigurieren möchten, bearbeiten oder erstellen Sie eine der folgenden Konfigurationsdateien:

    • In Ihrem Projekt: .gemini/settings.json
    • In Ihrem Basisverzeichnis: ~/.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"
      }
    }
  }
}

    Wenn Sie prüfen möchten, ob der MCP-Server wie erwartet funktioniert, fahren Sie mit der Installation prüfen fort. Installation prüfen.

Manuelle Anmeldedaten

OAuth-Zustimmungsbildschirm konfigurieren

Konfigurieren Sie den OAuth-Zustimmungsbildschirm des Projekts und fügen Sie sich selbst als Testnutzer hinzu. Wenn Sie diesen Schritt bereits für Ihr Google Cloud-Projekt abgeschlossen haben, fahren Sie mit dem nächsten Schritt fort.

  1. Öffnen Sie die Seite „Authentifizierung“ in der Google Cloud Console, und klicken Sie auf Jetzt starten.
  2. Geben Sie einen App-Namen ein, wählen Sie Ihre Support-E-Mail-Adresse aus und klicken Sie Weiter.
  3. Wählen Sie unter Zielgruppe die Option Extern aus und klicken Sie auf Weiter.
  4. Geben Sie unter Kontaktdaten Ihre E-Mail-Adresse ein und klicken Sie auf Weiter.
  5. Lesen und akzeptieren Sie die Richtlinie zu Nutzerdaten für Google API-Dienste und klicken Sie dann auf Weiter.
  6. Klicken Sie auf Erstellen.

Testnutzer hinzufügen

  1. Klicken Sie in der Google Auth Platform auf Zielgruppe.
  2. Klicken Sie unter Testnutzer auf Nutzer hinzufügen.
  3. Geben Sie Ihre E-Mail-Adresse und die E-Mail-Adressen aller anderen autorisierten Testnutzer ein und klicken Sie auf Speichern.

OAuth-Client erstellen

Für die Authentifizierung als Endnutzer und für den Zugriff auf Nutzerdaten in Ihrer Anwendung müssen Sie OAuth 2.0-Client-IDs erstellen. Eine Client-ID wird zur Identifizierung einer einzelnen Anwendung bei den OAuth-Servern von Google verwendet.

  1. Klicken Sie in der Google Auth Platform auf Clients.
  2. Klicken Sie auf Client erstellen.
  3. Wählen Sie in der Auswahl Anwendungstyp die Option Desktop-App aus.
  4. Geben Sie im Feld Name einen Namen für die Anmeldedaten ein. Dieser Name wird nur in der Google Cloud Console angezeigt.
  5. Klicken Sie auf Erstellen. Der Bildschirm „OAuth-Client erstellt“ wird angezeigt und enthält Ihre neue Client-ID und Ihren neuen Clientschlüssel.
  6. Klicken Sie auf OK. Die neu erstellten Anmeldedaten werden unter OAuth 2.0-Client-IDs angezeigt.
  7. Klicken Sie auf die neu erstellte Client-ID. Klicken Sie im Abschnitt Clientschlüssel auf das Download-Symbol, um die JSON-Datei zu speichern. Sie verwenden die client_id und client_secret Werte in dieser Datei in einem späteren Schritt.

KI-Anwendung konfigurieren

Als Nächstes müssen Sie Ihrer KI-Anwendung die Serverkonfigurationsdetails zur Verfügung stellen. Die genaue Abfolge der Schritte variiert je nach Anwendung. Sie können das folgende Beispiel als Vorlage verwenden.

So konfigurieren Sie Antigravity für die Verwendung des MCP-Servers:

  1. Klicken Sie in Antigravity im Bereich „Agent“ auf das Menü Weitere Optionen > MCP-Server > MCP-Server verwalten.

  2. Klicken Sie oben im Bereich „MCP-Server verwalten“ auf Rohkonfiguration ansehen, um die mcp_config.json Datei zu bearbeiten:

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

  3. Kehren Sie zu MCP-Server verwalten zurück und klicken Sie auf Aktualisieren.

OAuth-Anmeldedaten hinzufügen

Wenn Sie den MCP-Server für Developer Knowledge zum ersten Mal verwenden, werden Sie von Ihrem KI-Assistenten aufgefordert, die Einrichtung abzuschließen:

  1. Fordern Sie den Agenten mit einem Prompt wie dem folgenden auf, den MCP-Server für Developer Knowledge zu verwenden:

    How do I list Cloud Storage buckets?

  2. Wenn Sie aufgefordert werden, eine oder mehrere Weiterleitungs-URIs zu registrieren, klicken Sie auf die Option, um fortzufahren. Da Sie die Client-ID als Desktop-App eingerichtet haben, müssen Sie diese spezifischen URIs nicht in der Google Auth Platform hinzufügen.

  3. Wenn Sie von Ihrem KI-Assistenten nach der Client-ID und dem Clientschlüssel gefragt werden, fügen Sie jeden entsprechenden Schlüssel aus der zuvor gespeicherten JSON-Datei mit dem Clientschlüssel ein.

  4. Wählen Sie bei Aufforderung ein Konto aus und klicken Sie auf Weiter.

  5. Kehren Sie zu Ihrem KI-Assistenten zurück. Der Agent verarbeitet Ihre Anfrage jetzt mit dem neu authentifizierten Server.

Authentifizierung mit einem API-Schlüssel

In diesem Abschnitt wird beschrieben, wie Sie Ihre KI-Anwendung mit einem API-Schlüssel beim MCP-Server für Developer Knowledge authentifizieren.

Schritt 1: API-Schlüssel erstellen

Sie können einen API-Schlüssel für Developer Knowledge in Ihrem Google Cloud-Projekt entweder über die Google Cloud Console oder die gcloud CLI generieren:

Google Cloud Console

API aktivieren

  1. Öffnen Sie die Seite Developer Knowledge API in der Google APIs-Bibliothek.
  2. Prüfen Sie, ob das richtige Projekt ausgewählt ist, in dem Sie die API verwenden möchten.
  3. Klicken Sie auf Aktivieren. Für die Aktivierung oder Verwendung der API sind keine bestimmten IAM-Rollen erforderlich.

API-Schlüssel erstellen und sichern

  1. Rufen Sie in der Google Cloud Console für das Projekt, in dem Sie die API aktiviert haben, die Seite „Anmeldedaten“ auf.
  2. Klicken Sie auf Anmeldedaten erstellen und wählen Sie im Menü API-Schlüssel aus. Das Dialogfeld „API-Schlüssel erstellt“ enthält den String für den neu erstellten Schlüssel.
  3. Klicken Sie auf API-Schlüssel bearbeiten.
  4. Geben Sie im Feld Name einen Namen für den Schlüssel ein.
  5. Wählen Sie unter API-Einschränkungen die Option Schlüssel einschränken aus.
  6. Aktivieren Sie in der Liste APIs auswählen die Option Developer Knowledge API und klicken Sie auf OK.
    • Hinweis: Wenn Sie die Developer Knowledge API gerade erst aktiviert haben, kann es eine Weile dauern, bis sie in der Liste APIs auswählen angezeigt wird.
  7. Klicken Sie auf Speichern.

Nachdem der Schlüssel erstellt wurde, klicken Sie auf Schlüssel anzeigen , um ihn aufzurufen. Notieren Sie ihn sich für die Verwendung bei der Konfiguration Ihrer KI-Anwendung.

gcloud-CLI

  1. Laden Sie die gcloud CLI herunter und installieren Sie sie, falls noch nicht geschehen, .

  2. Aktivieren Sie die Developer Knowledge API und ersetzen Sie PROJECT_ID durch Ihre Google Cloud-Projekt-ID:

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

  3. Erstellen Sie einen API-Schlüssel mit derselben Google Cloud-Projekt-ID:

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

    Dieser Befehl gibt einen API-Schlüsselstring zurück. Notieren Sie ihn sich für die Konfiguration Ihrer KI-Anwendung .

  4. Sichern Sie Ihren API-Schlüssel, indem Sie API-Schlüsseleinschränkungen hinzufügen. Aus Sicherheitsgründen sollten Sie den API-Schlüssel auf die Developer Knowledge API beschränken.

Schritt 2: MCP-Server für Developer Knowledge in einem Projekt aktivieren

Wenn Sie den MCP-Server für Developer Knowledge in Ihrem Google Cloud-Projekt aktivieren möchten, laden Sie die gcloud CLIherunter und installieren Sie sie. Führen Sie dann den folgenden Befehl aus und ersetzen Sie PROJECT_IDdurch Ihre Google Cloud-Projekt-ID:

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

Wenn der Developer Knowledge-Dienst für Ihr Google Cloud-Projekt nicht aktiviert ist, werden Sie aufgefordert, den Dienst zu aktivieren, bevor Sie den Remote-MCP-Server aktivieren können.

Aus Sicherheitsgründen empfehlen wir, MCP-Server nur für die Dienste zu aktivieren, die für die Funktion Ihrer KI-Anwendung erforderlich sind.

Schritt 3: KI-Anwendung konfigurieren

Konfigurieren Sie beliebte KI-Anwendungen anhand dieser Anleitung. Ersetzen Sie YOUR_API_KEY durch den API-Schlüssel für Developer Knowledge, den Sie in dem vorherigen Schritt generiert haben:

Gemini CLI

Führen Sie den folgenden Befehl aus, um die Gemini CLI zu konfigurieren:

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

Alternativ können Sie eine der folgenden Konfigurationsdateien bearbeiten oder erstellen:

  • In Ihrem Projekt: .gemini/settings.json
  • In Ihrem Basisverzeichnis: ~/.gemini/settings.json
{
  "mcpServers": {
    "google-developer-knowledge": {
      "httpUrl": "https://developerknowledge.googleapis.com/mcp",
      "headers": {
        "X-Goog-Api-Key": "YOUR_API_KEY"
      }
    }
  }
}

Gemini Code Assist

Wenn Sie Gemini Code Assist konfigurieren möchten, bearbeiten oder erstellen Sie eine der folgenden Konfigurationsdateien:

  • In Ihrem Projekt: .gemini/settings.json
  • In Ihrem Basisverzeichnis: ~/.gemini/settings.json
{
  "mcpServers": {
    "google-developer-knowledge": {
      "httpUrl": "https://developerknowledge.googleapis.com/mcp",
      "headers": {
        "X-Goog-Api-Key": "YOUR_API_KEY"
      }
    }
  }
}

Claude Code

Führen Sie den folgenden Befehl in Ihrem App-Ordner aus, um Claude Code zu konfigurieren.

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

Cursor

Wenn Sie Cursor konfigurieren möchten, bearbeiten Sie entweder .cursor/mcp.json (für ein bestimmtes Projekt) oder ~/.cursor/mcp.json (für alle Projekte).

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

GitHub Copilot

Wenn Sie GitHub Copilot in VS Code für ein einzelnes Projekt konfigurieren möchten, bearbeiten Sie die Datei .vscode/mcp.json in Ihrem Arbeitsbereich.

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

Wenn der Server in jedem Projekt verfügbar sein soll, bearbeiten Sie Ihre Nutzereinstellungen. Klicken Sie auf die Schaltfläche Einstellungen öffnen (JSON).

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

Windsurf

Wenn Sie den Windsurf Editor konfigurieren möchten, bearbeiten Sie die Datei ~/.codeium/windsurf/mcp_config.json.

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

Installation prüfen

Öffnen Sie nach der Konfiguration Ihre KI-Anwendung und geben Sie einen Prompt wie den folgenden ein:

How do I list Cloud Storage buckets?

Wenn Sie einen Toolaufruf an search_documents oder ein anderes Tool des MCP-Servers für Developer Knowledge sehen, funktioniert der Server korrekt.

Tokennutzung verwalten

Beim Abrufen von Dokumentinhalten, insbesondere bei Verwendung von batch_get_documents, werden Token im Kontextfenster Ihrer KI-Anwendung verbraucht. Da einige Seiten der Google-Entwicklerdokumentation sehr umfangreich sind, kann das Abrufen mehrerer Dokumente schnell zu höheren Kosten, langsameren Modellantwortzeiten und einem Überlauf des Kontextfensters führen.

Um die Leistung zu optimieren und unerwartete Kosten zu vermeiden, erstellen Sie spezifische Prompts, die nur auf die benötigten Informationen abzielen. Vermeiden Sie allgemeine Anfragen (z. B. „Vergleiche alle Firebase-Produkte“), bei denen der Agent große Datenmengen auf einmal aufnehmen muss.

Enthaltene Dokumentation

Informationen dazu, in welchen Dokumenten der Server sucht, finden Sie unter Korpusreferenz.

Bekannte Einschränkungen

  • Umfang der Inhalte: Es werden nur öffentlich sichtbare Seiten in der Korpusreferenz berücksichtigt. Inhalte aus anderen Quellen wie GitHub, OSS-Websites, Blogs oder YouTube sind nicht enthalten.
  • Nur englische Ergebnisse:Der Server unterstützt nur Ergebnisse in englischer Sprache.
  • Netzwerkabhängig: Die Tools des Servers basieren auf aktiven Google Cloud-Diensten. Wenn weiterhin Fehler auftreten, prüfen Sie Ihre Internetverbindung und die Konfiguration des API-Schlüssels für Developer Knowledge.

Fehlerbehebung

Wenn Probleme auftreten, prüfen Sie Folgendes:

  • Die MCP-Konfigurationsdatei für Ihr KI-Tool ist korrekt formatiert.
  • Wenn Sie die API-Authentifizierungsmethode verwenden, haben Sie in Ihrer Konfigurationsdatei einen gültigen API-Schlüssel für Developer Knowledge verwendet, für den die Developer Knowledge API aktiviert ist.
  • Sie haben Ihr Kontingent für die Developer Knowledge API nicht ausgeschöpft.

Model Armor

Wenn Sie Model Armor zum Schutz Ihrer Anwendung verwenden, können bei einigen Abfragen 403 PERMISSION_DENIED Fehler auftreten. Da der MCP-Server für Developer Knowledge nur öffentliche Dokumentation aus vertrauenswürdigen Google-Quellen zurückgibt, empfehlen wir, die Filter für Prompt Injection und Jailbreak (PIJB) auf die Vertrauensstufen HIGH_AND_ABOVE festzulegen, um falsch positive Ergebnisse zu reduzieren. Wenn Ihr Anwendungsfall keine anderen Tools umfasst, die auf private oder vertrauliche Daten zugreifen, können Sie auch die PIJB-Filter deaktivieren.