Se connecter aux serveurs MCP (Model Context Protocol)

Les serveurs MCP fournissent à Gemini des outils et des sources de données supplémentaires. Par exemple, en ajoutant le serveur MCP Firebase, vous pouvez utiliser le langage naturel pour explorer vos Cloud Firestore données lors de la création ou du débogage de votre application.

Prérequis

Si le serveur MCP l'exige, assurez-vous que Node.js et npm sont correctement installés.

Choisir un serveur MCP compatible

Firebase Studio offre une compatibilité de base avec les serveurs MCP, mais tous les serveurs MCP ne sont pas compatibles. Lorsque vous choisissez un serveur MCP, tenez compte des détails de compatibilité suivants :

  • Types compatibles :

    • Serveurs de transport HTTP streamables/d'événements envoyés par le serveur (SSE) ou d'entrée/sortie standard (stdio)
    • Authentification par clé API à l'aide d'en-têtes HTTP ou de variables d'environnement
    • Outils fournis par les serveurs MCP

  • Formats non compatibles :

    • Serveurs nécessitant une interface utilisateur graphique ou une session de bureau
    • Invites, échantillonnage ou autres ressources fournis par les serveurs MCP

Ajouter un serveur MCP

Pour ajouter un serveur MCP, vous devez créer ou modifier son fichier de configuration.

Étape 1 : Créer le fichier de configuration

Le chat interactif et Gemini CLI peuvent tous deux se connecter à des serveurs MCP, mais utilisent des fichiers de configuration différents :

  • Le chat interactif utilise .idx/mcp.json.
  • Gemini CLI utilise .gemini/settings.json.

Créez un ou les deux fichiers en suivant les instructions ci-dessous.

Chat interactif

En mode Code, créez .idx/mcp.json à l'aide de l'une des méthodes suivantes :

  • Palette de commandes : ouvrez la palette de commandes (Shift+Ctrl+P) et utilisez la commande Firebase Studio: Add MCP Server (Firebase Studio : Ajouter un serveur MCP).
  • Chat interactif : cliquez sur Personnaliser l'icône Outils Customize Tools (Personnaliser les outils) dans le chat interactif, puis sélectionnez Add MCP server (Ajouter un serveur MCP).
  • Explorateur : dans l'explorateur (Ctrl+Shift+E), effectuez un clic droit sur le .idx répertoire, puis sélectionnez New file (Nouveau fichier). Nommez le fichier mcp.json.

Gemini CLI

En mode Code, créez .gemini/settings.json :

  1. Dans l'explorateur (Ctrl+Shift+E), vérifiez si le répertoire .gemini existe. Si ce n'est pas le cas, effectuez un clic droit dans le volet de l'explorateur, puis sélectionnez New folder (Nouveau dossier). Nommez le dossier .gemini.
  2. Effectuez un clic droit sur le répertoire .gemini, puis sélectionnez New file (Nouveau fichier). Nommez le fichier settings.json.

Pour en savoir plus sur l'utilisation des serveurs MCP avec Gemini CLI, consultez la documentation complète.

