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

MySQL   |  PostgreSQL   |  SQL Server

Nesta página, mostramos como conectar sua instância do Cloud SQL a várias ferramentas de assistência para desenvolvedores de IA, incluindo:

• Extensão da CLI do Gemini para Cloud SQL para SQL Server
• Extensão da CLI do Gemini para SQL Server

• Gemini Code Assist
• Código Claude
• Claude Desktop
• 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 Cloud SQL para SQL Server.

Como interface de linha de comando de próxima geração, a CLI do Gemini agrupa as habilidades subjacentes diretamente na extensão, o que simplifica a configuração. Google CloudVocê pode 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 de desenvolvedor que oferecem suporte ao Protocolo de Contexto de Modelo (MCP), você pode se conectar configurando manualmente a MCP Toolbox for Databases (Toolbox). A 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, exploração de dados e criação de conteúdo. Ela 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.

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, um diretório local ou um registro configurável. Elas 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 SQL Server

A extensão da CLI do Gemini do Cloud SQL é baseada na MCP Toolbox for Databases.

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 da 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 Cloud SQL para SQL Server.

Extensão da CLI do Gemini para bancos de dados do Cloud SQL para SQL Server

A extensão cloud-sql-sqlserver inclui habilidades para consultar o banco de dados e monitorar a integridade dele.

Para todas as habilidades disponíveis, consulte as habilidades do Cloud SQL no GitHub A extensão cloud-sql-sqlserver-observability oferece uma interface unificada para gerenciar e monitorar a performance e a integridade do banco de dados diretamente na CLI do Gemini.

Categoria	Ferramentas
Observabilidade	get_system_metrics: recupera as métricas do sistema para uma instância do Cloud SQL.

Extensão da CLI do Gemini para bancos de dados do SQL Server

Para uma lista dessas operações, consulte MCP Toolbox for Databases e Extensão da CLI do Gemini para SQL Server.

Antes de começar

• No Google Cloud console do, na página do seletor de projetos, selecione ou crie um Google Cloud projeto do.

• Verifique se o faturamento está ativado para o projeto do Google Cloud .

• Ative a API Cloud SQL Admin no Google Cloud projeto.

• 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 IP particular está configurado para suas instâncias do Cloud SQL. A Toolbox se conecta com segurança usando os conectores do Cloud SQL Language.

• 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
  Fornece acesso somente leitura aos recursos, incluindo as seguintes operações: get_instance list_instances list_databases wait_for_operation	Leitor do Cloud SQL	roles/cloudsql.viewer
  Fornece acesso somente leitura a dados de monitoramento, como métricas de série temporal.	Leitor do Cloud Monitoring	roles/monitoring.viewer
  Fornece permissões para gerenciar recursos atuais, incluindo o seguinte: Todas as ferramentas viewer create_database	Editor do Cloud SQL	roles/cloudsql.editor
  Fornece controle total sobre todos os recursos, incluindo o seguinte: Todas as ferramentas viewer e editor create_instance create_user	Administrador do Cloud SQL	roles/cloudsql.admin

• Configure Application Default Credentials (ADC) para seu ambiente.

• Crie ou reutilize um usuário do banco de dados, e tenha o nome de usuário e a senha prontos.

Conectar com o Antigravity

É possível conectar o Cloud SQL para SQL Server ao Antigravity das seguintes maneiras:

• Usar a MCP Store
• Usar uma configuração personalizada

Observação: não é necessário fazer o download do binário da MCP Toolbox para usar esses métodos.

MCP Store

O método mais recomendado para se conectar ao Cloud SQL para SQL Server 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 o Cloud SQL para SQL Server na lista de servidores disponíveis e clique em Instalar.
4. Siga as instruções na tela para vincular suas contas com segurança, quando aplicável.

Depois de instalar o Cloud SQL para SQL Server na MCP Store, os recursos e as ferramentas do servidor ficam disponíveis automaticamente 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-mssql": {
      "command": "npx",
      "args": ["-y","@toolbox-sdk/server","--prebuilt","cloud-sql-mssql","--stdio"],
      "env": {
          "CLOUD_SQL_MSSQL_PROJECT": "PROJECT_ID",
          "CLOUD_SQL_MSSQL_REGION": "REGION",
          "CLOUD_SQL_MSSQL_INSTANCE": "INSTANCE_ID",
          "CLOUD_SQL_MSSQL_DATABASE": "DATABASE_NAME",
          "CLOUD_SQL_MSSQL_USER": "USER_ID",
          "CLOUD_SQL_MSSQL_PASSWORD": "PASSWORD"
      }
    }
  }
}

