Google utilise la technologie IA pour traduire le contenu dans votre langue préférée. Les traductions générées par IA peuvent contenir des erreurs.

Utiliser Spanner avec MCP Toolbox for Databases, la CLI Gemini et d'autres agents

Ce document explique comment connecter votre instance Spanner à différents outils pour les développeurs compatibles avec le protocole MCP (Model Context Protocol).

Nous vous recommandons d'utiliser l'extension Spanner dédiée pour Gemini CLI. L'extension regroupe les compétences sous-jacentes directement dans l'extension, ce qui simplifie la configuration. 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 en savoir plus, consultez Extension Gemini CLI – Spanner.

Vous pouvez également utiliser d'autres IDE et outils pour les développeurs compatibles avec MCP pour vous connecter via MCP Toolbox for Databases. MCP Toolbox est un serveur MCP Open Source conçu pour connecter les agents d'IA à vos données. Il gère des tâches telles que l'authentification et le regroupement de connexions, ce qui vous permet d'interagir avec vos données en langage naturel directement depuis votre IDE.

Utiliser l'extension Gemini CLI dans Spanner

L'intégration de Spanner à Gemini CLI se fait via une extension Open Source qui offre des fonctionnalités supplémentaires par rapport à la connexion standard MCP Toolbox. L'extension propose un processus d'installation simplifié et un ensemble de compétences basées sur les outils MCP. Si vous utilisez l'extension Gemini CLI, vous n'avez pas besoin d'installer MCP Toolbox. Pour en savoir plus, consultez Extension Gemini CLI – Spanner.

L'extension spanner inclut des compétences permettant de lister les tables et d'exécuter des instructions SQL et SQL DQL.

Pour connaître toutes les compétences disponibles, consultez les compétences Spanner sur GitHub.

Avant de commencer

Dans la console Google Cloud , sur la page de sélection du projet, sélectionnez ou créez un projet Google Cloud .
Assurez-vous que la facturation est activée pour votre projet Google Cloud .

Configurer l'instance Spanner

Activez l'API Spanner dans le projet Google Cloud .
Créez ou sélectionnez une instance et une base de données Spanner.
Configurez les rôles et autorisations requis pour effectuer cette tâche. L'utilisateur qui appelle les agents LLM a besoin des rôles suivants au niveau de la base de données :
- Lecteur de bases de données Cloud Spanner (roles/spanner.databaseReader) pour exécuter des requêtes LQD et lister les tables.
- Utilisateur de bases de données Cloud Spanner (roles/spanner.databaseUser) pour exécuter des requêtes LMD.
Configurez les identifiants par défaut de l'application (ADC) pour votre environnement.

Installer MCP Toolbox

Téléchargez la dernière version de MCP Toolbox en tant que binaire. Sélectionnez le binaire correspondant à votre système d'exploitation (OS) et à l'architecture de votre processeur. Vous devez utiliser MCP Toolbox version 0.15.0 ou ultérieure :

linux/amd64

curl -O https://storage.googleapis.com/mcp-toolbox-for-databases/version/linux/amd64/toolbox

darwin/arm64

curl -O https://storage.googleapis.com/mcp-toolbox-for-databases/version/darwin/arm64/toolbox

darwin/amd64

curl -O https://storage.googleapis.com/mcp-toolbox-for-databases/version/darwin/amd64/toolbox

windows/amd64

curl -O https://storage.googleapis.com/mcp-toolbox-for-databases/version/windows/amd64/toolbox

Rendez le binaire exécutable :
```
chmod +x toolbox
```
Vérifiez l'installation :
```
./toolbox --version
```

Configurer les clients et les connexions

Cette section explique comment configurer différents outils pour les développeurs afin de vous connecter à votre instance Spanner. Sélectionnez votre client parmi les options suivantes :

CLI Gemini

Installez la Gemini CLI.
Installez l'extension Spanner pour Gemini CLI à partir du dépôt GitHub à l'aide de la commande suivante :
```
gemini extensions install https://github.com/gemini-cli-extensions/spanner
```
Définissez les variables d'environnement suivantes pour vous connecter à votre instance Spanner :
```
export SPANNER_PROJECT="PROJECT_ID"
export SPANNER_INSTANCE="INSTANCE_NAME"
export SPANNER_DATABASE="DATABASE_NAME"
export SPANNER_DIALECT="DIALECT_NAME"
```
Remplacez les éléments suivants :
- PROJECT_ID : ID du projet Google Cloud .
- INSTANCE_NAME : nom de l'instance Spanner.
- DATABASE_NAME : nom de la base de données Spanner.
- DIALECT_NAME : dialecte SQL Spanner. Accepte googlesql ou postgresql. La valeur par défaut est googlesql si elle n'est pas définie.
Démarrez la Gemini CLI en mode interactif :
```
gemini
```
La CLI charge automatiquement l'extension Spanner pour Gemini CLI et ses compétences, que vous pouvez utiliser pour interagir avec votre base de données.

