Usar o Cloud SQL para MySQL com o MCP, a CLI Gemini e outros agentes

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:

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ão cloud-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
  • get_system_metrics: recupera métricas do sistema para uma instância do Cloud SQL.
  • get_query_metrics: recupera métricas relacionadas a consultas de uma instância do Cloud SQL.

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

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.

  1. Abra o Antigravity e o painel do agente do editor.
  2. Clique no ícone "..." na parte de cima do painel e selecione Servidores MCP.
  3. Localize Cloud SQL para MySQL na lista de servidores disponíveis e clique em Instalar.
  4. 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:

  1. Abra o Antigravity e o painel do agente do editor.
  2. Clique no ícone "..." na parte de cima do painel e selecione Servidores MCP.
  3. Clique em Gerenciar servidores MCP > Ver configuração bruta para abrir o arquivo mcp_config.json.
  4. 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

  1. 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
  2. Torne o binário executável:
    chmod +x toolbox
  3. 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


  1. Instale a CLI do Gemini.
  2. Instale a extensão do Cloud SQL para MySQL para a CLI do Gemini no repositório do GitHub usando o seguinte comando:
    gemini extensions install https://github.com/gemini-cli-extensions/cloud-sql-mysql
    
    Ao instalar a extensão, substitua o seguinte:
    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"
    
    Substitua:
    • 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".
  3. 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 /extensions para verificar se a extensão está instalada e o comando /mcp list para conferir as ferramentas.

CLI do Gemini para MySQL


  1. Instale a CLI do Gemini.
  2. Instale a extensão de software do MySQL para a CLI do Gemini no repositório do GitHub usando o seguinte comando:
    gemini extensions install https://github.com/gemini-cli-extensions/mysql
    Ao instalar a extensão, substitua o seguinte:
    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"
    
    Substitua:
    • 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.
  3. 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


  1. Instale a extensão do Gemini Code Assist no Visual Studio Code.
  2. Ative o Modo Agente na conversa do Gemini Code Assist.
  3. No diretório de trabalho, crie uma pasta chamada .gemini. Nele, crie um arquivo settings.json.
  4. 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


  1. Instale o Claude Code.
  2. Defina variáveis de ambiente para se conectar à instância do Cloud SQL:
    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"
    
    Substitua:
    • 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".
  3. Inicie o agente:
    claude
  4. Instalar o plug-in:
    /plugin install cloud-sql-mysql@claude-plugins-official

Claude para computador


  1. Abra o Claude Desktop e acesse Configurações.
  2. Na guia Desenvolvedor, toque em Editar configuração para abrir o arquivo de configuração.
  3. 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"
          }
        }
      }
    }
    
  4. Reinicie o Claude Desktop. A nova tela de chat mostra o ícone do MCP com o novo servidor MCP disponível.

Codex


  1. Instale o marketplace de plug-ins do Data Cloud:
    codex plugin marketplace add GoogleCloudPlatform/data-cloud-plugins
  2. Instale o plug-in:
    codex plugin install cloud-sql-mysql@data-cloud-plugins
  3. Configure as variáveis de ambiente para se conectar à instância do Cloud SQL:
    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"
    Substitua:
    • 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".
  4. Opcional. Atualize o marketplace:
    codex plugin marketplace upgrade data-agent-plugins
  5. Execute codex plugin list ou use o menu interativo plugins para verificar os plug-ins instalados.

Cline


  1. Abra a extensão Cline no VS Code e toque no ícone Servidores MCP.
  2. Toque em Configurar servidores MCP para abrir o arquivo de configuração.
  3. 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"
          }
        }
      }
    }
    
    Um status ativo verde aparece depois que o servidor se conecta.

Cursor


  1. Crie o diretório .cursor na raiz do projeto, se ele não existir.
  2. Crie o arquivo .cursor/mcp.json, se ele não existir, e abra-o.
  3. 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"
          }
        }
      }
    }
    
  4. 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)


  1. Abra o VS Code e crie o diretório .vscode na raiz do projeto, se ele não existir.
  2. Crie o arquivo .vscode/mcp.json, se ele não existir, e abra-o.
  3. 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


  1. Abra o Windsurf e acesse o assistente Cascade.
  2. Toque no ícone do MCP e em Configurar para abrir o arquivo de configuração.
  3. 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"
          }
        }
      }
    }