Depois de configurar o servidor MCP personalizado, os recursos e as ferramentas do servidor do Cloud SQL para SQL Server ficam disponíveis para o editor.

Instalar a MCP Toolbox

Observação: essa etapa não é necessária para extensões da CLI do Gemini.

1. Faça o download do binário que corresponde ao seu sistema operacional e à arquitetura de CPU.

<div>
<devsite-selector>
<section>
<h3 id="linux-amd64">linux/amd64</h3>
<pre class="devsite-click-to-copy">curl -O https://storage.googleapis.com/genai-toolbox/v0.7.0/linux/amd64/toolbox</pre>
</section>
<section>
<h3 id="darwin-arm64">darwin/arm64</h3>
<pre class="devsite-click-to-copy">curl -O https://storage.googleapis.com/genai-toolbox/v0.7.0/darwin/arm64/toolbox</pre>
</section>
<section>
<h3 id="darwin-amd64">darwin/amd64</h3>
<pre class="devsite-click-to-copy">curl -O https://storage.googleapis.com/genai-toolbox/v0.7.0/darwin/amd64/toolbox</pre>
</section>
<section>
<h3 id="windows-amd64">windows/amd64</h3>
<pre class="devsite-click-to-copy">curl -O https://storage.googleapis.com/genai-toolbox/v0.7.0/windows/amd64/toolbox</pre>
</section>
</devsite-selector>
</div>

Torne o binário executável:

```bash
chmod +x toolbox
```

Verifique a instalação usando o seguinte comando:

```bash
./toolbox --version
```

Configurar o cliente MCP

Esta seção descreve como configurar várias ferramentas de desenvolvedor para se conectar a sua instância do Cloud SQL usando a Toolbox. A Toolbox funciona como um servidor de Protocolo de Contexto de Modelo (MCP) de código aberto 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 conferir as instruções de configuração.

CLI do Gemini para Cloud SQL para SQL Server

1. Instale a CLI do Gemini.
2. Instale a extensão do Cloud SQL para SQL Server 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-sqlserver
         

   Ao instalar a extensão, substitua o seguinte:

         export CLOUD_SQL_MSSQL_PROJECT="PROJECT_NAME"
         export CLOUD_SQL_MSSQL_REGION="REGION"
         export CLOUD_SQL_MSSQL_INSTANCE="INSTANCE_NAME"
         export CLOUD_SQL_MSSQL_DATABASE="DATABASE_NAME"
         export CLOUD_SQL_MSSQL_USER="DATABASE_USER_NAME"
         export CLOUD_SQL_MSSQL_PASSWORD="PASSWORD"
         export CLOUD_SQL_MSSQL_IP_TYPE="IP_TYPE"
         

   Substitua:
   • PROJECT_NAME: o ID do projeto do Google Cloud .
   • 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 é a autenticação do IAM se não for especificado.
   • PASSWORD: opcional: a senha do usuário do banco de dados. O padrão é a autenticação do IAM se não for especificado.
   • IP_TYPE: opcional: o tipo de IP, como "Público" (padrão) ou "Particular".
3. Inicie a CLI do Gemini no modo interativo:

         gemini
         

   A CLI carrega automaticamente a extensão da CLI do Gemini para Cloud SQL e as ferramentas dela, que podem ser usadas para interagir com o banco de dados.

   Na CLI do Gemini, use o /extensions comando para verificar se a extensão está instalada e o /mcp list comando para conferir as ferramentas.

CLI do Gemini para SQL Server

1. Instale a CLI do Gemini.
2. Instale a extensão de software do SQL Server para a CLI do Gemini no repositório do GitHub usando o seguinte comando:

         gemini extensions install https://github.com/gemini-cli-extensions/sql-server
         

   Ao instalar a extensão, substitua o seguinte:

         export MSSQL_HOST="HOST"
         export MSSQL_PORT="PORT"
         export MSSQL_DATABASE="DATABASE"
         export MSSQL_USER="USER"
         export MSSQL_PASSWORD="PASSWORD"
         

   Substitua:
   • HOST: o nome do host ou o endereço IP do servidor do SQL Server.
   • PORT: o número da porta do servidor do SQL Server.
   • 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.
