Cette page explique comment connecter votre instance Cloud SQL à différents outils d'assistance IA pour les développeurs, y compris les suivants :
- Gemini Code Assist
- Claude Code
- Claude pour ordinateur
- Codex
- Cline (extension VS Code)
- Cursor
- Visual Studio Code (Copilot)
- Windsurf (Codeium)
- Antigravity
Pour une expérience intégrée, nous vous recommandons d'utiliser l'extension Gemini CLI dédiée pour Cloud SQL pour MySQL.
En tant qu'interface de ligne de commande de nouvelle génération de Google Cloud, Gemini CLI intègre 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 les autres outils pour les développeurs compatibles avec le protocole MCP (Model Context Protocol), vous pouvez vous connecter en configurant manuellement la MCP Toolbox for Databases (Toolbox). Toolbox est un serveur MCP Open Source qui connecte les agents 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.
Pour en savoir plus, consultez Outils prédéfinis et MCP Toolbox for Databases sur GitHub.
À propos de Gemini CLI et des extensions
Gemini CLI est un agent IA Open Source conçu pour faciliter les workflows de développement en vous aidant à coder, à déboguer, à explorer des données et à créer du contenu. Il fournit une interface agentive pour interagir avec les services de base de données et d'analyse, ainsi qu'avec les bases de données Open Source populaires.
Fonctionnement des extensions
Gemini CLI est hautement extensible, ce qui permet d'ajouter de nouveaux outils et de nouvelles fonctionnalités via des 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 à barre oblique, des compétences et des prompts pour vous aider dans votre workflow.
Utiliser les extensions Gemini CLI dans Cloud SQL pour MySQL
L'extension Gemini CLI pour Cloud SQL est basée sur MCP Toolbox pour les bases de données.
L'intégration à Gemini CLI s'effectue via une extension dédiée qui offre des fonctionnalités supplémentaires par rapport à la connexion Toolbox standard. L'extension propose un processus d'installation simplifié et un ensemble de compétences basées sur les outils MCP.
Pour en savoir plus, consultez la documentation GitHub sur l'extension Gemini CLI pour Cloud SQL pour MySQL.Extension Gemini CLI pour les bases de données Cloud SQL pour MySQL
L'extensioncloud-sql-mysql inclut des compétences pour interroger la base de données et surveiller son état.
Pour connaître toutes les compétences disponibles, consultez les compétences Cloud SQL sur GitHub.
L'extension cloud-sql-mysql-observability fournit une interface unifiée pour gérer et surveiller les performances et l'état des bases de données directement depuis la CLI Gemini.
| Catégorie | Outils |
|---|---|
| Observabilité |
|
Extension Gemini CLI pour les bases de données MySQL
Pour obtenir la liste de ces opérations, consultez MCP Toolbox for Databases et Extension Gemini CLI pour MySQL.
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 .
Par défaut, Cloud SQL attribue une adresse IP publique à une nouvelle instance. Selon votre cas d'utilisation, assurez-vous qu'une adresse IP publique ou une adresse IP privée est configurée pour vos instances Cloud SQL. Toolbox se connecte de manière sécurisée à l'aide des connecteurs de langage Cloud SQL.
Attribuez les rôles Identity and Access Management (IAM) nécessaires à l'utilisateur qui exécutera le serveur MCP. Les outils disponibles dépendent des rôles attribués :
Tâche Nom du rôle Rôle IAM requis Fournit un accès en lecture seule aux ressources, y compris aux opérations suivantes : get_instancelist_instanceslist_databaseswait_for_operation
Lecteur Cloud SQL roles/cloudsql.viewerFournit un accès en lecture seule aux données de surveillance telles que les métriques de séries temporelles. Lecteur Cloud Monitoring roles/monitoring.viewerFournit des autorisations permettant de gérer les ressources existantes, y compris les suivantes : - Tous les outils
viewer create_database
Éditeur Cloud SQL roles/cloudsql.editorFournit un contrôle total sur toutes les ressources, y compris les suivantes : - Tous les outils
viewereteditor create_instancecreate_user
Administrateur Cloud SQL roles/cloudsql.adminConfigurez les identifiants par défaut de l'application (ADC) pour votre environnement.
Créez ou réutilisez un utilisateur de base de données, et préparez le nom d'utilisateur et le mot de passe.
Se connecter avec Data Agent Kit
L'extension Google Cloud Data Agent Kit vous permet de vous connecter à Cloud SQL et de l'interroger depuis Visual Studio Code ou n'importe quel IDE basé sur VS Code. Il vous permet de vous connecter aux serveurs MCP, d'interroger des données et d'exécuter des charges de travail d'ingénierie des données depuis votre IDE. Data Agent Kit fournit également des plug-ins de CLI.
Pour en savoir plus, consultez Présentation du Data Agent Kit.
Se connecter avec Antigravity
Vous pouvez connecter Cloud SQL pour MySQL à Antigravity de l'une des manières suivantes :
- Utiliser le MCP Store
- Utiliser une configuration personnalisée
MCP Store
La méthode la plus recommandée pour se connecter à Cloud SQL pour MySQL dans Antigravity consiste à utiliser le MCP Store intégré.
- Ouvrez Antigravity, puis le panneau de l'agent de l'éditeur.
- Cliquez sur l'icône "..." en haut du panneau, puis sélectionnez Serveurs MCP.
- Localisez Cloud SQL pour MySQL dans la liste des serveurs disponibles, puis cliquez sur Installer.
- Suivez les instructions à l'écran pour associer vos comptes de manière sécurisée, le cas échéant.
Une fois que vous avez installé Cloud SQL pour MySQL dans le MCP Store, les ressources et les outils du serveur sont automatiquement disponibles pour 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 "..." 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, puis enregistrez.
{
"mcpServers": {
"cloud-sql-mysql": {
"command": "npx",
"args": ["-y","@toolbox-sdk/server","--prebuilt","cloud-sql-mysql","--stdio"],
"env": {
"CLOUD_SQL_MYSQL_PROJECT": "PROJECT_ID",
"CLOUD_SQL_MYSQL_REGION": "REGION",
"CLOUD_SQL_MYSQL_INSTANCE": "INSTANCE_ID",
"CLOUD_SQL_MYSQL_DATABASE": "DATABASE_NAME",
"CLOUD_SQL_MYSQL_USER": "USER_ID",
"CLOUD_SQL_MYSQL_PASSWORD": "PASSWORD"
}
}
}
}
Une fois que vous avez configuré le serveur MCP personnalisé, les ressources et les outils du serveur Cloud SQL pour MySQL sont disponibles pour l'éditeur.
Installer MCP Toolbox
- Téléchargez le binaire correspondant à votre système d'exploitation et à l'architecture de votre processeur.
linux/amd64
curl -O https://storage.googleapis.com/genai-toolbox/v0.7.0/linux/amd64/toolbox
darwin/arm64
curl -O https://storage.googleapis.com/genai-toolbox/v0.7.0/darwin/arm64/toolbox
darwin/amd64
curl -O https://storage.googleapis.com/genai-toolbox/v0.7.0/darwin/amd64/toolbox
windows/amd64
curl -O https://storage.googleapis.com/genai-toolbox/v0.7.0/windows/amd64/toolbox
- Rendez le binaire exécutable :
chmod +x toolbox
- Vérifiez l'installation à l'aide de la commande suivante :
./toolbox --version
Configurer le client MCP
Cette section explique comment configurer différents outils pour les développeurs pour vous connecter à votre instance Cloud SQL à l'aide de Toolbox. Toolbox agit comme un serveur Model Context Protocol (MCP) Open Source qui se situe entre votre IDE et votre base de données, fournissant un plan de contrôle sécurisé et efficace pour vos outils d'IA. Sélectionnez l'onglet correspondant à votre outil pour afficher les instructions de configuration.
CLI Gemini pour Cloud SQL pour MySQL
- Installez la CLI Gemini.
- Installez l'extension Cloud SQL pour MySQL pour Gemini CLI à partir du dépôt GitHub à l'aide de la commande suivante :
Lors de l'installation de l'extension, remplacez les éléments suivants :gemini extensions install https://github.com/gemini-cli-extensions/cloud-sql-mysql
Remplacez les éléments suivants :export CLOUD_SQL_MYSQL_PROJECT="PROJECT_NAME" export CLOUD_SQL_MYSQL_REGION="REGION" export CLOUD_SQL_MYSQL_INSTANCE="INSTANCE_NAME" export CLOUD_SQL_MYSQL_DATABASE="DATABASE_NAME" export CLOUD_SQL_MYSQL_USER="DATABASE_USER_NAME" export CLOUD_SQL_MYSQL_PASSWORD="PASSWORD" export CLOUD_SQL_MYSQL_IP_TYPE="IP_TYPE"
- PROJECT_NAME : ID du projet Google Cloud .
- REGION : région de votre instance Cloud SQL.
- INSTANCE_NAME : ID de votre instance Cloud SQL.
- DATABASE_NAME : nom de la base de données à laquelle se connecter.
- DATABASE_USER_NAME : (facultatif) nom de l'utilisateur de la base de données. La valeur par défaut est l'authentification IAM si elle n'est pas spécifiée.
- PASSWORD (facultatif) : mot de passe de l'utilisateur de la base de données. La valeur par défaut est l'authentification IAM si elle n'est pas spécifiée.
- IP_TYPE (facultatif) : type d'adresse IP, tel que "Public" (par défaut) ou "Privé".
- Démarrez Gemini CLI en mode interactif :
gemini
La CLI charge automatiquement l'extension Gemini CLI pour Cloud SQL et ses outils, que vous pouvez utiliser pour interagir avec votre base de données.
Dans la CLI Gemini, utilisez la commande
/extensionspour vérifier que l'extension est installée et la commande/mcp listpour afficher les outils.
Gemini CLI pour MySQL
- Installez la CLI Gemini.
- Installez l'extension logicielle MySQL pour Gemini CLI à partir du dépôt GitHub à l'aide de la commande suivante :
Lors de l'installation de l'extension, remplacez les éléments suivants :gemini extensions install https://github.com/gemini-cli-extensions/mysql
Remplacez les éléments suivants :export MYSQL_HOST="HOST" export MYSQL_PORT="PORT" export MYSQL_DATABASE="DATABASE" export MYSQL_USER="USER" export MYSQL_PASSWORD="PASSWORD" export MYSQL_QUERY_PARAMETERS="QUERY_PARAMETERS"
- HOST : nom d'hôte ou adresse IP du serveur MySQL.
- PORT : numéro de port du serveur MySQL.
- DATABASE : nom de la base de données à laquelle se connecter.
- USER : nom de l'utilisateur de base de données.
- PASSWORD : mot de passe de l'utilisateur de la base de données.
- QUERY_PARAMETERS (facultatif) : requête brute à ajouter à la chaîne de connexion
db.
- Démarrez Gemini CLI en mode interactif :
gemini
La CLI charge automatiquement l'extension Gemini CLI pour MySQL et ses outils, que vous pouvez utiliser pour interagir avec votre base de données.
Gemini Code Assist
- Installez l'extension Gemini Code Assist dans Visual Studio Code.
- Activez le mode Agent dans le chat Gemini Code Assist.
- Dans votre répertoire de travail, créez un dossier nommé
.gemini. Dans ce répertoire, créez un fichiersettings.json. - Ajoutez la configuration suivante, remplacez les variables d'environnement par vos valeurs, puis enregistrez :
{ "mcpServers": { "cloud-sql-mysql": { "command": "./PATH/TO/toolbox", "args": ["--prebuilt","cloud-sql-mysql","--stdio"], "env": { "CLOUD_SQL_MYSQL_PROJECT": "PROJECT_ID", "CLOUD_SQL_MYSQL_REGION": "REGION", "CLOUD_SQL_MYSQL_INSTANCE":"INSTANCE_ID", "CLOUD_SQL_MYSQL_DATABASE": "DATABASE_NAME", "CLOUD_SQL_MYSQL_USER": "USER_ID", "CLOUD_SQL_MYSQL_PASSWORD": "PASSWORD" } } } }
Claude Code
- Installez Claude Code.
- Définissez des variables d'environnement pour vous connecter à votre instance Cloud SQL :
Remplacez les éléments suivants :export CLOUD_SQL_MYSQL_PROJECT="PROJECT_NAME" export CLOUD_SQL_MYSQL_REGION="REGION" export CLOUD_SQL_MYSQL_INSTANCE="INSTANCE_NAME" export CLOUD_SQL_MYSQL_DATABASE="DATABASE_NAME" export CLOUD_SQL_MYSQL_USER="DATABASE_USER_NAME" export CLOUD_SQL_MYSQL_PASSWORD="PASSWORD" export CLOUD_SQL_MYSQL_IP_TYPE="IP_TYPE"
- PROJECT_NAME : ID du projet Google Cloud .
- REGION : région de votre instance Cloud SQL.
- INSTANCE_NAME : ID de votre instance Cloud SQL.
- DATABASE_NAME : nom de la base de données à laquelle se connecter.
- DATABASE_USER_NAME : (facultatif) nom de l'utilisateur de la base de données. La valeur par défaut est l'authentification IAM si aucune valeur n'est spécifiée.
- PASSWORD (facultatif) : mot de passe de l'utilisateur de la base de données. La valeur par défaut est l'authentification IAM si aucune valeur n'est spécifiée.
- IP_TYPE (facultatif) : type d'adresse IP, tel que "Public" (par défaut) ou "Privé".
- Démarrez l'agent :
claude
- Installez le plug-in :
/plugin install cloud-sql-mysql@claude-plugins-official
Claude pour ordinateur
- Ouvrez Claude Desktop et accédez à Settings (Paramètres).
- Dans l'onglet Developer (Développeur), appuyez sur Edit Config (Modifier la configuration) pour ouvrir le fichier de configuration.
- Ajoutez les éléments suivants pour vous connecter au serveur MCP et définir les variables d'environnement :
{ "mcpServers": { "cloud-sql-mysql": { "command": "./PATH/TO/toolbox", "args": ["--prebuilt","cloud-sql-mysql","--stdio"], "env": { "CLOUD_SQL_MYSQL_PROJECT": "PROJECT_ID", "CLOUD_SQL_MYSQL_REGION": "REGION", "CLOUD_SQL_MYSQL_INSTANCE":"INSTANCE_ID", "CLOUD_SQL_MYSQL_DATABASE": "DATABASE_NAME", "CLOUD_SQL_MYSQL_USER": "USER_ID", "CLOUD_SQL_MYSQL_PASSWORD": "PASSWORD" } } } } - Redémarrez Claude Desktop. Le nouvel écran de discussion affiche l'icône MCP avec le nouveau serveur MCP disponible.
Codex
- Installez la place de marché des plug-ins Data Cloud :
codex plugin marketplace add GoogleCloudPlatform/data-cloud-plugins
- Installez le plug-in :
codex plugin install cloud-sql-mysql@data-cloud-plugins
- Configurez les variables d'environnement pour vous connecter à votre instance Cloud SQL :
Remplacez les éléments suivants :export CLOUD_SQL_MYSQL_PROJECT="PROJECT_NAME" export CLOUD_SQL_MYSQL_REGION="REGION" export CLOUD_SQL_MYSQL_INSTANCE="INSTANCE_NAME" export CLOUD_SQL_MYSQL_DATABASE="DATABASE_NAME" export CLOUD_SQL_MYSQL_USER="DATABASE_USER_NAME" export CLOUD_SQL_MYSQL_PASSWORD="PASSWORD" export CLOUD_SQL_MYSQL_IP_TYPE="IP_TYPE"
- PROJECT_NAME : ID du projet Google Cloud .
- REGION : région de votre instance Cloud SQL.
- INSTANCE_NAME : ID de votre instance Cloud SQL.
- DATABASE_NAME : nom de la base de données à laquelle se connecter.
- DATABASE_USER_NAME : (facultatif) nom de l'utilisateur de la base de données. La valeur par défaut est l'authentification IAM si aucune valeur n'est spécifiée.
- PASSWORD (facultatif) : mot de passe de l'utilisateur de la base de données. La valeur par défaut est l'authentification IAM si aucune valeur n'est spécifiée.
- IP_TYPE (facultatif) : type d'adresse IP, tel que "Public" (par défaut) ou "Privé".
- Facultatif. Mettez à jour la place de marché :
codex plugin marketplace upgrade data-agent-plugins
- Exécutez
codex plugin listou utilisez le menu interactifpluginspour vérifier les plug-ins installés.
Cline
- Ouvrez l'extension Cline dans VS Code, puis appuyez sur l'icône Serveurs MCP.
- Appuyez 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 :
Un état actif vert s'affiche une fois que le serveur s'est connecté.{ "mcpServers": { "cloud-sql-mysql": { "command": "./PATH/TO/toolbox", "args": ["--prebuilt","cloud-sql-mysql","--stdio"], "env": { "CLOUD_SQL_MYSQL_PROJECT": "PROJECT_ID", "CLOUD_SQL_MYSQL_REGION": "REGION", "CLOUD_SQL_MYSQL_INSTANCE":"INSTANCE_ID", "CLOUD_SQL_MYSQL_DATABASE": "DATABASE_NAME", "CLOUD_SQL_MYSQL_USER": "USER_ID", "CLOUD_SQL_MYSQL_PASSWORD": "PASSWORD" } } } }
Cursor
- Créez un répertoire
.cursorà la racine de votre projet s'il n'existe pas. - Créez le fichier
.cursor/mcp.jsons'il n'existe pas, puis ouvrez-le. - Ajoutez la configuration suivante, remplacez les variables d'environnement par vos valeurs, puis enregistrez :
{ "mcpServers": { "cloud-sql-mysql": { "command": "./PATH/TO/toolbox", "args": ["--prebuilt","cloud-sql-mysql","--stdio"], "env": { "CLOUD_SQL_MYSQL_PROJECT": "PROJECT_ID", "CLOUD_SQL_MYSQL_REGION": "REGION", "CLOUD_SQL_MYSQL_INSTANCE":"INSTANCE_ID", "CLOUD_SQL_MYSQL_DATABASE": "DATABASE_NAME", "CLOUD_SQL_MYSQL_USER": "USER_ID", "CLOUD_SQL_MYSQL_PASSWORD": "PASSWORD" } } } } - Ouvrez Cursor, puis accédez à Settings > Cursor Settings > MCP (Paramètres > Paramètres de Cursor > MCP). Un état actif vert s'affiche lorsque le serveur se connecte.
Visual Studio Code (Copilot)
- Ouvrez VS Code et créez un répertoire
.vscodedans la racine de votre projet s'il n'existe pas. - Créez le fichier
.vscode/mcp.jsons'il n'existe pas, puis ouvrez-le. - Ajoutez la configuration suivante, remplacez les variables d'environnement par vos valeurs, puis enregistrez :
{ "servers": { "cloud-sql-mysql": { "command": "./PATH/TO/toolbox", "args": ["--prebuilt","cloud-sql-mysql","--stdio"], "env": { "CLOUD_SQL_MYSQL_PROJECT": "PROJECT_ID", "CLOUD_SQL_MYSQL_REGION": "REGION", "CLOUD_SQL_MYSQL_INSTANCE":"INSTANCE_ID", "CLOUD_SQL_MYSQL_DATABASE": "DATABASE_NAME", "CLOUD_SQL_MYSQL_USER": "USER_ID", "CLOUD_SQL_MYSQL_PASSWORD": "PASSWORD" } } } }
Planche à voile
- Ouvrez Windsurf et accédez à l'assistant Cascade.
- Appuyez 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 :
{ "mcpServers": { "cloud-sql-mysql": { "command": "./PATH/TO/toolbox", "args": ["--prebuilt","cloud-sql-mysql","--stdio"], "env": { "CLOUD_SQL_MYSQL_PROJECT": "PROJECT_ID", "CLOUD_SQL_MYSQL_REGION": "REGION", "CLOUD_SQL_MYSQL_INSTANCE":"INSTANCE_ID", "CLOUD_SQL_MYSQL_DATABASE": "DATABASE_NAME", "CLOUD_SQL_MYSQL_USER": "USER_ID", "CLOUD_SQL_MYSQL_PASSWORD": "PASSWORD" } } } }