Dans Gemini CLI, exécutez la commande /extensions pour vérifier que l'extension est installée.

Gemini Code Assist

Nous vous recommandons vivement de configurer Gemini Code Assist pour qu'il utilise la CLI Gemini, car cette approche élimine la nécessité de configurer manuellement un serveur MCP. Toutefois, les instructions pour configurer manuellement un serveur MCP sont toujours disponibles dans la section suivante :

1. Installez l'extension Gemini Code Assist dans VS Code.
2. Activez le mode Agent et définissez le modèle d'agent sur Gemini.
3. Dans le répertoire racine de votre projet, créez un dossier nommé .gemini, puis un fichier settings.json.
4. Ajoutez l'une des configurations suivantes en fonction de votre dialecte Spanner dans le fichier settings.json.
5. Remplacez les variables suivantes par vos valeurs :

PROJECT_ID : ID de votre projet Google Cloud .
INSTANCE_NAME : nom de votre instance Spanner.
DATABASE_NAME : nom de votre base de données Spanner.

6. Enregistrez le fichier.

Spanner avec le dialecte GoogleSQL :

{
  "mcpServers": {
    "spanner": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt","spanner","--stdio"],
      "env": {
          "SPANNER_PROJECT": "PROJECT_ID",
          "SPANNER_INSTANCE": "INSTANCE_NAME",
          "SPANNER_DATABASE": "DATABASE_NAME"
      }
    }
  }
}

Spanner avec le dialecte PostgreSQL :

{
  "mcpServers": {
    "spanner": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt","spanner-postgres","--stdio"],
      "env": {
          "SPANNER_PROJECT": "PROJECT_ID",
          "SPANNER_INSTANCE": "INSTANCE_NAME",
          "SPANNER_DATABASE": "DATABASE_NAME"
      }
    }
  }
}

Claude Code

Installez Claude Code.
Définissez les variables d'environnement pour vous connecter à votre instance Spanner :
```
export SPANNER_PROJECT="PROJECT_ID"
export SPANNER_INSTANCE="INSTANCE_NAME"
export SPANNER_DATABASE="DATABASE_NAME"
export SPANNER_DIALECT="DIALECT_NAME"
```
Remplacez les éléments suivants :
- PROJECT_ID : ID du projet Google Cloud .
- INSTANCE_NAME : nom de l'instance Spanner.
- DATABASE_NAME : nom de la base de données Spanner.
- DIALECT_NAME : dialecte SQL Spanner. Accepte googlesql ou postgresql. La valeur par défaut est googlesql si elle n'est pas définie.
Démarrez l'agent :
```
claude
```

Installez le plug-in :

/plugin install spanner@claude-plugins-official

Conseil : Exécutez /plugin list dans Claude Code pour vérifier que le plug-in est actif, ou /reload-plugins si vous venez de l'installer.

Codex

Installez le marketplace des plug-ins Data Cloud :

codex plugin marketplace add GoogleCloudPlatform/data-cloud-plugins

Installez le plug-in Spanner :

codex plugin install spanner@data-cloud-plugins

Configurez les variables d'environnement pour vous connecter à votre instance Spanner :
```
export SPANNER_PROJECT="PROJECT_ID"
export SPANNER_INSTANCE="INSTANCE_NAME"
export SPANNER_DATABASE="DATABASE_NAME"
export SPANNER_DIALECT="DIALECT_NAME"
```
Remplacez les éléments suivants :
- PROJECT_ID : ID du projet Google Cloud .
- INSTANCE_NAME : nom de l'instance Spanner.
- DATABASE_NAME : nom de la base de données Spanner.
- DIALECT_NAME : dialecte SQL Spanner. Accepte googlesql ou postgresql. La valeur par défaut est googlesql si elle n'est pas définie.

Facultatif. Mettez à jour la marketplace :

codex plugin marketplace upgrade data-cloud-plugins

Claude pour ordinateur

1. Ouvrez Claude pour ordinateur et accédez à Paramètres.
2. Dans l'onglet Développeur, cliquez sur Modifier la configuration pour ouvrir le fichier de configuration.
3. Ajoutez l'une des configurations suivantes en fonction de votre dialecte Spanner, remplacez les variables d'environnement par vos valeurs et enregistrez le fichier :

Spanner avec le dialecte GoogleSQL :

