O Google usa tecnologia de IA na tradução de conteúdos para seu idioma de preferência. As traduções com IA podem ter erros.

Conectar LLMs ao Cloud Storage com o MCP

Este guia mostra como conectar o Cloud Storage a ambientes de desenvolvimento integrado (IDEs, na sigla em inglês) e ferramentas de desenvolvedor. Para fazer isso, execute um servidor MCP local na sua máquina usando a MCP Toolbox for Databases.

A MCP Toolbox for Databases é um repositório de código aberto que contém conectores para bancos de dados e datastores, incluindo Cloud Storage, BigQuery, AlloyDB, Spanner e Cloud SQL. A caixa de ferramentas oferece suporte à autenticação OAuth2 e OIDC e se integra ao Open Telemetry para observabilidade. A integração da caixa de ferramentas do Cloud Storage permite que você use um LLM para realizar as seguintes ações:

Criar, listar e excluir buckets.
Acessar metadados de buckets e objetos.
Acessar políticas do Identity and Access Management (IAM, na sigla em inglês) nos seus buckets.
Ler, gravar, fazer upload e download de objetos.
Copiar ou mover objetos.

Este guia demonstra o processo de conexão para os seguintes IDEs e ferramentas:

Cursor
Windsurf (antigo Codeium)
Visual Studio Code (Copilot)
Cline (extensão do VS Code)
Claude Desktop
Claude Code
Antigravity

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 Storage do Cloud Storage no Google Cloud projeto.
Configure os papéis e permissões necessários para concluir essa tarefa. O usuário que invoca os agentes LLM precisa dos seguintes papéis no nível do bucket ou do projeto:
- Para listar buckets, criar buckets e excluir buckets vazios: Administrador do Storage (roles/storage.admin)
- Para listar objetos, ler objetos, acessar metadados de objetos ou metadados de buckets: Leitor de objetos do Storage (roles/storage.objectViewer)
- Para gravar conteúdo em um objeto ou fazer upload de um objeto: Criador de objetos do Storage (roles/storage.objectCreator)
- Para copiar, mover ou excluir objetos: Administrador de objetos do Storage (roles/storage.objectAdmin)
Configure o Application Default Credentials (ADC) para seu ambiente.

Conectar com o Antigravity

Você conecta o Cloud Storage ao Antigravity usando uma configuração personalizada. Nesse contexto, um servidor MCP personalizado é um servidor que você configura manualmente editando o arquivo de configuração (como mcp_config.json). Essa configuração manual é usada em vez de instalar o servidor diretamente no catálogo da MCP Store integrada.

Para configurar um servidor MCP personalizado, faça o seguinte:

Verifique se o npx está instalado e configurado corretamente no seu sistema executando npx --version no terminal. Se você precisar instalar o Node.js, que inclui o npx, consulte o guia Como fazer o download e instalar o Node.js e o npm.
Abra Antigravity e navegue até a MCP Store usando o menu suspenso "..." na parte de cima do painel do agente do editor.
Para abrir o arquivo mcp_config.json, clique em Servidores MCP e em Gerenciar servidores MCP > Ver configuração bruta.

Adicione a seguinte configuração, substitua o marcador pelo ID do projeto e salve:

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

Instalar a MCP Toolbox

A caixa de ferramentas é um servidor de protocolo de contexto de modelo (MCP, na sigla em inglês) de código aberto que é executado localmente na sua máquina. O servidor local gerencia a comunicação entre o IDE e o Cloud Storage. Essa conexão oferece um ambiente seguro e eficiente para suas ferramentas de IA.

