Verbindung mit MCP-Servern (Model Context Protocol) herstellen

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

Vorbereitung

Wenn der MCP-Server dies erfordert, müssen Sie eine funktionierende Installation von Node.js und npm 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:

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

  • Nicht unterstützt:

    • Server, für die eine grafische Benutzeroberfläche oder eine Desktopsitzung erforderlich ist
    • Prompts, Sampling oder andere Ressourcen, die von MCP-Servern bereitgestellt werden

MCP-Server hinzufügen

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

Schritt 1: Konfigurationsdatei erstellen

Der interaktive Chat stellt mithilfe einer Konfigurationsdatei eine Verbindung zu MCP-Servern her:

  • Für interaktive Chats wird .idx/mcp.json verwendet.

Erstellen Sie die Datei anhand der folgenden Anleitung.

Interaktiver Chat

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

  • Befehlspalette: Öffnen Sie die Befehlspalette (Shift+Ctrl+P) und verwenden Sie den Befehl Firebase Studio: MCP-Server hinzufügen.
  • 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 Verzeichnis .idx und wählen Sie Neue Datei aus. Benennen Sie die Datei mcp.json.

Schritt 2: Serverkonfiguration bearbeiten

  1. Öffnen Sie die Serverkonfigurationsdatei.

  2. Fügen Sie die Serverkonfiguration in den Inhalt der Datei ein. 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 gezeigt, der den Befehl npx zum Installieren und Ausführen von firebase-tools@latest verwendet.

    Wenn für deinen MCP-Server eine API-Schlüssel-Authentifizierung erforderlich ist, kannst du sie auf eine der folgenden Arten konfigurieren:

    • Verwenden Sie für Remote-HTTP-MCP-Server, für die ein API-Schlüssel in den Anfrageheadern erforderlich ist, das Feld headers. Beispiel für die Konfiguration des MCP-Servers von GitHub:

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

    • Verwenden Sie für lokale stdio-MCP-Server, für die ein API-Schlüssel in Umgebungsvariablen erforderlich ist, das Feld env. Beispiel: So konfigurieren Sie 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 das Hartcodieren von Secrets in mcp.json zu vermeiden, können Sie optional die ${env:VARIABLE_NAME}-Syntax 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 den Firebase MCP-Server verwenden, um ein Projekt zu erstellen, oder Sie können den folgenden Befehl ausführen, um ein Firebase-Projekt zu initialisieren:

    firebase init

    Dadurch wird eine firebase.json-Datei in Ihrem Stammverzeichnis erstellt.

MCP-Tools verwenden

Nach der Installation des gewünschten MCP-Servers sind die von ihm bereitgestellten Tools oder Daten in folgenden Bereichen verfügbar:

  • Interaktiver Chat im Agentenmodus und im Modus „Agent (Auto-run)“
  • die 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, Daten abzurufen, die in Cloud Firestore und Realtime Database gespeichert sind, 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 festlegen, welche Tools in interaktiven Chats 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. Aktivieren oder deaktivieren Sie mit den Kästchen einen ganzen Server oder einzelne Tools.

Liste der verfügbaren MCP-Tools

Fehlerbehebung bei MCP-Servern

Wenn Probleme mit einem MCP-Server auftreten, können Sie das Problem mit den folgenden Schritten diagnostizieren.

Logs auf Fehler prüfen

  1. Öffnen Sie den Ausgabebereich (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 Protokollen sehen Sie, welche Server konfiguriert sind, welche Tools erfolgreich hinzugefügt wurden und ob Fehlermeldungen angezeigt werden.

Umgebung neu erstellen

Wenn ein MCP-Server nicht installiert oder keine Verbindung hergestellt 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: Rebuild Environment aus.
  3. Prüfe nach dem Wiederaufbau des Arbeitsbereichs, ob der MCP-Server eine Verbindung herstellt.

Wenn Tools nicht verwendet werden

Wenn der MCP-Server eine Verbindung herstellt, Gemini aber seine Tools nicht verwendet:

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

Nächste Schritte