Usa Cloud SQL para SQL Server con MCP, la CLI de Gemini y otros agentes

MySQL   |  PostgreSQL   |  SQL Server

En esta página, se muestra cómo conectar tu instancia de Cloud SQL a varias herramientas de asistencia para desarrolladores de IA, incluidas las siguientes:

• Extensión de Gemini CLI para Cloud SQL para SQL Server
• Extensión de Gemini CLI para SQL Server

• Gemini Code Assist
• Código de Claude
• Claude para computadoras de escritorio
• Codex
• Cline (extensión de VS Code)
• Cursor
• Visual Studio Code (Copilot)
• Windsurf (Codeium)
• Antigravity

Para una experiencia integrada, te recomendamos que uses la extensión de Gemini CLI dedicada para Cloud SQL para SQL Server.

Como interfaz de línea de comandos de próxima generación de Google Cloud, Gemini CLI agrupa las habilidades subyacentes directamente en la extensión, lo que simplifica la configuración. Puedes configurar Gemini Code Assist para que use Gemini CLI, lo que ofrece beneficios de configuración similares en tu IDE.

Para otras herramientas para desarrolladores que admiten el Protocolo de contexto del modelo (MCP), puedes conectarte configurando manualmente el MCP Toolbox para bases de datos (Toolbox). Toolbox es un servidor de MCP de código abierto que conecta agentes de IA a tus datos mediante la administración de tareas como la autenticación y el agrupamiento de conexiones. Esto te permite interactuar con tus datos usando lenguaje natural directamente desde tu IDE. Para estas herramientas, este método proporciona capacidades básicas de interacción con la base de datos.

Para obtener más información, consulta Herramientas precompiladas y MCP Toolbox para bases de datos en GitHub.

Acerca de Gemini CLI y las extensiones

Gemini CLI es un agente de IA de código abierto diseñado para ayudar con los flujos de trabajo de desarrollo, ya que ayuda con la codificación, la depuración, la exploración de datos y la creación de contenido. Proporciona una interfaz de agente para interactuar con servicios de bases de datos y análisis, y bases de datos populares de código abierto.

Cómo funcionan las extensiones

Gemini CLI es muy extensible, lo que permite agregar nuevas herramientas y capacidades a través de extensiones. Puedes cargar las extensiones desde una URL de GitHub, un directorio local o un registro configurable. Proporcionan nuevas herramientas, comandos de barra, habilidades y mensajes para ayudarte con tu flujo de trabajo.

Usa las extensiones de Gemini CLI en Cloud SQL para SQL Server

La extensión de Gemini CLI de Cloud SQL se basa en MCP Toolbox para bases de datos.

La integración con Gemini CLI se realiza a través de una extensión dedicada que ofrece capacidades adicionales en comparación con la conexión estándar de Toolbox. La extensión ofrece un proceso de instalación optimizado y un conjunto de habilidades basadas en herramientas de MCP.

Para obtener más información, consulta la documentación de GitHub sobre la extensión de Gemini CLI para Cloud SQL para SQL Server.

Extensión de Gemini CLI para bases de datos de Cloud SQL para SQL Server

La extensión cloud-sql-sqlserver incluye habilidades para consultar la base de datos y supervisar su estado.

Para ver todas las habilidades disponibles, consulta las habilidades de Cloud SQL en GitHub La extensión cloud-sql-sqlserver-observability proporciona una interfaz unificada para administrar y supervisar el rendimiento y el estado de la base de datos directamente desde Gemini CLI.

Categoría	Herramientas
Observabilidad	get_system_metrics: Recupera las métricas del sistema para una instancia de Cloud SQL.

Extensión de Gemini CLI para bases de datos de SQL Server

Para obtener una lista de esas operaciones, consulta MCP Toolbox para bases de datos y la extensión de Gemini CLI para SQL Server.

Antes de comenzar

• En la Google Cloud consola, en la página del selector de proyectos, selecciona o crea un Google Cloud proyecto.

• Asegúrate de tener habilitada la facturación para tu Google Cloud proyecto.

• Habilita la API de Cloud SQL Admin en el Google Cloud proyecto.

• De forma predeterminada, Cloud SQL asigna una dirección IP pública a una instancia nueva. Según tu caso de uso, asegúrate de que se configure una IP pública o IP privada para tus instancias de Cloud SQL. Toolbox se conecta de forma segura con los conectores de lenguaje de Cloud SQL.

• Otorga los roles necesarios de Identity and Access Management (IAM) al usuario que ejecutará el servidor de MCP. Las herramientas disponibles dependen de los roles otorgados:

  Tarea	Nombre del rol	Rol de IAM requerido
  Proporciona acceso de solo lectura a los recursos, incluidas las siguientes operaciones: get_instance list_instances list_databases wait_for_operation	Visualizador de Cloud SQL	roles/cloudsql.viewer
  Proporciona acceso de solo lectura a los datos de supervisión, como las métricas de series temporales.	Visualizador de Cloud Monitoring	roles/monitoring.viewer
  Proporciona permisos para administrar recursos existentes, incluidos los siguientes: Todas las herramientas viewer create_database	Editor de Cloud SQL	roles/cloudsql.editor
  Proporciona control total sobre todos los recursos, incluidos los siguientes: Todas las herramientas viewer y editor create_instance create_user	Administrador de Cloud SQL	roles/cloudsql.admin