3. Inicie a CLI do Gemini no modo interativo:

         gemini
         

   A CLI carrega automaticamente a extensão da CLI do Gemini para SQL Server e as ferramentas dela, que podem ser usadas para interagir com o banco de dados.

Gemini Code Assist

1. Instale a extensão do Gemini Code Assist no Visual Studio Code.
2. Ative o Modo Agente no chat do Gemini Code Assist.
3. No diretório de trabalho, crie uma pasta chamada .gemini. Nela, 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-sqlserver": {
         "command": "./PATH/TO/toolbox",
         "args": ["--prebuilt","cloud-sql-mssql","--stdio"],
         "env": {
           "CLOUD_SQL_MSSQL_PROJECT": "PROJECT_ID",
           "CLOUD_SQL_MSSQL_REGION": "REGION",
           "CLOUD_SQL_MSSQL_INSTANCE": "INSTANCE_ID",
           "CLOUD_SQL_MSSQL_DATABASE": "DATABASE_NAME",
           "CLOUD_SQL_MSSQL_IP_ADDRESS": "IP_ADDRESS",
           "CLOUD_SQL_MSSQL_USER": "USER_ID",
           "CLOUD_SQL_MSSQL_PASSWORD": "PASSWORD"
         }
       }
     }
   }
   
   

Código Claude

1. Instale o Claude Code.
2. Defina variáveis de ambiente para se conectar à instância do Cloud SQL:

         export CLOUD_SQL_MSSQL_PROJECT="PROJECT_NAME"
         export CLOUD_SQL_MSSQL_REGION="REGION"
         export CLOUD_SQL_MSSQL_INSTANCE="INSTANCE_NAME"
         export CLOUD_SQL_MSSQL_DATABASE="DATABASE_NAME"
         export CLOUD_SQL_MSSQL_USER="DATABASE_USER_NAME"
         export CLOUD_SQL_MSSQL_PASSWORD="PASSWORD"
         export CLOUD_SQL_MSSQL_IP_TYPE="IP_TYPE"
         

   Substitua:
   • PROJECT_NAME: o ID do projeto do Google Cloud .
   • 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 é a autenticação do IAM se não for especificado.
   • PASSWORD: opcional: a senha do usuário do banco de dados. O padrão é a autenticação do IAM se não for especificado.
   • IP_TYPE: opcional: o tipo de IP, como "Público" (padrão) ou "Particular".
3. Inicie o agente:

         claude
         

4. Encontre a versão de lançamento mais recente no repositório de habilidades do Cloud SQL para SQL Server e adicione o marketplace:

         /plugin marketplace add https://github.com/gemini-cli-extensions/cloud-sql-sqlserver.git#VERSION
         

5. Instalar o plug-in:

         /plugin install cloud-sql-sqlserver@cloud-sql-sqlserver-marketplace
         

Dica:execute /plugin list no Claude Code para verificar se o plug-in está ativo ou /reload-plugins se você acabou de instalá-lo.

Claude Desktop

