Cette page a été traduite par l'API Cloud Translation.

Utiliser Firestore avec MCP, la CLI Gemini et d'autres agents

Cette page vous explique comment connecter votre base de données Firestore à différents outils pour les développeurs.

Pour une expérience intégrée, nous vous recommandons d'utiliser l'extension Firestore dédiée pour la CLI Gemini. Interface de ligne de commande nouvelle génération de Google Cloud, la CLI Gemini regroupe le serveur MCP sous-jacent directement dans l'extension, ce qui élimine la nécessité d'une configuration de serveur distincte. Vous pouvez configurer Gemini Code Assist pour qu'il utilise la CLI Gemini, ce qui offre des avantages de configuration similaires dans votre IDE.

Pour les autres outils pour les développeurs compatibles avec le Model Context Protocol (MCP), vous pouvez vous connecter en configurant manuellement la MCP Toolbox pour les bases de données. MCP Toolbox est un serveur MCP Open Source qui connecte les agents d'IA à vos données en gérant des tâches telles que l'authentification et le regroupement de connexions. Cela vous permet d'interagir avec vos données en langage naturel directement depuis votre IDE. Pour ces outils, cette méthode fournit des fonctionnalités d'interaction de base avec la base de données. Cette page explique comment utiliser la MCP Toolbox for Databases pour exposer vos outils d'assistance aux développeurs à une instance Firestore à l'aide des IDE suivants :

Gemini CLI
Gemini Code Assist
Cursor
Windsurf (Codium)
Visual Studio Code (Copilot)
Cline (extension VS Code)
Claude sur ordinateur
Code Claude

À propos de la CLI Gemini et des extensions

La CLI Gemini est un agent d'IA Open Source conçu pour vous aider dans vos workflows de développement en vous assistant pour le codage, le débogage, l'exploration de données et la création de contenu. Sa mission est de fournir une interface agentique pour interagir avec les services Data Cloud et les bases de données Open Source populaires.

Fonctionnement des extensions

La CLI Gemini est très extensible et permet d'ajouter de nouveaux outils et fonctionnalités grâce aux extensions. Vous pouvez charger les extensions à partir d'une URL GitHub, d'un répertoire local ou d'un registre configurable. Ils fournissent de nouveaux outils, des commandes slash et des requêtes pour vous aider dans votre workflow.

Utiliser l'extension CLI Gemini pour Firestore

L'intégration à la CLI Gemini se fait via une extension dédiée qui offre des fonctionnalités supplémentaires par rapport à la connexion standard à la boîte à outils MCP. L'extension propose un processus d'installation simplifié et un ensemble d'outils. L'extension Open Source contient des informations détaillées sur l'installation, la configuration et des exemples d'utilisation. Pour en savoir plus, consultez Extension Gemini CLI – Firestore.

L'extension firestore-native inclut des outils permettant d'interroger la base de données, de mettre à jour des documents et de gérer les règles de sécurité Firestore.

Catégorie	Outils	Exemple de requête en langage naturel
Récupération de documents et de données	`get_documents`	Affiche-moi les données Firestore pour les utilisateurs de test qa_user_123 et qa_user_456 de la collection users-staging.
	`list_collections`	Répertoriez toutes les sous-collections de la collection "users-staging".
	`query_collection`	Recherchez tous les utilisateurs de la collection "users-staging" dont la liste de souhaits contient le produit "product-glasses".
Mises à jour et suppressions de documents	`add_documents`	Ajoute le document qa_user_789 à la collection users-staging avec les champs name: tester1 et location: USA.
	`delete_documents`	Supprime le document qa_user_789 de la collection users-staging.
	`update_document`	Mettez à jour le document portant l'ID order-987 dans la collection "orders" pour définir l'état sur "Shipped". Pour les 20 utilisateurs de test que vous venez de trouver, veuillez supprimer le produit "product-glasses(inactive)" de leur liste de souhaits.
Gestion des règles de sécurité	`get_rules`	Affiche-moi les règles de sécurité Firestore actives pour cette base de données.
Gestion des règles de sécurité	`validate_rules`	new_rules.txt est une nouvelle règle de sécurité Firestore sur laquelle je travaille pour l'environnement de staging. Pouvez-vous le valider pour moi ?