• Configura las credenciales predeterminadas de la aplicación (ADC) para tu entorno.

• Crea o reutiliza un usuario de la base de datos, y ten listos el nombre de usuario y la contraseña.

Conéctate con Antigravity

Puedes conectar Cloud SQL para SQL Server a Antigravity de las siguientes maneras:

• Usa la tienda de MCP.
• Usa una configuración personalizada.

Nota: No es necesario que descargues el objeto binario de MCP Toolbox para usar estos métodos.

Tienda de MCP

El método más recomendado para conectarse a Cloud SQL para SQL Server en Antigravity es usar el almacén de MCP integrado.

1. Abre Antigravity y el panel de agentes del editor.
2. Haz clic en el ícono "..." en la parte superior del panel y selecciona Servidores de MCP.
3. Ubica Cloud SQL para SQL Server en la lista de servidores disponibles y haz clic en Instalar.
4. Sigue las instrucciones en pantalla para vincular de forma segura tus cuentas cuando corresponda.

Después de instalar Cloud SQL para SQL Server en la tienda de MCP, los recursos y las herramientas del servidor estarán disponibles automáticamente para el editor.

Configuración personalizada

Para conectarte a un servidor de MCP personalizado, sigue estos pasos:

1. Abre Antigravity y el panel de agentes del editor.
2. Haz clic en el ícono "..." en la parte superior del panel y selecciona Servidores de MCP.
3. Haz clic en Administrar servidores de MCP > Ver configuración sin procesar para abrir el archivo mcp_config.json.
4. Agrega la siguiente configuración, reemplaza las variables de entorno por tus valores y guarda los cambios.

{
  "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"
      }
    }
  }
}

Una vez que configures el servidor de MCP personalizado, los recursos y las herramientas del servidor de Cloud SQL para SQL Server estarán disponibles para el editor.

Instala MCP Toolbox

Nota: Este paso no es necesario para las extensiones de Gemini CLI.

1. Descarga el objeto binario que corresponde a tu sistema operativo y arquitectura de la 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>

Haz que el objeto binario sea ejecutable:

```bash
chmod +x toolbox
```

Verifica la instalación con el siguiente comando:

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

Configura el cliente de MCP

En esta sección, se describe cómo configurar varias herramientas para desarrolladores para conectarse a tu instancia de Cloud SQL con Toolbox. Toolbox actúa como un servidor de Protocolo de contexto del modelo (MCP) de código abierto que se encuentra entre tu IDE y tu base de datos, lo que proporciona un plano de control seguro y eficiente para tus herramientas de IA. Selecciona la pestaña de tu herramienta específica para ver las instrucciones de configuración.

Gemini CLI para Cloud SQL para SQL Server

1. Instala el Gemini CLI.
2. Instala la extensión de Cloud SQL para SQL Server para Gemini CLI desde el repositorio de GitHub con el siguiente comando:

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

   Mientras instalas la extensión, reemplaza lo siguiente:

         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"
         

   Reemplaza lo siguiente:
   • PROJECT_NAME: Es el ID del proyecto de. Google Cloud
   • REGION: Es la región de tu instancia de Cloud SQL.
   • INSTANCE_NAME: Es el ID de tu instancia de Cloud SQL.
   • DATABASE_NAME: Es el nombre de la base de datos a la que te conectarás.
   • DATABASE_USER_NAME: Opcional: Es el nombre de usuario de la base de datos. Si no se especifica, el valor predeterminado es la autenticación de IAM.
   • PASSWORD: Opcional: Es la contraseña del usuario de la base de datos. Si no se especifica, el valor predeterminado es la autenticación de IAM.
   • IP_TYPE: Opcional: Es el tipo de IP, como "Pública" (predeterminado) o "Privada".
3. Inicia Gemini CLI en modo interactivo:

         gemini
         

   La CLI carga automáticamente la extensión de Gemini CLI para Cloud SQL y sus herramientas, que puedes usar para interactuar con tu base de datos.

   En Gemini CLI, usa el /extensions comando para verificar que la extensión esté instalada y el /mcp list comando para ver las herramientas.

Gemini CLI para SQL Server

1. Instala el Gemini CLI.
2. Instala la extensión de software de SQL Server para Gemini CLI desde el repositorio de GitHub con el siguiente comando:

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

   Mientras instalas la extensión, reemplaza lo siguiente:

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

   Reemplaza lo siguiente:
   • HOST: Es el nombre de host o la dirección IP del servidor de SQL Server.
   • PORT: Es el número de puerto del servidor de SQL Server.
   • DATABASE: Es el nombre de la base de datos a la que te conectarás.
   • USER: Es el nombre de usuario de la base de datos.
   • PASSWORD: Es la contraseña del usuario de la base de datos.