{
  "mcpServers": {
    "spanner": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt","spanner","--stdio"],
      "env": {
          "SPANNER_PROJECT": "PROJECT_ID",
          "SPANNER_INSTANCE": "INSTANCE_NAME",
          "SPANNER_DATABASE": "DATABASE_NAME"
      }
    }
  }
}

Spanner avec le dialecte PostgreSQL :

{
  "mcpServers": {
    "spanner": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt","spanner-postgres","--stdio"],
      "env": {
          "SPANNER_PROJECT": "PROJECT_ID",
          "SPANNER_INSTANCE": "INSTANCE_NAME",
          "SPANNER_DATABASE": "DATABASE_NAME"
      }
    }
  }
}

4. Redémarrez Claude pour ordinateur.
5. Le nouvel écran de chat affiche une icône en forme de marteau (MCP) avec le nouveau serveur MCP.

Cline

1. Ouvrez l'extension Cline dans VS Code, puis cliquez sur l'icône Serveurs MCP.
2. Appuyez sur "Configurer les serveurs MCP" pour ouvrir le fichier de configuration.
3. Ajoutez l'une des configurations suivantes en fonction de votre dialecte Spanner, remplacez les variables d'environnement par vos valeurs et enregistrez le fichier :

Spanner avec le dialecte GoogleSQL :

{
  "mcpServers": {
    "spanner": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt","spanner","--stdio"],
      "env": {
          "SPANNER_PROJECT": "PROJECT_ID",
          "SPANNER_INSTANCE": "INSTANCE_NAME",
          "SPANNER_DATABASE": "DATABASE_NAME"
      }
    }
  }
}

Spanner avec le dialecte PostgreSQL :

{
  "mcpServers": {
    "spanner": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt","spanner-postgres","--stdio"],
      "env": {
          "SPANNER_PROJECT": "PROJECT_ID",
          "SPANNER_INSTANCE": "INSTANCE_NAME",
          "SPANNER_DATABASE": "DATABASE_NAME"
      }
    }
  }
}

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

Cursor

1. Créez le répertoire .cursor dans la racine de votre projet s'il n'existe pas.
2. Créez le fichier .cursor/mcp.json s'il n'existe pas et ouvrez-le.
3. Ajoutez l'une des configurations suivantes en fonction de votre dialecte Spanner, remplacez les variables d'environnement par vos valeurs et enregistrez le fichier :

Spanner avec le dialecte GoogleSQL :

{
  "mcpServers": {
    "spanner": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt","spanner","--stdio"],
      "env": {
          "SPANNER_PROJECT": "PROJECT_ID",
          "SPANNER_INSTANCE": "INSTANCE_NAME",
          "SPANNER_DATABASE": "DATABASE_NAME"
      }
    }
  }
}

Spanner avec le dialecte PostgreSQL :

{
  "mcpServers": {
    "spanner": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt","spanner-postgres","--stdio"],
      "env": {
          "SPANNER_PROJECT": "PROJECT_ID",
          "SPANNER_INSTANCE": "INSTANCE_NAME",
          "SPANNER_DATABASE": "DATABASE_NAME"
      }
    }
  }
}

4. Ouvrez Cursor, puis accédez à Settings > Cursor Settings > MCP. Un état actif vert s'affiche lorsque le serveur se connecte.

Visual Studio Code (Copilot)

1. Ouvrez VS Code et créez le répertoire .vscode à la racine de votre projet, s'il n'existe pas.
2. Créez le fichier .vscode/mcp.json s'il n'existe pas, puis ouvrez-le.
3. Ajoutez l'une des configurations suivantes en fonction de votre dialecte Spanner, remplacez les variables d'environnement par vos valeurs et enregistrez le fichier :

Spanner avec le dialecte GoogleSQL :

{
  "servers": {
    "spanner": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt","spanner","--stdio"],
      "env": {
        "SPANNER_PROJECT": "PROJECT_ID",
        "SPANNER_INSTANCE": "INSTANCE_NAME",
        "SPANNER_DATABASE": "DATABASE_NAME"
      }
    }
  }
}

Spanner avec le dialecte PostgreSQL :

{
  "servers": {
    "spanner": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt","spanner-postgres","--stdio"],
      "env": {
        "SPANNER_PROJECT": "PROJECT_ID",
        "SPANNER_INSTANCE": "INSTANCE_NAME",
        "SPANNER_DATABASE": "DATABASE_NAME"
      }
    }
  }
}

Planche à voile

1. Ouvrez Windsurf et accédez à l'assistant Cascade.
2. Cliquez sur l'icône MCP, puis sur Configurer pour ouvrir le fichier de configuration.
3. Ajoutez l'une des configurations suivantes en fonction de votre dialecte Spanner, remplacez les variables d'environnement par vos valeurs et enregistrez le fichier :

Spanner avec le dialecte GoogleSQL :