Faça o download da versão mais recente da MCP Toolbox como um binário. Selecione o binário correspondente ao seu sistema operacional (SO) e à arquitetura de CPU. É necessário usar a versão 1.2.0 ou mais recente da MCP Toolbox:
linux/amd64
curl -O https://storage.googleapis.com/mcp-toolbox-for-databases/VERSION/linux/amd64/toolbox
Substitua VERSION pela versão da MCP Toolbox, por exemplo, v1.2.0.
macOS darwin/arm64
curl -O https://storage.googleapis.com/mcp-toolbox-for-databases/VERSION/darwin/arm64/toolbox
Substitua VERSION pela versão da MCP Toolbox, por exemplo, v1.2.0.
macOS darwin/amd64
curl -O https://storage.googleapis.com/mcp-toolbox-for-databases/VERSION/darwin/amd64/toolbox
Substitua VERSION pela versão da MCP Toolbox, por exemplo, v1.2.0.
windows/amd64
curl -O https://storage.googleapis.com/mcp-toolbox-for-databases/VERSION/windows/amd64/toolbox
Substitua VERSION pela versão da MCP Toolbox, por exemplo, v1.2.0.
Torne o binário executável:
```
chmod +x toolbox
```
Verifique a instalação:
```
./toolbox --version
```

Para configurar a caixa de ferramentas com uma imagem do contêiner ou Homebrew, consulte a página Instalar a caixa de ferramentas.

Configurar clientes e conexões

Esta seção descreve como conectar o Cloud Storage às suas ferramentas depois de instalar a MCP Toolbox.

Claude Code

Instale o Claude Code.
Crie um arquivo .mcp.json na raiz do projeto, se ele não existir.

Adicione a configuração, substitua os marcadores pelos valores e salve:

        {
          "mcpServers": {
            "storage": {
              "command": "./PATH/TO/toolbox",
              "args": ["--prebuilt","cloud-storage","--stdio"],
              "env": {
                "CLOUD_STORAGE_PROJECT": "PROJECT_ID"
              }
            }
          }
        }

Substitua as seguintes variáveis pelos seus valores:

./PATH/TO/toolbox: o caminho para o binário toolbox.
CLOUD_STORAGE_PROJECT: a variável de ambiente que especifica o Google Cloud ID do projeto.
PROJECT_ID: o ID do projeto do Google Cloud .

Reinicie o Claude Code para carregar as novas configurações. Quando o Claude Code for reaberto, o aplicativo vai detectar o servidor MCP configurado.

Claude Desktop

Abra o Claude Desktop e navegue até Configurações.
Na guia Desenvolvedor, clique em Editar configuração para abrir o arquivo de configuração.

Adicione a configuração, substitua os marcadores pelos valores e salve:

        {
          "mcpServers": {
            "storage": {
              "command": "./PATH/TO/toolbox",
              "args": ["--prebuilt","cloud-storage","--stdio"],
              "env": {
                "CLOUD_STORAGE_PROJECT": "PROJECT_ID"
              }
            }
          }
        }

Substitua as seguintes variáveis pelos seus valores:

./PATH/TO/toolbox: o caminho para o binário toolbox.
CLOUD_STORAGE_PROJECT: a variável de ambiente que especifica o Google Cloud ID do projeto.
PROJECT_ID: o ID do projeto do Google Cloud .

Reinicie o Claude Desktop.
A nova tela de chat mostra um ícone de martelo (MCP) com o novo servidor MCP.

Cline

Abra a extensão Cline no VS Code e clique no ícone Servidores MCP.
Clique em Configurar servidores MCP para abrir o arquivo de configuração.

Adicione a seguinte configuração, substitua os marcadores pelos valores e salve:

        {
          "mcpServers": {
            "storage": {
              "command": "./PATH/TO/toolbox",
              "args": ["--prebuilt","cloud-storage","--stdio"],
              "env": {
                "CLOUD_STORAGE_PROJECT": "PROJECT_ID"
              }
            }
          }
        }

Substitua as seguintes variáveis pelos seus valores:

./PATH/TO/toolbox: o caminho para o binário toolbox.
CLOUD_STORAGE_PROJECT: a variável de ambiente que especifica o Google Cloud ID do projeto.
PROJECT_ID: o ID do projeto do Google Cloud .

Um status ativo verde aparece depois que o servidor se conecta.

Cursor

Crie o diretório .cursor na raiz do projeto, se ele não existir.
Crie o arquivo .cursor/mcp.json se ele não existir e abra-o.