3. Inicia Gemini CLI en modo interactivo:

         gemini
         

   La CLI carga automáticamente la extensión de Gemini CLI para SQL Server y sus herramientas, que puedes usar para interactuar con tu base de datos.

Gemini Code Assist

1. Instala la extensión de Gemini Code Assist en Visual Studio Code.
2. Habilita el modo de agente en el chat de Gemini Code Assist.
3. En tu directorio de trabajo, crea una carpeta llamada .gemini. Dentro de ella, crea un archivo settings.json.
4. Agrega la siguiente configuración, reemplaza las variables de entorno por tus valores y guarda los cambios:

   
   {
     "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 de Claude

1. Instala Claude Code.
2. Establece variables de entorno para conectarte a tu instancia de 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"
         

   Reemplaza lo siguiente:
   • PROJECT_NAME: Es el ID del proyecto de. Google Cloud
   • REGION: Es la región de tu instancia de Cloud SQL.
   • INSTANCE_NAME: Es el ID de tu instancia de Cloud SQL.
   • DATABASE_NAME: Es el nombre de la base de datos a la que te conectarás.
   • DATABASE_USER_NAME: Opcional: Es el nombre de usuario de la base de datos. Si no se especifica, el valor predeterminado es la autenticación de IAM.
   • PASSWORD: Opcional: Es la contraseña del usuario de la base de datos. Si no se especifica, el valor predeterminado es la autenticación de IAM.
   • IP_TYPE: Opcional: Es el tipo de IP, como "Pública" (predeterminado) o "Privada".
3. Inicia el agente:

         claude
         

4. Busca la versión de actualización más reciente en el repositorio de habilidades de Cloud SQL para SQL Server y agrega el marketplace:

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

5. Instala el complemento:

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

Sugerencia: Ejecuta /plugin list dentro de Claude Code para verificar que el complemento esté activo o /reload-plugins si acabas de instalarlo.

Claude para computadoras de escritorio

1. Abre Claude para computadoras de escritorio y navega a Configuración.
2. En la pestaña Desarrollador, presiona Editar configuración para abrir el archivo de configuración.
3. Agrega lo siguiente para conectarte al servidor de MCP y establecer las variables de entorno:

   
   {
     "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. Reinicia Claude para computadoras de escritorio. En la nueva pantalla de chat, se muestra el ícono de MCP con el nuevo servidor de MCP disponible.

Codex

1. Busca la versión más reciente en el repositorio de habilidades de Cloud SQL para SQL Server y clónala:

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

2. Instala el complemento:

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

3. Configura las variables de entorno para conectarte a tu instancia de 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"
       

   Reemplaza lo siguiente:
   • PROJECT_NAME: Es el ID del proyecto de. Google Cloud
   • REGION: Es la región de tu instancia de Cloud SQL.
   • INSTANCE_NAME: Es el ID de tu instancia de Cloud SQL.
   • DATABASE_NAME: Es el nombre de la base de datos a la que te conectarás.
   • DATABASE_USER_NAME: Opcional: Es el nombre de usuario de la base de datos. Si no se especifica, el valor predeterminado es la autenticación de IAM.
   • PASSWORD: Opcional: Es la contraseña del usuario de la base de datos. Si no se especifica, el valor predeterminado es la autenticación de IAM.
   • IP_TYPE: Opcional: Es el tipo de IP, como "Pública" (predeterminado) o "Privada".
4. Crea o actualiza 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. Ejecuta codex plugin list o usa el menú interactivo plugins para verificar los complementos instalados.

Cline

1. Abre la extensión de Cline en VS Code y presiona el ícono de Servidores de MCP.
2. Presiona Configurar servidores de MCP para abrir el archivo de configuración.
3. Agrega la siguiente configuración, reemplaza las variables de entorno por tus valores y guarda los cambios:

   
   {
     "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"
         }
       }
     }
   }
   
   

   Aparecerá un estado activo verde después de que el servidor se conecte correctamente.

Cursor

1. Crea el directorio .cursor en la raíz de tu proyecto si no existe.
2. Crea el archivo .cursor/mcp.json si no existe y ábrelo.
3. Agrega la siguiente configuración, reemplaza las variables de entorno por tus valores y guarda los cambios:

   
   {
     "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. Abre Cursor y navega a Configuración > Configuración del cursor > MCP. Aparecerá un estado activo verde cuando el servidor se conecte.

Visual Studio Code (Copilot)

1. Abre VS Code y crea el directorio .vscode en la raíz de tu proyecto si no existe.
2. Crea el archivo .vscode/mcp.json si no existe y ábrelo.
3. Agrega la siguiente configuración, reemplaza las variables de entorno por tus valores y guarda los cambios:

   
   {
     "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. Abre Windsurf y navega a Asistente de Cascade.
2. Presiona el ícono de MCP y, luego, Configurar para abrir el archivo de configuración.
3. Agrega la siguiente configuración, reemplaza las variables de entorno por tus valores y guarda los cambios:

   
   {
     "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"
         }
       }
     }
   }