Nesta página, mostramos como conectar sua instância do Cloud SQL a várias ferramentas de assistência ao desenvolvedor de IA, incluindo as seguintes:
- Gemini Code Assist
- Claude Code
- Claude para computador
- Codex
- Cline (extensão do VS Code)
- Cursor
- Visual Studio Code (Copilot)
- Windsurf (Codeium)
- Antigravity
Para uma experiência integrada, recomendamos usar a extensão dedicada da CLI do Gemini para o Cloud SQL para MySQL.
Como a interface de linha de comando de última geração do Cloud de Confiance by S3NS, a CLI do Gemini reúne as habilidades necessárias diretamente na extensão, o que simplifica a configuração. É possível configurar o Gemini Code Assist para usar a CLI do Gemini, oferecendo benefícios de configuração semelhantes no seu ambiente de desenvolvimento integrado.
Para outras ferramentas para desenvolvedores que oferecem suporte ao Protocolo de Contexto de Modelo (MCP), é possível se conectar configurando manualmente o MCP Toolbox for Databases (Toolbox). O Toolbox é um servidor MCP de código aberto que conecta agentes de IA aos seus dados gerenciando tarefas como autenticação e pool de conexões. Isso permite que você interaja com seus dados usando linguagem natural diretamente do seu ambiente de desenvolvimento integrado. Para essas ferramentas, esse método oferece recursos básicos de interação com o banco de dados.
Para mais informações, consulte Ferramentas pré-criadas e MCP Toolbox for Databases no GitHub.
Sobre a CLI do Gemini e as extensões
A CLI do Gemini é um agente de IA de código aberto projetado para ajudar nos fluxos de trabalho de desenvolvimento, auxiliando na programação, depuração, análise de dados e criação de conteúdo. Ele oferece uma interface de agente para interagir com serviços de banco de dados e análise e bancos de dados de código aberto conhecidos.
Como as extensões funcionam
A CLI do Gemini é altamente extensível, permitindo a adição de novas ferramentas e recursos por meio de extensões. É possível carregar as extensões de um URL do GitHub, de um diretório local ou de um registro configurável. Eles oferecem novas ferramentas, comandos de barra, habilidades e comandos para ajudar no seu fluxo de trabalho.
Usar as extensões da CLI do Gemini no Cloud SQL para MySQL
A extensão da CLI do Gemini para o Cloud SQL é baseada no MCP Toolbox para bancos de dados.
A integração com a CLI do Gemini é feita por uma extensão dedicada que oferece recursos adicionais em comparação com a conexão padrão do Toolbox. A extensão oferece um processo de instalação simplificado e um conjunto de habilidades com base nas ferramentas do MCP.
Para mais informações, consulte a documentação do GitHub sobre a extensão da CLI do Gemini para o Cloud SQL para MySQL.Extensão da CLI do Gemini para bancos de dados do Cloud SQL para MySQL
A extensãocloud-sql-mysql inclui habilidades para consultar o banco de dados e monitorar a integridade dele.
Para conferir todas as habilidades disponíveis, consulte as habilidades do Cloud SQL no GitHub.
A extensão cloud-sql-mysql-observability oferece uma interface unificada para gerenciar e monitorar o desempenho e a integridade do banco de dados diretamente da CLI do Gemini.
| Categoria | Ferramentas |
|---|---|
| Observabilidade |
|
Extensão da CLI do Gemini para bancos de dados MySQL
Para uma lista dessas operações, consulte MCP Toolbox for Databases e Extensão da CLI do Gemini para MySQL.
Antes de começar
No console do Cloud de Confiance , na página do seletor de projetos, selecione ou crie um projeto do Cloud de Confiance by S3NS .
Verifique se o faturamento está ativado para o projeto do Cloud de Confiance .
Ative a API Cloud SQL Admin no projeto do Cloud de Confiance .
Por padrão, o Cloud SQL atribui um endereço IP público a uma nova instância. Dependendo do seu caso de uso, verifique se um IP público ou um IP particular está configurado para as instâncias do Cloud SQL. O Toolbox se conecta com segurança usando os conectores de linguagem do Cloud SQL.
Conceda os papéis necessários do Identity and Access Management (IAM) ao usuário que vai executar o servidor MCP. As ferramentas disponíveis dependem dos papéis concedidos:
Tarefa Nome do papel Papel do IAM obrigatório Dá acesso somente leitura aos recursos, incluindo as seguintes operações: get_instancelist_instanceslist_databaseswait_for_operation
Leitor do Cloud SQL roles/cloudsql.viewerDá acesso somente leitura a dados de monitoramento, como métricas de série temporal. Leitor do Cloud Monitoring roles/monitoring.viewerConcede permissões para gerenciar recursos, incluindo: - Todas as ferramentas de
viewer create_database
Editor do Cloud SQL roles/cloudsql.editorConcede controle total sobre todos os recursos, incluindo: - Todas as ferramentas do
viewere doeditor create_instancecreate_user
Administrador do Cloud SQL roles/cloudsql.adminConfigure o Application Default Credentials (ADC) para seu ambiente.
Crie ou reutilize um usuário de banco de dados e tenha o nome de usuário e a senha prontos.
Conectar-se ao Data Agent Kit
A extensão do Google Cloud Data Agent Kit permite que você se conecte e consulte o Cloud SQL no Visual Studio Code ou em qualquer ambiente de desenvolvimento integrado baseado no VS Code. Ele permite que você se conecte a servidores MCP, consulte dados e execute cargas de trabalho de engenharia de dados no seu ambiente de desenvolvimento integrado. O Data Agent Kit também oferece plug-ins de CLI.
Para mais informações, consulte Visão geral do Data Agent Kit.
Conectar-se ao Antigravity
É possível conectar o Cloud SQL para MySQL ao Antigravity das seguintes maneiras:
- Usar a MCP Store
- Usar uma configuração personalizada
MCP Store
O método mais recomendado para se conectar ao Cloud SQL para MySQL no Antigravity é usar a MCP Store integrada.
- Abra o Antigravity e o painel do agente do editor.
- Clique no ícone "..." na parte de cima do painel e selecione Servidores MCP.
- Localize Cloud SQL para MySQL na lista de servidores disponíveis e clique em Instalar.
- Siga as mensagens na tela para vincular suas contas com segurança, quando aplicável.
Depois de instalar o Cloud SQL para MySQL na MCP Store, os recursos e as ferramentas do servidor ficam automaticamente disponíveis para o editor.
Configuração personalizada
Para se conectar a um servidor MCP personalizado, siga estas etapas:
- Abra o Antigravity e o painel do agente do editor.
- Clique no ícone "..." na parte de cima do painel e selecione Servidores MCP.
- Clique em Gerenciar servidores MCP > Ver configuração bruta para abrir o arquivo
mcp_config.json. - Adicione a configuração a seguir, substitua as variáveis de ambiente pelos seus valores e salve.
{
"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"
}
}
}
}
Depois de configurar o servidor MCP personalizado, os recursos e as ferramentas do servidor do Cloud SQL para MySQL ficam disponíveis para o editor.
Instalar o MCP Toolbox
- Faça o download do binário que corresponde ao seu
sistema operacional e à arquitetura de CPU.
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
- Torne o binário executável:
chmod +x toolbox
- Verifique a instalação usando o seguinte comando:
./toolbox --version
Configurar o cliente MCP
Nesta seção, descrevemos como configurar várias ferramentas para desenvolvedores para se conectar à sua instância do Cloud SQL usando o Toolbox. O Toolbox funciona como um servidor de código aberto do Protocolo de Contexto de Modelo (MCP) que fica entre o ambiente de desenvolvimento integrado e o banco de dados, fornecendo um plano de controle seguro e eficiente para suas ferramentas de IA. Selecione a guia da sua ferramenta específica para ver as instruções de configuração.
CLI do Gemini para Cloud SQL para MySQL
- Instale a CLI do Gemini.
- Instale a extensão do Cloud SQL para MySQL para a CLI do Gemini no repositório do GitHub usando o seguinte comando:
Ao instalar a extensão, substitua o seguinte:gemini extensions install https://github.com/gemini-cli-extensions/cloud-sql-mysql
Substitua: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: o ID do projeto do Cloud de Confiance .
- REGION: a região da instância do Cloud SQL.
- INSTANCE_NAME: o ID da instância do Cloud SQL.
- DATABASE_NAME: o nome do banco de dados a ser conectado.
- DATABASE_USER_NAME: opcional: o nome de usuário do banco de dados. O padrão será a autenticação do IAM se não for especificado.
- PASSWORD: opcional: a senha do usuário do banco de dados. O padrão será a autenticação do IAM se não for especificado.
- IP_TYPE: opcional: o tipo de IP, como "Público" (padrão) ou "Privado".
- Inicie a CLI do Gemini no modo interativo:
gemini
A CLI carrega automaticamente a extensão da CLI do Gemini para o Cloud SQL e as ferramentas dela, que podem ser usadas para interagir com o banco de dados.
Na CLI do Gemini, use o comando
/extensionspara verificar se a extensão está instalada e o comando/mcp listpara conferir as ferramentas.
CLI do Gemini para MySQL
- Instale a CLI do Gemini.
- Instale a extensão de software do MySQL para a CLI do Gemini
no repositório do GitHub usando o seguinte comando:
Ao instalar a extensão, substitua o seguinte:gemini extensions install https://github.com/gemini-cli-extensions/mysql
Substitua: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: o nome do host ou o endereço IP do servidor MySQL.
- PORT: o número da porta do servidor MySQL.
- DATABASE: o nome do banco de dados a ser conectado.
- USER: o nome de usuário do banco de dados.
- PASSWORD: a senha do usuário do banco de dados.
- QUERY_PARAMETERS: opcional: a consulta bruta a ser adicionada à
string de conexão
db.
- Inicie a CLI do Gemini no modo interativo:
gemini
A CLI carrega automaticamente a extensão da CLI do Gemini para MySQL e as ferramentas dela, que podem ser usadas para interagir com seu banco de dados.
Gemini Code Assist
- Instale a extensão do Gemini Code Assist no Visual Studio Code.
- Ative o Modo Agente na conversa do Gemini Code Assist.
- No diretório de trabalho, crie uma pasta chamada
.gemini. Nele, crie um arquivosettings.json. - Adicione a configuração a seguir, substitua as variáveis de ambiente pelos seus valores e salve:
{ "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
- Instale o Claude Code.
- Defina variáveis de ambiente para se conectar à instância do Cloud SQL:
Substitua: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: o ID do projeto do Cloud de Confiance .
- REGION: a região da instância do Cloud SQL.
- INSTANCE_NAME: o ID da instância do Cloud SQL.
- DATABASE_NAME: o nome do banco de dados a ser conectado.
- DATABASE_USER_NAME: opcional: o nome de usuário do banco de dados. O padrão será a autenticação do IAM se não for especificado.
- PASSWORD: opcional: a senha do usuário do banco de dados. O padrão será a autenticação do IAM se não for especificado.
- IP_TYPE: opcional. O tipo de IP, como "Público" (padrão) ou "Privado".
- Inicie o agente:
claude
- Instalar o plug-in:
/plugin install cloud-sql-mysql@claude-plugins-official
Claude para computador
- Abra o Claude Desktop e acesse Configurações.
- Na guia Desenvolvedor, toque em Editar configuração para abrir o arquivo de configuração.
- Adicione o seguinte para se conectar ao servidor MCP e definir as variáveis de ambiente:
{ "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" } } } } - Reinicie o Claude Desktop. A nova tela de chat mostra o ícone do MCP com o novo servidor MCP disponível.
Codex
- Instale o marketplace de plug-ins do Data Cloud:
codex plugin marketplace add GoogleCloudPlatform/data-cloud-plugins
- Instale o plug-in:
codex plugin install cloud-sql-mysql@data-cloud-plugins
- Configure as variáveis de ambiente para se conectar à instância do Cloud SQL:
Substitua: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: o ID do projeto do Cloud de Confiance .
- REGION: a região da instância do Cloud SQL.
- INSTANCE_NAME: o ID da instância do Cloud SQL.
- DATABASE_NAME: o nome do banco de dados a ser conectado.
- DATABASE_USER_NAME: opcional: o nome de usuário do banco de dados. O padrão será a autenticação do IAM se não for especificado.
- PASSWORD: opcional: a senha do usuário do banco de dados. O padrão será a autenticação do IAM se não for especificado.
- IP_TYPE: opcional. O tipo de IP, como "Público" (padrão) ou "Privado".
- Opcional. Atualize o marketplace:
codex plugin marketplace upgrade data-agent-plugins
- Execute
codex plugin listou use o menu interativopluginspara verificar os plug-ins instalados.
Cline
- Abra a extensão Cline no VS Code e toque no ícone Servidores MCP.
- Toque em Configurar servidores MCP para abrir o arquivo de configuração.
- Adicione a configuração a seguir, substitua as variáveis de ambiente pelos seus valores e salve:
Um status ativo verde aparece depois que o servidor se conecta.{ "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
- Crie o diretório
.cursorna raiz do projeto, se ele não existir. - Crie o arquivo
.cursor/mcp.json, se ele não existir, e abra-o. - Adicione a configuração a seguir, substitua as variáveis de ambiente pelos seus valores e salve:
{ "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" } } } } - Abra o Cursor e acesse Configurações > Configurações do Cursor > MCP. Um status ativo verde aparece quando o servidor se conecta.
Visual Studio Code (Copilot)
- Abra o VS Code e crie o diretório
.vscodena raiz do projeto, se ele não existir. - Crie o arquivo
.vscode/mcp.json, se ele não existir, e abra-o. - Adicione a configuração a seguir, substitua as variáveis de ambiente pelos seus valores e salve:
{ "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" } } } }
Windsurf
- Abra o Windsurf e acesse o assistente Cascade.
- Toque no ícone do MCP e em Configurar para abrir o arquivo de configuração.
- Adicione a configuração a seguir, substitua as variáveis de ambiente pelos seus valores e salve:
{ "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" } } } }