Adicione a seguinte configuração, substitua os marcadores pelos valores e salve:

        {
          "mcpServers": {
            "storage": {
              "command": "./PATH/TO/toolbox",
              "args": ["--prebuilt","cloud-storage","--stdio"],
              "env": {
                "CLOUD_STORAGE_PROJECT": "PROJECT_ID"
              }
            }
          }
        }

Substitua as seguintes variáveis pelos seus valores:

./PATH/TO/toolbox: o caminho para o binário toolbox.
CLOUD_STORAGE_PROJECT: a variável de ambiente que especifica o Google Cloud ID do projeto.
PROJECT_ID: o ID do projeto do Google Cloud .

Abra o Cursor e navegue até 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 um diretório .vscode na raiz do projeto, se ele não existir.
Crie o arquivo .vscode/mcp.json se ele não existir e abra-o.

Adicione a seguinte configuração, substitua os marcadores pelos valores e salve:

        {
          "mcpServers": {
            "storage": {
              "command": "./PATH/TO/toolbox",
              "args": ["--prebuilt","cloud-storage","--stdio"],
              "env": {
                "CLOUD_STORAGE_PROJECT": "PROJECT_ID"
              }
            }
          }
        }

Substitua as seguintes variáveis pelos seus valores:

./PATH/TO/toolbox: o caminho para o binário toolbox.
CLOUD_STORAGE_PROJECT: a variável de ambiente que especifica o Google Cloud ID do projeto.
PROJECT_ID: o ID do projeto do Google Cloud .

Recarregue a janela do VS Code. A extensão compatível com MCP detecta automaticamente a configuração e inicia o servidor.

Windsurf

Abra o Windsurf e navegue até o assistente Cascade.
Clique no ícone MCP e em Configurar para abrir o arquivo de configuração.

Adicione a seguinte configuração, substitua os marcadores pelos valores e salve:

        {
          "mcpServers": {
            "storage": {
              "command": "./PATH/TO/toolbox",
              "args": ["--prebuilt","cloud-storage","--stdio"],
              "env": {
                "CLOUD_STORAGE_PROJECT": "PROJECT_ID"
              }
            }
          }
        }

Substitua as seguintes variáveis pelos seus valores:

./PATH/TO/toolbox: o caminho para o binário toolbox.
CLOUD_STORAGE_PROJECT: a variável de ambiente que especifica o Google Cloud ID do projeto.
PROJECT_ID: o ID do projeto do Google Cloud .

Ferramentas pré-criadas

Depois de conectar a MCP Toolbox ao Cloud Storage, o agente usa as seguintes ferramentas pré-criadas:

list_buckets: lista os buckets do Cloud Storage no projeto configurado.
list_objects: lista objetos em um bucket com filtragem opcional de prefixo e delimitador.
get_bucket_metadata: retorna metadados de um bucket.
get_bucket_iam_policy: retorna as vinculações de política de IAM de um bucket.
get_object_metadata: retorna metadados de um objeto.
read_object: lê um objeto de texto UTF-8 (ou intervalo de bytes). Limitado a 8 MiB; objetos binários são rejeitados.
download_object: faz o download de um objeto para um caminho local.
create_bucket: cria um bucket no projeto configurado.
delete_bucket: exclui um bucket vazio.
upload_object: faz o upload de um arquivo local para um objeto.
write_object: grava conteúdo de texto diretamente em um objeto.
copy_object: copia um objeto para um objeto de destino.
move_object: renomeia atomicamente um objeto no mesmo bucket.
delete_object: exclui um objeto.

Conectar LLMs ao Cloud Storage com o MCP Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Antes de começar

Conectar com o Antigravity

Instalar a MCP Toolbox

linux/amd64

macOS darwin/arm64

macOS darwin/amd64

windows/amd64

Configurar clientes e conexões

Claude Code

Claude Desktop

Cline

Cursor

Visual Studio Code (Copilot)

Windsurf

Ferramentas pré-criadas

Conectar LLMs ao Cloud Storage com o MCP