Verbindung mit MCP-Servern (Model Context Protocol) herstellen

MCP-Server stellen Gemini zusätzliche Tools und Daten quellen zur Verfügung. Wenn Sie beispielsweise den Firebase-MCP-Server hinzufügen, können Sie Ihre Cloud Firestore Daten in natürlicher Sprache untersuchen, während Sie Ihre Anwendung erstellen oder debuggen.

Vorbereitung

Wenn der MCP-Server dies erfordert, müssen Sie Node.js und npm installiert haben.

Kompatiblen MCP-Server auswählen

Firebase Studio bietet grundlegende Unterstützung für MCP-Server, aber nicht alle MCP Server sind kompatibel. Beachten Sie bei der Auswahl eines MCP-Servers die folgenden Kompatibilitätsdetails:

  • Unterstützt :

    • Server für Standardeingabe/‑ausgabe (stdio) oder Server-Sent Events (SSE)/streamfähige HTTP-Übertragung
    • API-Schlüssel-Authentifizierung mit HTTP-Headern oder Umgebungsvariablen
    • Von MCP-Servern bereitgestellte Tools

  • Nicht unterstützt :

    • Server, die eine grafische Benutzeroberfläche oder eine Desktopsitzung erfordern
    • Von MCP-Servern bereitgestellte Prompts, Stichproben oder andere Ressourcen

MCP-Server hinzufügen

Wenn Sie einen MCP-Server hinzufügen möchten, müssen Sie die Konfigurationsdatei erstellen oder bearbeiten.

Schritt 1: Konfigurationsdatei erstellen

Der interaktive Chat und Gemini CLI können beide eine Verbindung zu MCP Servern herstellen, verwenden aber unterschiedliche Konfigurationsdateien:

  • Der interaktive Chat verwendet .idx/mcp.json.
  • Gemini CLI verwendet .gemini/settings.json.

Erstellen Sie eine oder beide Dateien anhand der folgenden Anleitung.

Interaktiver Chat

Erstellen Sie in der Code Ansicht .idx/mcp.json mit einer der folgenden Methoden:

  • Befehlspalette: Öffnen Sie die Befehlspalette (Shift+Ctrl+P) und verwenden Sie den Firebase Studio: MCP-Server hinzufügen-Befehl.
  • Interaktiver Chat: Klicken Sie im interaktiven Chat auf Werkzeugsymbol anpassen Tools anpassen und wählen Sie MCP-Server hinzufügen aus.
  • Explorer: Klicken Sie im Explorer (Ctrl+Shift+E) mit der rechten Maustaste auf das .idx Verzeichnis und wählen Sie Neue Datei aus. Geben Sie der Datei den Namen mcp.json.

Gemini CLI

Erstellen Sie in der Code Ansicht .gemini/settings.json:

  1. Prüfen Sie im Explorer (Ctrl+Shift+E), ob das Verzeichnis .gemini vorhanden ist. Wenn nicht, klicken Sie mit der rechten Maustaste auf den Bereich „Explorer“ und wählen Sie Neuer Ordner aus. Geben Sie dem Ordner den Namen .gemini.
  2. Klicken Sie mit der rechten Maustaste auf das Verzeichnis .gemini und wählen Sie Neue Datei aus. Geben Sie der Datei den Namen settings.json.

Weitere Informationen zur Verwendung von MCP-Servern mit der Gemini CLI finden Sie in der vollständigen Dokumentation.

