Connettersi ai server Model Context Protocol (MCP)

I server MCP forniscono a Gemini strumenti e origini dati aggiuntivi. Ad esempio, aggiungendo il server MCP Firebase, puoi utilizzare il linguaggio naturale per esplorare i tuoi dati Cloud Firestore durante la creazione o il debug dell'applicazione.

Prerequisiti

Se richiesto dal server MCP, assicurati di avere un'installazione funzionante di Node.js e npm.

Scegliere un server MCP compatibile

Firebase Studio offre un supporto di base per i server MCP, ma non tutti i server MCP sono compatibili. Quando scegli un server MCP, tieni presente i seguenti dettagli di compatibilità:

  • Supportati :

    • Server di trasporto HTTP con input/output standard (stdio) o Server-Sent Events (SSE)/streamable
    • Autenticazione con chiave API tramite intestazioni HTTP o variabili di ambiente
    • Strumenti forniti dai server MCP

  • Non supportati :

    • Server che richiedono una Graphic User Interface o una sessione desktop
    • Prompt, campionamento o altre risorse fornite dai server MCP

Aggiungere un server MCP

Per aggiungere un server MCP, devi creare o modificare il relativo file di configurazione.

Passaggio 1: crea il file di configurazione

La chat interattiva e Gemini CLI possono connettersi ai server MCP, ma utilizzano file di configurazione diversi:

  • La chat interattiva utilizza .idx/mcp.json.
  • Gemini CLI utilizza .gemini/settings.json.

Crea uno o entrambi i file seguendo le istruzioni riportate di seguito.

Chat interattiva

Nella visualizzazione Code, crea .idx/mcp.json utilizzando uno di questi metodi:

  • Tavolozza dei comandi: apri la tavolozza dei comandi (Shift+Ctrl+P) e utilizza il Firebase Studio: Add MCP Server comando.
  • Chat interattiva: fai clic su Personalizzare l'icona degli strumenti Personalizza strumenti nella chat interattiva e seleziona Aggiungi server MCP.
  • Esplora: in Esplora (Ctrl+Shift+E), fai clic con il tasto destro del mouse sulla .idx directory e seleziona Nuovo file. Assegna al file il nome mcp.json.

Gemini CLI

Nella visualizzazione Code, crea .gemini/settings.json:

  1. In Esplora (Ctrl+Shift+E), controlla se esiste la directory .gemini. In caso contrario, fai clic con il tasto destro del mouse sul riquadro Esplora e seleziona Nuova cartella. Assegna alla cartella il nome .gemini.
  2. Fai clic con il tasto destro del mouse sulla directory .gemini e seleziona Nuovo file. Assegna al file il nome settings.json.

Per informazioni dettagliate sull'utilizzo dei server MCP con Gemini CLI, consulta la documentazione completa.

Passaggio 2: modifica la configurazione del server

  1. Apri il file di configurazione del server.

  2. Aggiungi la configurazione del server al contenuto del file. Ad esempio, per aggiungere il server MCP Firebase, inserisci:

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

    Questo file di configurazione indica a Gemini quale server MCP vuoi che utilizzi. Questo esempio mostra un singolo server denominato firebase che utilizzerà il comando npx per installare ed eseguire firebase-tools@latest.

    Se il server MCP richiede l'autenticazione con chiave API, puoi configurarla in uno dei seguenti modi:

    • Per i server MCP HTTP remoti che richiedono una chiave API nelle intestazioni delle richieste, utilizza il campo headers. Ad esempio, per configurare il server MCP di GitHub:

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

    • Per i server MCP stdio locali che richiedono una chiave API nelle variabili di ambiente, utilizza il campo env. Ad esempio, per configurare una build locale del server MCP di GitHub:

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

    • Per evitare di codificare i secret in mcp.json, puoi utilizzare facoltativamente la sintassi ${env:VARIABLE_NAME}. In questo modo, i valori verranno sostituiti dalle variabili di ambiente definite in un file .env o .env.local nella directory principale dello spazio di lavoro. Ad esempio:

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

  3. Nel terminale (Shift+Ctrl+C), esegui tutti i comandi necessari per completare l'installazione. Ad esempio, per utilizzare il server MCP Firebase, inserisci il seguente comando per accedere al tuo account:

    firebase login --no-localhost

    Segui le istruzioni nel terminale per autorizzare la sessione. Alcuni strumenti richiedono un progetto Firebase collegato. Puoi utilizzare il server MCP Firebase per creare un progetto oppure eseguire il seguente comando per inizializzare un progetto Firebase:

    firebase init

    Viene creato un file firebase.json nella directory principale.

Utilizzare gli strumenti MCP

Dopo aver installato il server MCP che vuoi utilizzare, gli strumenti o i dati che fornisce sono disponibili in:

  • Gemini CLI
  • Chat interattiva quando si utilizzano le modalità Agente e Agente (esecuzione automatica)
  • il App Prototyping agent

Ad esempio, se aggiungi il server MCP Firebase, puoi chiedere a Gemini di recuperare la configurazione dell'SDK per il progetto corrente, recuperare i dati archiviati in Cloud Firestore e Realtime Database, aiutarti a configurare i servizi Firebase, e altro ancora.

Nella chat interattiva, digita / per visualizzare un elenco di prompt MCP disponibili.

Elenco dei prompt MCP disponibili

Controllare o modificare gli strumenti

Puoi gestire gli strumenti attivi nella chat interattiva:

  1. Fai clic su Personalizzare l&#39;icona degli strumenti Personalizza strumenti nella chat interattiva per visualizzare un elenco di tutti gli strumenti disponibili dai server MCP configurati.
  2. Utilizza le caselle di controllo per attivare o disattivare un intero server o singoli strumenti.

Elenco degli strumenti MCP disponibili

Risolvere i problemi dei server MCP

Se riscontri problemi con un server MCP, segui questi passaggi per diagnosticare il problema.

Controllare i log per verificare la presenza di errori

  1. Apri il riquadro Output (Shift+Ctrl+U).
  2. Nel menu a discesa, seleziona Gemini.
  3. Controlla la presenza di messaggi che iniziano con un tag [MCPManager]. Questi log mostrano quali server sono configurati, quali strumenti sono stati aggiunti correttamente e tutti i messaggi di errore.

Ricostruire l'ambiente

Se un server MCP non viene installato o non si connette, prova a ricostruire lo spazio di lavoro:

  1. Apri la tavolozza dei comandi (Shift+Ctrl+P).
  2. Esegui il comando Firebase Studio: Rebuild Environment.
  3. Dopo la ricostruzione dello spazio di lavoro, controlla se il server MCP si connette.

Se gli strumenti non vengono utilizzati

Se il server MCP si connette, ma Gemini non utilizza i relativi strumenti:

  • Avvia una nuova sessione di chat: in questo modo, Gemini rileva la configurazione degli strumenti più recente. Scopri come gestire la cronologia chat.
  • Sii specifico nel prompt: se Gemini può completare l' attività senza utilizzare uno strumento MCP, potrebbe tentare un metodo diverso. Se vuoi utilizzare uno strumento specifico, prova a nominarlo. Ad esempio: "Utilizza firebase_get_sdk_config per ottenere la configurazione dell'SDK per il progetto corrente."
  • Partecipa al Google Developer Program: controlla se il tuo account è registrato.

Passaggi successivi