1. Abra 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-sqlserver": {
         "command": "./PATH/TO/toolbox",
         "args": ["--prebuilt","cloud-sql-mssql","--stdio"],
         "env": {
           "CLOUD_SQL_MSSQL_PROJECT": "PROJECT_ID",
           "CLOUD_SQL_MSSQL_REGION": "REGION",
           "CLOUD_SQL_MSSQL_INSTANCE": "INSTANCE_ID",
           "CLOUD_SQL_MSSQL_DATABASE": "DATABASE_NAME",
           "CLOUD_SQL_MSSQL_IP_ADDRESS": "IP_ADDRESS",
           "CLOUD_SQL_MSSQL_USER": "USER_ID",
           "CLOUD_SQL_MSSQL_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. Encontre a versão de lançamento mais recente no repositório de habilidades do Cloud SQL para SQL Server e clone-o:

   git clone --branch VERSION [e-mail]:gemini-cli-extensions/cloud-sql-sqlserver.git
   

2. Instalar o plug-in:

   mkdir -p ~/.codex/plugins
   cp -R /absolute/path/to/cloud-sql-sqlserver ~/.codex/plugins/cloud-sql-sqlserver
   

3. Configure as variáveis de ambiente para se conectar à instância do Cloud SQL:

       export CLOUD_SQL_MSSQL_PROJECT="PROJECT_NAME"
       export CLOUD_SQL_MSSQL_REGION="REGION"
       export CLOUD_SQL_MSSQL_INSTANCE="INSTANCE_NAME"
       export CLOUD_SQL_MSSQL_DATABASE="DATABASE_NAME"
       export CLOUD_SQL_MSSQL_USER="DATABASE_USER_NAME"
       export CLOUD_SQL_MSSQL_PASSWORD="PASSWORD"
       export CLOUD_SQL_MSSQL_IP_TYPE="IP_TYPE"
       

   Substitua:
   • PROJECT_NAME: o ID do projeto do Google Cloud .
   • 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 é a autenticação do IAM se não for especificado.
   • PASSWORD: opcional: a senha do usuário do banco de dados. O padrão é a autenticação do IAM se não for especificado.
   • IP_TYPE: opcional: o tipo de IP, como "Público" (padrão) ou "Particular".
4. Crie ou atualize marketplace.json:

   
   {
     "name": "my-data-cloud-google-marketplace",
     "interface": {
       "displayName": "Google Data Cloud Skills"
     },
     "plugins": [
       {
         "name": "cloud-sql-sqlserver",
         "source": {
           "source": "local",
           "path": "./plugins/cloud-sql-sqlserver"
         },
         "policy": {
           "installation": "AVAILABLE",
           "authentication": "ON_INSTALL"
         },
         "category": "Database"
       }
     ]
   }
   
   

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-sqlserver": {
         "command": "./PATH/TO/toolbox",
         "args": ["--prebuilt","cloud-sql-mssql","--stdio"],
         "env": {
           "CLOUD_SQL_MSSQL_PROJECT": "PROJECT_ID",
           "CLOUD_SQL_MSSQL_REGION": "REGION",
           "CLOUD_SQL_MSSQL_INSTANCE": "INSTANCE_ID",
           "CLOUD_SQL_MSSQL_DATABASE": "DATABASE_NAME",
           "CLOUD_SQL_MSSQL_IP_ADDRESS": "IP_ADDRESS",
           "CLOUD_SQL_MSSQL_USER": "USER_ID",
           "CLOUD_SQL_MSSQL_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-sqlserver": {
         "command": "./PATH/TO/toolbox",
         "args": ["--prebuilt","cloud-sql-mssql","--stdio"],
         "env": {
           "CLOUD_SQL_MSSQL_PROJECT": "PROJECT_ID",
           "CLOUD_SQL_MSSQL_REGION": "REGION",
           "CLOUD_SQL_MSSQL_INSTANCE": "INSTANCE_ID",
           "CLOUD_SQL_MSSQL_DATABASE": "DATABASE_NAME",
           "CLOUD_SQL_MSSQL_IP_ADDRESS": "IP_ADDRESS",
           "CLOUD_SQL_MSSQL_USER": "USER_ID",
           "CLOUD_SQL_MSSQL_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 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-sqlserver": {
         "command": "./PATH/TO/toolbox",
         "args": ["--prebuilt","cloud-sql-mssql","--stdio"],
         "env": {
           "CLOUD_SQL_MSSQL_PROJECT": "PROJECT_ID",
           "CLOUD_SQL_MSSQL_REGION": "REGION",
           "CLOUD_SQL_MSSQL_INSTANCE": "INSTANCE_ID",
           "CLOUD_SQL_MSSQL_DATABASE": "DATABASE_NAME",
           "CLOUD_SQL_MSSQL_IP_ADDRESS": "IP_ADDRESS",
           "CLOUD_SQL_MSSQL_USER": "USER_ID",
           "CLOUD_SQL_MSSQL_PASSWORD": "PASSWORD"
         }
       }
     }
   }
   
   

Windsurf

1. Abra Windsurf e acesse Assistente em cascata.
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-sqlserver": {
         "command": "./PATH/TO/toolbox",
         "args": ["--prebuilt","cloud-sql-mssql","--stdio"],
         "env": {
           "CLOUD_SQL_MSSQL_PROJECT": "PROJECT_ID",
           "CLOUD_SQL_MSSQL_REGION": "REGION",
           "CLOUD_SQL_MSSQL_INSTANCE": "INSTANCE_ID",
           "CLOUD_SQL_MSSQL_DATABASE": "DATABASE_NAME",
           "CLOUD_SQL_MSSQL_IP_ADDRESS": "IP_ADDRESS",
           "CLOUD_SQL_MSSQL_USER": "USER_ID",
           "CLOUD_SQL_MSSQL_PASSWORD": "PASSWORD"
         }
       }
     }
   }