Schritt 2: Serverkonfiguration bearbeiten

  1. Öffnen Sie die Serverkonfigurationsdatei.

  2. Fügen Sie der Datei die Serverkonfiguration hinzu. Wenn Sie beispielsweise den Firebase-MCP-Server hinzufügen möchten, geben Sie Folgendes ein:

    {
  "mcpServers": {
   "firebase": {
     "command": "npx",
     "args": [
       "-y",
       "firebase-tools@latest",
       "mcp"
      ]
    }
  }
}

    Diese Konfigurationsdatei weist Gemini an, welchen MCP-Server verwendet werden soll. In diesem Beispiel wird ein einzelner Server namens firebase verwendet, der mit dem npx Befehl installiert und ausgeführt wird firebase-tools@latest.

    Wenn Ihr MCP-Server eine API-Schlüssel-Authentifizierung erfordert, können Sie ihn auf eine der folgenden Arten konfigurieren:

    • Verwenden Sie das Feld headers für Remote-HTTP-MCP-Server, die einen API-Schlüssel in den Anfrageheadern erfordern. So konfigurieren Sie beispielsweise den MCP-Server von GitHub:

      {
  "mcpServers": {
    "github": {
      "url": "https://api.githubcopilot.com/mcp/",
      "headers": {
        "Authorization": "Bearer <ACCESS_TOKEN>"
      }
    }
  }
}

    • Verwenden Sie das Feld env für lokale stdio-MCP-Server, die einen API-Schlüssel in Umgebungsvariablen erfordern. So konfigurieren Sie beispielsweise einen lokalen Build des MCP-Servers von GitHub:

      {
  "mcpServers": {
    "github": {
      "command": "/path/to/github-mcp-server",
      "args": ["stdio"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "<ACCESS_TOKEN>"
      }
    }
  }
}

    • Um Secrets nicht in mcp.json fest zu codieren, können Sie optional die Syntax ${env:VARIABLE_NAME} verwenden. Dadurch werden Werte aus Umgebungsvariablen ersetzt, die in einer .env oder .env.local Datei im Stammverzeichnis Ihres Arbeitsbereichs definiert sind. Beispiel:

      {
  "mcpServers": {
    "github": {
      "url": "https://api.githubcopilot.com/mcp/",
      "headers": {
        "Authorization": "Bearer ${env:GITHUB_ACCESS_TOKEN}"
      }
    }
  }
}

  3. Führen Sie im Terminal (Shift+Ctrl+C) alle erforderlichen Befehle aus, um die Installation abzuschließen. Wenn Sie beispielsweise den Firebase-MCP-Server verwenden möchten, geben Sie den folgenden Befehl ein, um sich in Ihrem Konto anzumelden:

    firebase login --no-localhost

    Folgen Sie der Anleitung im Terminal, um die Sitzung zu autorisieren. Für einige Tools ist ein verknüpftes Firebase-Projekt erforderlich. Sie können mit dem Firebase-MCP-Server ein Projekt erstellen oder den folgenden Befehl ausführen, um ein Firebase-Projekt zu initialisieren:

    firebase init

    Dadurch wird eine firebase.json-Datei im Stammverzeichnis erstellt.

MCP-Tools verwenden

Nachdem Sie den gewünschten MCP-Server installiert haben, sind die von ihm bereitgestellten Tools oder Daten in folgenden Bereichen verfügbar:

  • Gemini CLI
  • Interaktiver Chat im Agent-Modus und im Modus „Agent (Automatische Ausführung)“
  • the App Prototyping agent

Wenn Sie beispielsweise den Firebase-MCP-Server hinzufügen, können Sie Gemini bitten, die SDK-Konfiguration für das aktuelle Projekt abzurufen, in Cloud Firestore und Realtime Database gespeicherte Daten abzurufen, Sie bei der Einrichtung von Firebase-Diensten zu unterstützen, und vieles mehr.

Geben Sie im interaktiven Chat / ein, um eine Liste der verfügbaren MCP-Prompts aufzurufen.

Liste der verfügbaren MCP-Prompts

Tools prüfen oder anpassen

Sie können verwalten, welche Tools im interaktiven Chat aktiv sind:

  1. Klicken Sie im interaktiven Chat auf Werkzeugsymbol anpassen Tools anpassen , um eine Liste aller verfügbaren Tools von Ihren konfigurierten MCP-Servern aufzurufen.
  2. Verwenden Sie die Kästchen, um einen gesamten Server oder einzelne Tools zu aktivieren oder zu deaktivieren.

Liste der verfügbaren MCP-Tools

Fehlerbehebung bei MCP-Servern

Wenn Probleme mit einem MCP-Server auftreten, führen Sie die folgenden Schritte aus, um das Problem zu diagnostizieren.

Logs auf Fehler prüfen

  1. Öffnen Sie das Ausgabefeld (Shift+Ctrl+U).
  2. Wählen Sie im Drop-down-Menü Gemini aus.
  3. Suchen Sie nach Nachrichten, die mit dem Tag [MCPManager] beginnen. In diesen Logs sehen Sie, welche Server konfiguriert sind, welche Tools erfolgreich hinzugefügt wurden und alle Fehlermeldungen.

Umgebung neu erstellen

Wenn ein MCP-Server nicht installiert oder verbunden werden kann, versuchen Sie, Ihren Arbeitsbereich neu zu erstellen:

  1. Öffnen Sie die Befehlspalette (Shift+Ctrl+P).
  2. Führen Sie den Befehl Firebase Studio: Umgebung neu erstellen aus.
  3. Prüfen Sie nach dem Neuerstellen des Arbeitsbereichs, ob eine Verbindung zum MCP-Server hergestellt wird.

Wenn Tools nicht verwendet werden

Wenn eine Verbindung zum MCP-Server hergestellt wird, Gemini aber seine Tools nicht verwendet:

  • Neue Chatsitzung starten: So wird sichergestellt, dass Gemini die neueste Toolkonfiguration verwendet. Informationen zum Verwalten des Chatverlaufs.
  • Prompt präzise formulieren: Wenn Gemini die Aufgabe ohne MCP-Tool erledigen kann, wird möglicherweise eine andere Methode verwendet. Wenn Sie ein bestimmtes Tool verwenden möchten, geben Sie es an. Beispiel: „Verwende firebase_get_sdk_config, um die SDK-Konfiguration für das aktuelle Projekt abzurufen.“
  • Am Google Developer Program teilnehmen: Prüfen Sie, ob Ihr Konto registriert ist.

Nächste Schritte