Avant de commencer

Pour utiliser les outils de l'extension Gemini CLI pour Firestore, vous devez disposer de l'un des rôles Identity and Access Management (IAM) suivants ou d'un rôle personnalisé avec des autorisations équivalentes :

Tâche	Nom du rôle	Rôle IAM (Identity and Access Management) requis
Lire et écrire des données dans une base de données Firestore	Utilisateur Cloud Datastore	`roles/datastore.user`
Afficher et tester les règles de sécurité	Lecteur Firebase Rules	`roles/firebaserules.viewer`

Configurer Firestore

Créez un Google Cloud projet ou sélectionnez-en un existant.
Activez l'API Firestore en mode natif pour votre projet.
Créez une base de données Firestore si vous ne l'avez pas déjà fait.
Configurez l'authentification pour votre environnement local.
- Installer la gcloud CLI
- Exécutez gcloud auth application-default login pour vous authentifier.

Configurer le client MCP

Cette section explique comment configurer différents outils pour les développeurs afin de vous connecter à votre instance Firestore à l'aide de la boîte à outils MCP pour les bases de données. Cette boîte à outils fait office de serveur Model Context Protocol (MCP) Open Source qui se situe entre votre IDE et votre base de données. Elle fournit un plan de contrôle sécurisé et efficace pour vos outils d'IA. Sélectionnez l'onglet de l'un des outils suivants pour afficher les instructions de configuration.

CLI Gemini

Installez la CLI Gemini.
Installez l'extension Firestore pour Gemini CLI à partir du dépôt GitHub à l'aide de la commande suivante :
```
gemini extensions install https://github.com/gemini-cli-extensions/firestore-native
```
Définissez des variables d'environnement pour vous connecter à votre base de données Firestore. La variable FIRESTORE_DATABASE est facultative et sa valeur par défaut est (default) :
```
export FIRESTORE_PROJECT="PROJECT_ID"
export FIRESTORE_DATABASE="DATABASE_NAME"
```
L'extension Gemini CLI pour Firestore utilise vos identifiants par défaut de l'application (ADC) pour l'authentification.
Démarrez la CLI Gemini en mode interactif :
```
gemini
```
La CLI charge automatiquement l'extension Firestore pour la CLI Gemini et ses outils, que vous pouvez utiliser pour interagir avec votre base de données.

Gemini Code Assist

Nous vous recommandons de configurer Gemini Code Assist pour qu'il utilise la CLI Gemini. Cette approche élimine la nécessité de configurer manuellement un serveur MCP.

Assurez-vous d'avoir installé et configuré la Gemini CLI et l'extension firestore-native.
Configurez Gemini Code Assist pour utiliser la CLI Gemini.
Commencez à interagir avec votre base de données Firestore en langage naturel directement dans le chat Gemini Code Assist.

Code Claude

Installer MCP Toolbox for Databases

Téléchargez la dernière version de Toolbox en tant que binaire. Sélectionnez le fichier binaire correspondant à votre système d'exploitation et à l'architecture de votre processeur. Vous devez utiliser la version V0.15.0 ou ultérieure de Toolbox.
linux/amd64
curl -O https://storage.googleapis.com/genai-toolbox/version/linux/amd64/toolbox
Remplacez version par le numéro de version de Toolbox, par exemple v0.15.0.
darwin/arm64
curl -O https://storage.googleapis.com/genai-toolbox/version/darwin/arm64/toolbox
Remplacez version par le numéro de version de Toolbox, par exemple v0.15.0.
darwin/amd64
curl -O https://storage.googleapis.com/genai-toolbox/version/darwin/amd64/toolbox
Remplacez version par le numéro de version de Toolbox, par exemple v0.15.0.
windows/amd64
curl -O https://storage.googleapis.com/genai-toolbox/version/windows/amd64/toolbox
Remplacez version par le numéro de version de Toolbox, par exemple v0.15.0.
Rendez le binaire exécutable.
```
chmod +x toolbox
```
Vérifiez l'installation.
```
./toolbox --version
```

Se connecter au serveur MCP

