Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

Conecta LLMs a Cloud Storage con MCP

En esta guía, se muestra cómo conectar Cloud Storage a entornos de desarrollo integrados (IDE) y herramientas para desarrolladores. Para ello, ejecuta un servidor de MCP local en tu máquina con MCP Toolbox para bases de datos.

El kit de herramientas de MCP para bases de datos es un repositorio de código abierto que contiene conectores para bases de datos y almacenes de datos, incluidos Cloud Storage, BigQuery, AlloyDB, Spanner y Cloud SQL. La caja de herramientas admite la autenticación de OAuth2 y OIDC, y se integra con Open Telemetry para la observabilidad. La integración de la caja de herramientas de Cloud Storage te permite usar un LLM para realizar las siguientes acciones:

Crea, enumera y borra buckets.
Obtener metadatos de bucket y objetos
Obtener políticas de Identity and Access Management (IAM) en tus buckets
Leer, escribir, subir y descargar objetos
Copiar o mover objetos

En esta guía, se muestra el proceso de conexión para los siguientes IDE y herramientas:

Cursor
Windsurf (antes conocido como Codeium)
Visual Studio Code (Copilot)
Cline (extensión de VS Code)
Claude para computadoras de escritorio
Claude Code
Antigravity

Antes de comenzar

En la consola de Google Cloud , en la página del selector de proyectos, selecciona o crea un proyecto de Google Cloud .
Asegúrate de tener habilitada la facturación para tu proyecto de Google Cloud .
Habilita la API de Cloud Storage en el Google Cloud proyecto.
Configura los roles y permisos necesarios para completar esta tarea. El usuario que invoca a los agentes de LLM necesita los siguientes roles a nivel del bucket o del proyecto:
- Para enumerar buckets, crear buckets y borrar buckets vacíos: Administrador de Storage (roles/storage.admin)
- Para enumerar objetos, leer objetos, obtener metadatos de objetos o metadatos de bucket: Visualizador de objetos de Storage (roles/storage.objectViewer)
- Para escribir contenido en un objeto o subir un objeto: Creador de objetos de Storage (roles/storage.objectCreator)
- Para copiar, mover o borrar objetos: Administrador de objetos de almacenamiento (roles/storage.objectAdmin)
Configura las credenciales predeterminadas de la aplicación (ADC) para tu entorno.

Conéctate con Antigravity

Conectas Cloud Storage a Antigravity con una configuración personalizada. En este contexto, un servidor de MCP personalizado es un servidor que configuras manualmente editando tu archivo de configuración (como mcp_config.json). Esta configuración manual se usa en lugar de instalar el servidor directamente desde el catálogo integrado de MCP Store.

Para configurar un servidor de MCP personalizado, haz lo siguiente:

Para verificar que npx esté instalado y configurado correctamente en tu sistema, ejecuta npx --version en la terminal. Si necesitas instalar Node.js, que incluye npx, consulta la guía de npm Descarga e instalación de Node.js y npm.
Abre Antigravity y navega a la tienda de MCP con el menú desplegable "…" en la parte superior del panel del agente del editor.
Para abrir el archivo mcp_config.json, haz clic en MCP Servers y, luego, en Manage MCP Servers > View raw config.

Agrega la siguiente configuración, reemplaza el marcador de posición por el ID de tu proyecto y guarda los cambios:

{
  "mcpServers": {
    "storage": {
      "command": "npx",
      "args": ["-y","@toolbox-sdk/server","--prebuilt","cloud-storage","--stdio"],
      "env": {
          "CLOUD_STORAGE_PROJECT": "PROJECT_ID"
      }
    }
  }
}

Instala MCP Toolbox

La caja de herramientas es un servidor de Protocolo de contexto del modelo (MCP) de código abierto que se ejecuta de forma local en tu máquina. El servidor local administra la comunicación entre tu IDE y Cloud Storage. Esta conexión proporciona un entorno seguro y eficiente para tus herramientas de IA.

