Conectar LLMs ao Cloud Storage com o MCP

É possível executar um servidor local do Protocolo de Contexto de Modelo (MCP) com a MCP Toolbox for Databases para interagir com o Cloud Storage diretamente do seu ambiente de desenvolvimento integrado e das ferramentas para desenvolvedores. Essa configuração permite que modelos de linguagem grandes (LLMs) em clientes como Antigravity, Claude, Cline, Cursor, Visual Studio Code (Copilot) e Windsurf criem buckets, gerenciem dados de objetos e inspecionem políticas do Identity and Access Management (IAM).

O MCP Toolbox de código aberto é compatível com a autenticação OAuth2 e OIDC e se integra ao OpenTelemetry para observabilidade. A integração com o Cloud Storage requer a versão 1.2.0 ou mais recente do MCP Toolbox. Para executar um servidor MCP local independente sem o toolbox, use o repositório do GitHub do MCP do Cloud Storage.

Antes de começar

  1. No console do Cloud de Confiance , na página do seletor de projetos, selecione ou crie um projeto do Cloud de Confiance by S3NS .

  2. Verifique se o faturamento está ativado para o projeto do Cloud de Confiance .

  3. Ative a API Storage do Cloud Storage no Cloud de Confiance projeto.

  4. Configure os papéis e as permissões necessários para concluir esta tarefa. O usuário que invoca os agentes de LLM precisa ter os seguintes papéis no nível do bucket ou do projeto:

    • Para listar, criar e excluir buckets vazios: Administrador do Storage (roles/storage.admin)
    • Para listar objetos, ler objetos, receber 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)

  5. Configure o Application Default Credentials (ADC) para seu ambiente.

Conectar-se ao 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 do catálogo integrado da MCP Store.

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

  1. Verifique se o npx está instalado e configurado corretamente no sistema executando npx --version no terminal. Se você precisar instalar o Node.js, que inclui o npx, consulte o guia do npm Como fazer o download e instalar o Node.js e o npm.
  2. Abra o Antigravity e acesse a loja do MCP usando o menu suspenso "..." na parte de cima do painel do agente do editor.
  3. Para abrir o arquivo mcp_config.json, clique em Servidores MCP e em Gerenciar servidores MCP > Ver configuração bruta.
  4. Adicione a configuração a seguir, substitua o marcador de posição 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 o MCP Toolbox

A caixa de ferramentas é um servidor de código aberto do Protocolo de Contexto de Modelo (MCP) que é executado localmente na sua máquina. O servidor local gerencia a comunicação entre o ambiente de desenvolvimento integrado e o Cloud Storage. Essa conexão oferece um ambiente seguro e eficiente para suas ferramentas de IA.

  1. Faça o download da versão mais recente do MCP Toolbox como um binário. Selecione o binário correspondente ao seu sistema operacional (SO) e à arquitetura de CPU. Use a versão 1.2.0 ou mais recente do MCP Toolbox:

    linux/amd64

    curl -O https://storage.googleapis.com/mcp-toolbox-for-databases/VERSION/linux/amd64/toolbox

    Substitua VERSION pela versão do 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 do 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 do 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 do MCP Toolbox, por exemplo, v1.2.0.

  2. Torne o binário executável:

    chmod +x toolbox

  3. Verifique a instalação:

    ./toolbox --version

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

Configurar clientes e conexões

Nesta seção, descrevemos como conectar o Cloud Storage às suas ferramentas depois de instalar o MCP Toolbox.

Claude Code

  1. Instale o Claude Code.
  2. Crie um arquivo .mcp.json na raiz do projeto, se ele não existir.
  3. Adicione a configuração, substitua os marcadores de posição pelos seus 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 ID do projeto do Cloud de Confiance .
    • PROJECT_ID: o ID do projeto do Cloud de Confiance by S3NS .
  4. 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 para computador

  1. Abra o Claude Desktop e acesse Configurações.
  2. Na guia Desenvolvedor, clique em Editar configuração para abrir o arquivo de configuração.
  3. Adicione a configuração, substitua os marcadores de posição pelos seus 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 ID do projeto do Cloud de Confiance .
    • PROJECT_ID: o ID do projeto do Cloud de Confiance by S3NS .
  4. Reinicie o Claude Desktop.
  5. A nova tela de chat mostra um ícone de martelo (MCP) com o novo servidor MCP.

Cline

  1. Abra a extensão Cline no VS Code e clique no ícone Servidores MCP.
  2. Clique em Configurar servidores MCP para abrir o arquivo de configuração.
  3. Adicione a configuração a seguir, substitua os marcadores de posição pelos seus 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 ID do projeto do Cloud de Confiance .
    • PROJECT_ID: o ID do projeto do Cloud de Confiance by S3NS .

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 os marcadores de posição pelos seus 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 ID do projeto do Cloud de Confiance .
    • PROJECT_ID: o ID do projeto do Cloud de Confiance by S3NS .
  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 um 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 os marcadores de posição pelos seus 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 ID do projeto do Cloud de Confiance .
    • PROJECT_ID: o ID do projeto do Cloud de Confiance by S3NS .
  4. Atualize a janela do VS Code. A extensão compatível com o MCP detecta automaticamente a configuração e inicia o servidor.

Windsurf

  1. Abra o Windsurf e acesse o assistente Cascade.
  2. Clique no ícone do MCP e em Configurar para abrir o arquivo de configuração.
  3. Adicione a configuração a seguir, substitua os marcadores de posição pelos seus 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 ID do projeto do Cloud de Confiance .
    • PROJECT_ID: o ID do projeto do Cloud de Confiance by S3NS .

Ferramentas pré-criadas

Depois de conectar o MCP Toolbox ao Cloud Storage, seu agente vai usar 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 da política do 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 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.