Installez Claude Code.
Créez le fichier .mcp.json à la racine de votre projet, s'il n'existe pas.
Ajoutez la configuration suivante, remplacez les variables d'environnement par vos valeurs, puis enregistrez. La variable FIRESTORE_DATABASE est facultative et sa valeur par défaut est (default).

 {
    "mcpServers": {
      "firestore": {
        "command": "./PATH/TO/toolbox",
        "args": ["--prebuilt","firestore","--stdio"],
        "env": {
          "FIRESTORE_PROJECT": "PROJECT_ID",
          "FIRESTORE_DATABASE": "DATABASE_NAME"
        }
      }
    }
  }

Redémarrez le code Claude pour appliquer la nouvelle configuration.

Claude sur ordinateur

Installer MCP Toolbox for Databases

Téléchargez la dernière version de Toolbox en tant que binaire. Sélectionnez le fichier binaire correspondant à votre système d'exploitation et à l'architecture de votre processeur. Vous devez utiliser la version V0.15.0 ou ultérieure de Toolbox.
linux/amd64
curl -O https://storage.googleapis.com/genai-toolbox/version/linux/amd64/toolbox
Remplacez version par le numéro de version de Toolbox, par exemple v0.15.0.
darwin/arm64
curl -O https://storage.googleapis.com/genai-toolbox/version/darwin/arm64/toolbox
Remplacez version par le numéro de version de Toolbox, par exemple v0.15.0.
darwin/amd64
curl -O https://storage.googleapis.com/genai-toolbox/version/darwin/amd64/toolbox
Remplacez version par le numéro de version de Toolbox, par exemple v0.15.0.
windows/amd64
curl -O https://storage.googleapis.com/genai-toolbox/version/windows/amd64/toolbox
Remplacez version par le numéro de version de Toolbox, par exemple v0.15.0.
Rendez le binaire exécutable.
```
chmod +x toolbox
```
Vérifiez l'installation.
```
./toolbox --version
```

Se connecter au serveur MCP

Ouvrez Claude Desktop et accédez à Settings (Paramètres).
Dans l'onglet Développeur, cliquez sur Modifier la configuration pour ouvrir le fichier de configuration.
Ajoutez la configuration suivante, remplacez les variables d'environnement par vos valeurs, puis enregistrez. La variable FIRESTORE_DATABASE est facultative et sa valeur par défaut est (default).

 {
    "mcpServers": {
      "firestore": {
        "command": "./PATH/TO/toolbox",
        "args": ["--prebuilt","firestore","--stdio"],
        "env": {
          "FIRESTORE_PROJECT": "PROJECT_ID",
          "FIRESTORE_DATABASE": "DATABASE_NAME"
        }
      }
    }
  }

Redémarrez Claude Desktop.
Sur le nouvel écran de chat, une icône en forme de marteau (MCP) devrait s'afficher avec le nouveau serveur MCP disponible.

Cline

Installer MCP Toolbox for Databases

Téléchargez la dernière version de Toolbox en tant que binaire. Sélectionnez le fichier binaire correspondant à votre système d'exploitation et à l'architecture de votre processeur. Vous devez utiliser la version V0.15.0 ou ultérieure de Toolbox.
linux/amd64
curl -O https://storage.googleapis.com/genai-toolbox/version/linux/amd64/toolbox
Remplacez version par le numéro de version de Toolbox, par exemple v0.15.0.
darwin/arm64
curl -O https://storage.googleapis.com/genai-toolbox/version/darwin/arm64/toolbox
Remplacez version par le numéro de version de Toolbox, par exemple v0.15.0.
darwin/amd64
curl -O https://storage.googleapis.com/genai-toolbox/version/darwin/amd64/toolbox
Remplacez version par le numéro de version de Toolbox, par exemple v0.15.0.
windows/amd64
curl -O https://storage.googleapis.com/genai-toolbox/version/windows/amd64/toolbox
Remplacez version par le numéro de version de Toolbox, par exemple v0.15.0.
Rendez le binaire exécutable.
```
chmod +x toolbox
```
Vérifiez l'installation.
```
./toolbox --version
```

Se connecter au serveur MCP