Descarga la versión más reciente de MCP Toolbox como un objeto binario. Selecciona el objeto binario correspondiente a tu sistema operativo (SO) y a la arquitectura de la CPU. Debes usar la versión 1.2.0 o una posterior de MCP Toolbox:
linux/amd64
curl -O https://storage.googleapis.com/mcp-toolbox-for-databases/VERSION/linux/amd64/toolbox
Reemplaza VERSION por la versión de MCP Toolbox, por ejemplo, v1.2.0.
macOS darwin/arm64
curl -O https://storage.googleapis.com/mcp-toolbox-for-databases/VERSION/darwin/arm64/toolbox
Reemplaza VERSION por la versión de MCP Toolbox, por ejemplo, v1.2.0.
macOS darwin/amd64
curl -O https://storage.googleapis.com/mcp-toolbox-for-databases/VERSION/darwin/amd64/toolbox
Reemplaza VERSION por la versión de MCP Toolbox, por ejemplo, v1.2.0.
windows/amd64
curl -O https://storage.googleapis.com/mcp-toolbox-for-databases/VERSION/windows/amd64/toolbox
Reemplaza VERSION por la versión de MCP Toolbox, por ejemplo, v1.2.0.
Haz que el objeto binario sea ejecutable:
```
chmod +x toolbox
```
Verifica la instalación:
```
./toolbox --version
```

Para configurar la caja de herramientas con una imagen de contenedor o Homebrew, consulta la página Instala Toolbox.

Configura clientes y conexiones

En esta sección, se describe cómo conectar Cloud Storage a tus herramientas después de instalar la caja de herramientas de MCP.

Claude Code

Instala Claude Code.
Crea un archivo .mcp.json en la raíz del proyecto si no existe.
Agrega la configuración, reemplaza los marcadores de posición por tus valores y guarda los cambios:
```
        {
          "mcpServers": {
            "storage": {
              "command": "./PATH/TO/toolbox",
              "args": ["--prebuilt","cloud-storage","--stdio"],
              "env": {
                "CLOUD_STORAGE_PROJECT": "PROJECT_ID"
              }
            }
          }
        }
        
```
Reemplaza las siguientes variables por tus valores:
- ./PATH/TO/toolbox: Es la ruta de acceso a tu objeto binario toolbox.
- CLOUD_STORAGE_PROJECT: Es la variable de entorno que especifica el ID del proyecto de Google Cloud .
- PROJECT_ID: Es el ID del proyecto de Google Cloud .
Reinicia Claude Code para cargar la nueva configuración. Cuando se vuelve a abrir Claude Code, la aplicación detecta el servidor de MCP configurado.

Claude para computadoras de escritorio

Abre Claude Desktop y ve a Configuración.
En la pestaña Desarrollador, haz clic en Editar configuración para abrir el archivo de configuración.
Agrega la configuración, reemplaza los marcadores de posición por tus valores y guarda los cambios:
```
        {
          "mcpServers": {
            "storage": {
              "command": "./PATH/TO/toolbox",
              "args": ["--prebuilt","cloud-storage","--stdio"],
              "env": {
                "CLOUD_STORAGE_PROJECT": "PROJECT_ID"
              }
            }
          }
        }
        
```
Reemplaza las siguientes variables por tus valores:
- ./PATH/TO/toolbox: Es la ruta de acceso a tu objeto binario toolbox.
- CLOUD_STORAGE_PROJECT: Es la variable de entorno que especifica el ID del proyecto de Google Cloud .
- PROJECT_ID: Es el ID del proyecto de Google Cloud .
Reinicia Claude para computadoras.
En la nueva pantalla de chat, se muestra un ícono de martillo (MCP) con el nuevo servidor de MCP.

Cline

Abre la extensión Cline en VS Code y haz clic en el ícono de MCP Servers.
Haz clic en Configure MCP Servers para abrir el archivo de configuración.
Agrega la siguiente configuración, reemplaza los marcadores de posición por tus valores y guarda los cambios:
```
        {
          "mcpServers": {
            "storage": {
              "command": "./PATH/TO/toolbox",
              "args": ["--prebuilt","cloud-storage","--stdio"],
              "env": {
                "CLOUD_STORAGE_PROJECT": "PROJECT_ID"
              }
            }
          }
        }
        
```
Reemplaza las siguientes variables por tus valores:
- ./PATH/TO/toolbox: Es la ruta de acceso a tu objeto binario toolbox.
- CLOUD_STORAGE_PROJECT: Es la variable de entorno que especifica el ID del proyecto de Google Cloud .
- PROJECT_ID: Es el ID del proyecto de Google Cloud .