Étape 2 : Modifier la configuration du serveur

  1. Ouvrez le fichier de configuration du serveur.

  2. Ajoutez la configuration du serveur au contenu du fichier. Par exemple, pour ajouter le serveur MCP Firebase, saisissez :

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

    Ce fichier de configuration indique à Gemini le serveur MCP que vous souhaitez qu'il utilise. Cet exemple montre un seul serveur appelé firebase qui utilisera la npx commande pour installer et exécuter firebase-tools@latest.

    Si votre serveur MCP nécessite une authentification par clé API, vous pouvez le configurer de l'une des manières suivantes :

    • Pour les serveurs MCP HTTP distants qui nécessitent une clé API dans les en-têtes de requête, utilisez le champ headers. Par exemple, pour configurer le serveur MCP de GitHub :

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

    • Pour les serveurs MCP stdio locaux qui nécessitent une clé API dans les variables d'environnement, utilisez le champ env. Par exemple, pour configurer une version locale du serveur MCP de GitHub :

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

    • Pour éviter de coder en dur des secrets dans mcp.json, vous pouvez éventuellement utiliser la syntaxe ${env:VARIABLE_NAME}. Cela remplacera les valeurs des variables d'environnement définies dans un .env ou .env.local fichier à la racine de votre espace de travail. Exemple :

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

  3. Dans le terminal (Shift+Ctrl+C), exécutez toutes les commandes nécessaires pour terminer l'installation. Par exemple, pour utiliser le serveur MCP Firebase, saisissez la commande suivante pour vous connecter à votre compte :

    firebase login --no-localhost

    Suivez les instructions du terminal pour autoriser la session. Certains outils nécessitent un projet Firebase associé. Vous pouvez utiliser le serveur MCP Firebase pour créer un projet ou exécuter la commande suivante pour initialiser un projet Firebase :

    firebase init

    Cette opération crée un fichier firebase.json dans votre répertoire racine.

Utiliser les outils MCP

Une fois le serveur MCP que vous souhaitez utiliser installé, les outils ou les données qu'il fournit sont disponibles dans :

  • Gemini CLI
  • Le chat interactif lorsque vous utilisez les modes Agent et Agent (exécution automatique)
  • le App Prototyping agent

Par exemple, si vous ajoutez le serveur MCP Firebase, vous pouvez demander à Gemini de récupérer la configuration du SDK pour le projet actuel, de récupérer les données stockées dans Cloud Firestore et Realtime Database, de vous aider à configurer les services Firebase, et plus encore.

Dans le chat interactif, saisissez / pour afficher la liste des invites MCP disponibles.

Liste des requêtes MCP disponibles

Vérifier ou ajuster les outils

Vous pouvez gérer les outils actifs dans le chat interactif :

  1. Cliquez sur Personnaliser l&#39;icône Outils Customize Tools (Personnaliser les outils) dans le chat interactif pour afficher la liste de tous les outils disponibles à partir de vos serveurs MCP configurés.
  2. Utilisez les cases à cocher pour activer ou désactiver un serveur entier ou des outils individuels.

Liste des outils MCP disponibles

Résoudre les problèmes liés aux serveurs MCP

Si vous rencontrez des problèmes avec un serveur MCP, procédez comme suit pour diagnostiquer le problème.

Vérifier les journaux pour détecter les erreurs

  1. Ouvrez le panneau "Output" (Sortie) (Shift+Ctrl+U).
  2. Dans le menu déroulant, sélectionnez Gemini.
  3. Recherchez les messages qui commencent par un tag [MCPManager]. Ces journaux indiquent les serveurs configurés, les outils ajoutés et les messages d'erreur.

Reconstruire l'environnement

Si un serveur MCP ne parvient pas à s'installer ou à se connecter, essayez de reconstruire votre espace de travail :

  1. Ouvrez la palette de commandes (Shift+Ctrl+P).
  2. Exécutez la commande Firebase Studio: Rebuild Environment (Firebase Studio : Reconstruire l'environnement).
  3. Une fois l'espace de travail reconstruit, vérifiez si le serveur MCP se connecte.

Si les outils ne sont pas utilisés

Si le serveur MCP se connecte, mais que Gemini n'utilise pas ses outils :

  • Démarrez une nouvelle session de chat : cela permet à Gemini de récupérer la dernière configuration des outils. Découvrez comment gérer l'historique des discussions.
  • Soyez précis dans votre invite : si Gemini peut effectuer la tâche sans utiliser d’outil MCP, il peut tenter une autre méthode. Si vous souhaitez utiliser un outil spécifique, essayez de le nommer. Par exemple : "Utilisez firebase_get_sdk_config pour obtenir la configuration du SDK pour le projet actuel."
  • Rejoignez le Google Developer Program : vérifiez si votre compte est inscrit.

Étapes suivantes