Ouvrez l'extension Cline dans VS Code, puis appuyez sur l'icône Serveurs MCP.
Cliquez sur Configurer les serveurs MCP pour ouvrir le fichier de configuration.
Ajoutez la configuration suivante, remplacez les variables d'environnement par vos valeurs, puis enregistrez. La variable FIRESTORE_DATABASE est facultative et sa valeur par défaut est (default).

 {
    "mcpServers": {
      "firestore": {
        "command": "./PATH/TO/toolbox",
        "args": ["--prebuilt","firestore","--stdio"],
        "env": {
          "FIRESTORE_PROJECT": "PROJECT_ID",
          "FIRESTORE_DATABASE": "DATABASE_NAME"
        }
      }
    }
  }

Un état actif vert s'affiche une fois que le serveur est connecté.

Cursor

Installer MCP Toolbox for Databases

Téléchargez la dernière version de Toolbox en tant que binaire. Sélectionnez le fichier binaire correspondant à votre système d'exploitation et à l'architecture de votre processeur. Vous devez utiliser la version V0.15.0 ou ultérieure de Toolbox.
linux/amd64
curl -O https://storage.googleapis.com/genai-toolbox/version/linux/amd64/toolbox
Remplacez version par le numéro de version de Toolbox, par exemple v0.15.0.
darwin/arm64
curl -O https://storage.googleapis.com/genai-toolbox/version/darwin/arm64/toolbox
Remplacez version par le numéro de version de Toolbox, par exemple v0.15.0.
darwin/amd64
curl -O https://storage.googleapis.com/genai-toolbox/version/darwin/amd64/toolbox
Remplacez version par le numéro de version de Toolbox, par exemple v0.15.0.
windows/amd64
curl -O https://storage.googleapis.com/genai-toolbox/version/windows/amd64/toolbox
Remplacez version par le numéro de version de Toolbox, par exemple v0.15.0.
Rendez le binaire exécutable.
```
chmod +x toolbox
```
Vérifiez l'installation.
```
./toolbox --version
```

Se connecter au serveur MCP

Créez le répertoire .cursor dans la racine de votre projet s'il n'existe pas.
Créez le fichier .cursor/mcp.json s'il n'existe pas, puis ouvrez-le.
Ajoutez la configuration suivante, remplacez les variables d'environnement par vos valeurs, puis enregistrez. La variable FIRESTORE_DATABASE est facultative et sa valeur par défaut est (default).

 {
    "mcpServers": {
      "firestore": {
        "command": "./PATH/TO/toolbox",
        "args": ["--prebuilt","firestore","--stdio"],
        "env": {
          "FIRESTORE_PROJECT": "PROJECT_ID",
          "FIRESTORE_DATABASE": "DATABASE_NAME"
        }
      }
    }
  }

Ouvrez Cursor, puis accédez à Settings > Cursor Settings > MCP (Paramètres > Paramètres du curseur > MCP). Un état actif vert s'affiche lorsque le serveur se connecte.

Visual Studio Code (Copilot)

Installer MCP Toolbox for Databases

Téléchargez la dernière version de Toolbox en tant que binaire. Sélectionnez le fichier binaire correspondant à votre système d'exploitation et à l'architecture de votre processeur. Vous devez utiliser la version V0.15.0 ou ultérieure de Toolbox.
linux/amd64
curl -O https://storage.googleapis.com/genai-toolbox/version/linux/amd64/toolbox
Remplacez version par le numéro de version de Toolbox, par exemple v0.15.0.
darwin/arm64
curl -O https://storage.googleapis.com/genai-toolbox/version/darwin/arm64/toolbox
Remplacez version par le numéro de version de Toolbox, par exemple v0.15.0.
darwin/amd64
curl -O https://storage.googleapis.com/genai-toolbox/version/darwin/amd64/toolbox
Remplacez version par le numéro de version de Toolbox, par exemple v0.15.0.
windows/amd64
curl -O https://storage.googleapis.com/genai-toolbox/version/windows/amd64/toolbox
Remplacez version par le numéro de version de Toolbox, par exemple v0.15.0.
Rendez le binaire exécutable.
```
chmod +x toolbox
```
Vérifiez l'installation.
```
./toolbox --version
```

