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 beim Erstellen oder Debuggen Ihrer Anwendung Cloud Firestore Daten in natürlicher Sprache abfragen.

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 :

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

  • Nicht unterstützt :

    • Server, die eine grafische Benutzeroberfläche oder eine Desktopsitzung erfordern
    • Prompts, Stichproben 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 die Konfigurationsdatei erstellen oder bearbeiten.

Schritt 1: Konfigurationsdatei erstellen

Der interaktive Chat stellt über eine Konfigurationsdatei eine Verbindung zu MCP-Servern her:

  • Der interaktive Chat verwendet .idx/mcp.json.

Erstellen Sie die Datei 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.

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

    In dieser Konfigurationsdatei wird Gemini mitgeteilt, welchen MCP-Server es verwenden soll. In diesem Beispiel wird ein einzelner Server namens firebase verwendet, der mit dem npx Befehl firebase-tools@latest installiert und ausgeführt wird.

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

    • Wenn Sie keine Secrets in mcp.json fest codieren möchten, können Sie optional die Syntax ${env:VARIABLE_NAME} verwenden. Dadurch werden Werte aus Umgebungsvariablen ersetzt, die in einer Datei .env oder .env.local 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 im Stammverzeichnis eine Datei firebase.json 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:

  • 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 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: 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 ein MCP-Tool erledigen kann, versucht es möglicherweise eine andere Methode. Wenn Sie ein bestimmtes Tool verwenden möchten, geben Sie es im Prompt 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