Aparece un estado activo verde después de que el servidor se conecta correctamente.

Cursor

Crea el directorio .cursor en la raíz del proyecto si no existe.
Crea el archivo .cursor/mcp.json si no existe y ábrelo.
Agrega la siguiente configuración, reemplaza los marcadores de posición por tus valores y guarda los cambios:
```
        {
          "mcpServers": {
            "storage": {
              "command": "./PATH/TO/toolbox",
              "args": ["--prebuilt","cloud-storage","--stdio"],
              "env": {
                "CLOUD_STORAGE_PROJECT": "PROJECT_ID"
              }
            }
          }
        }
        
```
Reemplaza las siguientes variables por tus valores:
- ./PATH/TO/toolbox: Es la ruta de acceso a tu objeto binario toolbox.
- CLOUD_STORAGE_PROJECT: Es la variable de entorno que especifica el ID del proyecto de Google Cloud .
- PROJECT_ID: Es el ID del proyecto de Google Cloud .
Abre Cursor y navega a Configuración > Configuración del cursor > MCP. Cuando el servidor se conecta, aparece un estado activo de color verde.

Visual Studio Code (Copilot)

Abre VS Code y crea un directorio .vscode en la raíz del proyecto si no existe.
Crea el archivo .vscode/mcp.json si no existe y ábrelo.
Agrega la siguiente configuración, reemplaza los marcadores de posición por tus valores y guarda los cambios:
```
        {
          "mcpServers": {
            "storage": {
              "command": "./PATH/TO/toolbox",
              "args": ["--prebuilt","cloud-storage","--stdio"],
              "env": {
                "CLOUD_STORAGE_PROJECT": "PROJECT_ID"
              }
            }
          }
        }
        
```
Reemplaza las siguientes variables por tus valores:
- ./PATH/TO/toolbox: Es la ruta de acceso a tu objeto binario toolbox.
- CLOUD_STORAGE_PROJECT: Es la variable de entorno que especifica el ID del proyecto de Google Cloud .
- PROJECT_ID: Es el ID del proyecto de Google Cloud .
Vuelve a cargar la ventana de VS Code. La extensión compatible con MCP detecta automáticamente la configuración y, luego, inicia el servidor.

Windsurf

Abre Windsurf y navega al asistente de Cascade.
Haz clic en el ícono de MCP y, luego, en Configurar para abrir el archivo de configuración.
Agrega la siguiente configuración, reemplaza los marcadores de posición por tus valores y guarda los cambios:
```
        {
          "mcpServers": {
            "storage": {
              "command": "./PATH/TO/toolbox",
              "args": ["--prebuilt","cloud-storage","--stdio"],
              "env": {
                "CLOUD_STORAGE_PROJECT": "PROJECT_ID"
              }
            }
          }
        }
        
```
Reemplaza las siguientes variables por tus valores:
- ./PATH/TO/toolbox: Es la ruta de acceso a tu objeto binario toolbox.
- CLOUD_STORAGE_PROJECT: Es la variable de entorno que especifica el ID del proyecto de Google Cloud .
- PROJECT_ID: Es el ID del proyecto de Google Cloud .

Herramientas prediseñadas

Después de conectar la caja de herramientas de MCP a Cloud Storage, tu agente usa las siguientes herramientas prediseñadas:

list_buckets: Enumera los buckets de Cloud Storage en el proyecto configurado.
list_objects: Enumera los objetos en un bucket con filtrado opcional de prefijo y delimitador.
get_bucket_metadata: Devuelve los metadatos de un bucket.
get_bucket_iam_policy: Devuelve las vinculaciones de políticas de IAM para un bucket.
get_object_metadata: Devuelve los metadatos de un objeto.
read_object: Lee un objeto de texto UTF-8 (o un rango de bytes). El límite es de 8 MiB, y se rechazan los objetos binarios.
download_object: Descarga un objeto a una ruta de acceso local.
create_bucket: Crea un bucket en el proyecto configurado.
delete_bucket: Borra un bucket vacío.
upload_object: Sube un archivo local a un objeto.
write_object: Escribe contenido de texto directamente en un objeto.
copy_object: Copia un objeto en un objeto de destino.
move_object: Cambia el nombre de un objeto de forma atómica dentro del mismo bucket.
delete_object: Borra un objeto.