Se connecter au serveur MCP

Ouvrez VS Code et créez le répertoire .vscode à la racine de votre projet s'il n'existe pas.
Créez le fichier .vscode/mcp.json s'il n'existe pas, puis ouvrez-le.
Ajoutez la configuration suivante, remplacez les variables d'environnement par vos valeurs, puis enregistrez. La variable FIRESTORE_DATABASE est facultative et sa valeur par défaut est (default).

 {
    "servers":{
      "firestore": {
        "command": "./PATH/TO/toolbox",
        "args": ["--prebuilt","firestore","--stdio"],
        "env": {
          "FIRESTORE_PROJECT": "PROJECT_ID",
          "FIRESTORE_DATABASE": "DATABASE_NAME"
        }
      }
    }
  }

Windsurf

Installer MCP Toolbox for Databases

Téléchargez la dernière version de Toolbox en tant que binaire. Sélectionnez le fichier binaire correspondant à votre système d'exploitation et à l'architecture de votre processeur. Vous devez utiliser la version V0.15.0 ou ultérieure de Toolbox.
linux/amd64
curl -O https://storage.googleapis.com/genai-toolbox/version/linux/amd64/toolbox
Remplacez version par le numéro de version de Toolbox, par exemple v0.15.0.
darwin/arm64
curl -O https://storage.googleapis.com/genai-toolbox/version/darwin/arm64/toolbox
Remplacez version par le numéro de version de Toolbox, par exemple v0.15.0.
darwin/amd64
curl -O https://storage.googleapis.com/genai-toolbox/version/darwin/amd64/toolbox
Remplacez version par le numéro de version de Toolbox, par exemple v0.15.0.
windows/amd64
curl -O https://storage.googleapis.com/genai-toolbox/version/windows/amd64/toolbox
Remplacez version par le numéro de version de Toolbox, par exemple v0.15.0.
Rendez le binaire exécutable.
```
chmod +x toolbox
```
Vérifiez l'installation.
```
./toolbox --version
```

Se connecter au serveur MCP

Ouvrez Windsurf et accédez à l'assistant Cascade.
Cliquez sur l'icône MCP, puis sur Configurer pour ouvrir le fichier de configuration.
Ajoutez la configuration suivante, remplacez les variables d'environnement par vos valeurs, puis enregistrez. La variable FIRESTORE_DATABASE est facultative et sa valeur par défaut est (default).

 {
    "mcpServers": {
      "firestore": {
        "command": "./PATH/TO/toolbox",
        "args": ["--prebuilt","firestore","--stdio"],
        "env": {
          "FIRESTORE_PROJECT": "PROJECT_ID",
          "FIRESTORE_DATABASE": "DATABASE_NAME"
        }
      }
    }
  }

Utiliser Firestore avec MCP, la CLI Gemini et d'autres agents

À propos de la CLI Gemini et des extensions

Fonctionnement des extensions

Utiliser l'extension CLI Gemini pour Firestore

Avant de commencer

Configurer Firestore

Configurer le client MCP

CLI Gemini

Gemini Code Assist

Code Claude

Installer MCP Toolbox for Databases

linux/amd64

darwin/arm64

darwin/amd64

windows/amd64

Se connecter au serveur MCP

Claude sur ordinateur

Installer MCP Toolbox for Databases

linux/amd64

darwin/arm64

darwin/amd64

windows/amd64

Se connecter au serveur MCP

Cline

Installer MCP Toolbox for Databases

linux/amd64

darwin/arm64

darwin/amd64

windows/amd64

Se connecter au serveur MCP

Cursor

Installer MCP Toolbox for Databases

linux/amd64

darwin/arm64

darwin/amd64

windows/amd64

Se connecter au serveur MCP

Visual Studio Code (Copilot)

Installer MCP Toolbox for Databases

linux/amd64

darwin/arm64

darwin/amd64

windows/amd64

Se connecter au serveur MCP

Windsurf

Installer MCP Toolbox for Databases

linux/amd64

darwin/arm64

darwin/amd64

windows/amd64

Se connecter au serveur MCP