{
  "mcpServers": {
    "spanner": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt","spanner","--stdio"],
      "env": {
          "SPANNER_PROJECT": "PROJECT_ID",
          "SPANNER_INSTANCE": "INSTANCE_NAME",
          "SPANNER_DATABASE": "DATABASE_NAME"
      }
    }
  }
}

Spanner avec le dialecte PostgreSQL :

{
  "mcpServers": {
    "spanner": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt","spanner-postgres","--stdio"],
      "env": {
          "SPANNER_PROJECT": "PROJECT_ID",
          "SPANNER_INSTANCE": "INSTANCE_NAME",
          "SPANNER_DATABASE": "DATABASE_NAME"
      }
    }
  }
}

Se connecter à Antigravity

Vous pouvez connecter Spanner à Antigravity de différentes manières :

Utiliser le MCP Store
Utiliser une configuration personnalisée

Boutique MCP

La méthode la plus recommandée pour se connecter à Antigravity consiste à utiliser le MCP Store intégré.

Ouvrez Antigravity, puis le panneau de l'agent de l'éditeur.
Cliquez sur l'icône Menu en haut du panneau, puis sélectionnez Serveurs MCP.
Localisez Spanner dans la liste des serveurs disponibles, puis cliquez sur Installer.
Suivez les instructions à l'écran pour autoriser Antigravity à accéder à votre projet Google Cloud. Cela permet à Antigravity d'accéder à l'instance Spanner de votre projet.

Une fois que vous avez installé le serveur Spanner dans le MCP Store, les ressources et les compétences du serveur sont disponibles dans l'éditeur.

Configuration personnalisée

Pour vous connecter à un serveur MCP personnalisé, procédez comme suit :

Ouvrez Antigravity, puis le panneau de l'agent de l'éditeur.
Cliquez sur l'icône Menu en haut du panneau, puis sélectionnez Serveurs MCP.
Cliquez sur Gérer les serveurs MCP > Afficher la configuration brute pour ouvrir le fichier mcp_config.json.
Ajoutez la configuration suivante, remplacez les variables d'environnement par vos valeurs et enregistrez.

{
  "mcpServers": {
    "spanner": {
      "command": "npx",
      "args": ["-y","@toolbox-sdk/server","--prebuilt","spanner","--stdio"],
      "env": {
          "SPANNER_PROJECT": "PROJECT_ID",
          "SPANNER_INSTANCE": "INSTANCE_NAME",
          "SPANNER_DATABASE": "DATABASE_NAME",
          "SPANNER_DIALECT": "DIALECT_NAME"
      }
    }
  }
}

Une fois le serveur MCP personnalisé configuré, les ressources et les compétences du serveur Spanner sont disponibles pour l'éditeur.

Remplacez les éléments suivants :

PROJECT_ID : ID de votre projet Google Cloud .
INSTANCE_NAME : nom de votre instance Spanner.
DATABASE_NAME : nom de votre base de données Spanner.
DIALECT_NAME : votre dialecte Spanner SQL. Accepte googlesql ou postgresql. Si vous ne spécifiez pas de dialecte, la valeur par défaut est googlesql.

Se connecter à Spanner à l'aide de Data Agent Kit

Google Cloud Data Agent Kit vous permet de gérer votre base de données Spanner et d'exécuter des requêtes sur vos données Spanner dans l'IDE ou l'agent de codage de votre choix. L'extension Data Agent Kit fonctionne avec Visual Studio Code et les IDE basés sur VS Code. Le plug-in Data Agent Kit fonctionne avec un certain nombre d'agents de codage populaires, y compris Claude Code et Codex CLI.

Data Agent Kit offre des fonctionnalités de découverte et d'exploration des données, ce qui vous permet de poser des questions sur vos données Spanner en langage naturel. Cela permet d'éliminer le changement de contexte entre les outils de ligne de commande Spanner et votre environnement de développement.

Pour en savoir plus, consultez la présentation du Data Agent Kit.

Utiliser Spanner avec MCP Toolbox for Databases, la CLI Gemini et d'autres agents Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

Utiliser l'extension Gemini CLI dans Spanner

Avant de commencer

Configurer l'instance Spanner

Installer MCP Toolbox

linux/amd64

darwin/arm64

darwin/amd64

windows/amd64

Configurer les clients et les connexions

CLI Gemini

Gemini Code Assist

Claude Code

Codex

Claude pour ordinateur

Cline

Cursor

Visual Studio Code (Copilot)

Planche à voile

Se connecter à Antigravity

Boutique MCP

Configuration personnalisée

Se connecter à Spanner à l'aide de Data Agent Kit

Utiliser Spanner avec MCP Toolbox for Databases, la CLI Gemini et d'autres agents