Connettersi ai server Model Context Protocol (MCP)

I server MCP forniscono Gemini con strumenti e origini dati aggiuntivi. Ad esempio, aggiungendo il server Firebase MCP, puoi utilizzare il linguaggio naturale per esplorare i 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 supporta i server MCP di base, ma non tutti i server MCP sono compatibili. Quando scegli un server MCP, tieni presente i seguenti dettagli di compatibilità:

  • Supportato:

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

  • Non supportato:

    • 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 queste istruzioni.

Chat interattiva

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

  • Tavolozza comandi: apri la tavolozza dei comandi (Shift+Ctrl+P) e utilizza il comando Firebase Studio: Add MCP Server.
  • 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 directory .idx e seleziona Nuovo file. Assegna al file il nome mcp.json.

Gemini CLI

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

  1. In Esplora risorse (Ctrl+Shift+E), controlla se esiste la directory .gemini. In caso contrario, fai clic con il tasto destro del mouse sul riquadro di Esplora risorse e seleziona Nuova cartella. Assegna un nome alla cartella .gemini.
  2. Fai clic con il tasto destro del mouse sulla directory .gemini e seleziona Nuovo file. Assegna un nome al file 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 ai contenuti del file. Ad esempio, per aggiungere il server MCP Firebase, inserisci:

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

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

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

    • Per i server HTTP MCP 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>"
      }
    }
  }
}

  3. Nel terminale (Shift+Ctrl+C), esegui i comandi necessari per completare l'installazione. Ad esempio, per utilizzare il server Firebase MCP, 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 Firebase MCP per creare un progetto oppure puoi 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)
  • App Prototyping agent

Ad esempio, se aggiungi il server Firebase MCP, 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 regolare 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

Risolvi i problemi relativi ai server MCP

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

Controllare i log per individuare eventuali errori

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

Ricostruisci l'ambiente

Se l'installazione o la connessione di un server MCP non va a buon fine, prova a ricreare lo spazio di lavoro:

  1. Apri la tavolozza dei comandi (Shift+Ctrl+P).
  2. Esegui il comando Firebase Studio: Rebuild Environment.
  3. Dopo la ricompilazione 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 suoi strumenti:

  • Avvia una nuova sessione di chat: in questo modo Gemini rileva la configurazione più recente dello strumento. Scopri come gestire la cronologia chat.
  • Sii specifico nel prompt: se Gemini può svolgere 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