Criar um banco de dados do AlloyDB usando a caixa de ferramentas do MCP no IDE

Nesta página, descrevemos como usar a Caixa de ferramentas do MCP para bancos de dados para criar e gerenciar seus clusters e instâncias do AlloyDB para PostgreSQL em ambientes de desenvolvimento integrados (IDEs). Você pode usar ferramentas para desenvolvedores que oferecem suporte ao Protocolo de Contexto de Modelo (MCP).

O Protocolo de Contexto de Modelo (MCP) é um protocolo aberto para conectar modelos de linguagem grandes (LLMs) a fontes de dados e APIs, como a API AlloyDB Admin. Um assistente de IA é uma interface de chat com tecnologia de LLM no seu ambiente de desenvolvimento integrado que ajuda você a alcançar suas metas e concluir tarefas. Nesta página, descrevemos como usar a MCP Toolbox for Databases para expor suas ferramentas de assistente de desenvolvedor a uma instância do AlloyDB usando os seguintes IDEs:

Antes de começar

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

  2. Verifique se o faturamento está ativado para seu projeto do Google Cloud . Saiba como verificar se o faturamento está ativado em um projeto.

  3. Ative a API AlloyDB Admin.

    Ativar a API

Funções exigidas

Para gerenciar recursos do AlloyDB, peça ao administrador para conceder a você os seguintes papéis do Identity and Access Management no seu projeto:

  • Administrador do AlloyDB (roles/alloydb.admin).
  • Consumidor do Service Usage (roles/serviceusage.serviceUsageConsumer).

Instalar a MCP Toolbox

  1. 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 e à arquitetura da CPU. Use a versão V0.10.0 ou mais recente da caixa de ferramentas do MCP.

    linux/amd64

    curl -O https://storage.googleapis.com/genai-toolbox/v0.10.0/linux/amd64/toolbox

    darwin/arm64

    curl -O https://storage.googleapis.com/genai-toolbox/v0.10.0/darwin/arm64/toolbox

    darwin/amd64

    curl -O https://storage.googleapis.com/genai-toolbox/v0.10.0/darwin/amd64/toolbox

    windows/amd64

    curl -O https://storage.googleapis.com/genai-toolbox/v0.10.0/windows/amd64/toolbox

  2. Torne o binário executável.

    chmod +x toolbox

  3. Verifique a instalação.

    ./toolbox --version

Configurar o cliente da MCP

É possível configurar seu ambiente de desenvolvimento integrado (IDE) para usar as ferramentas do plano de controle e criar e gerenciar clusters e instâncias do AlloyDB. Se você já tiver uma instância do AlloyDB, pule esta etapa e acesse Conectar seu ambiente de desenvolvimento integrado ao AlloyDB para PostgreSQL usando a caixa de ferramentas do MCP. As instâncias são criadas com um endereço IP público usando as ferramentas de plano de controle fornecidas. Adicione a seguinte configuração ao arquivo de configurações do MCP do seu ambiente de desenvolvimento integrado. Essa abordagem expõe a ferramenta alloydb-postgres-admin ao seu assistente de IA.

Código do Claude

  1. Instale o Claude Code.
  2. Crie um arquivo .mcp.json na raiz do projeto, se ele não existir.
  3. Gere um token de acesso para usar como API_KEY executando gcloud auth print-access-token.
  1. Adicione a seguinte configuração, substitua API_KEY pelo token gerado e salve.
{
  "mcpServers": {
    "alloydb-admin": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt", "alloydb-postgres-admin", "--stdio"],
      "env": {
        "API_KEY": "API_KEY"
      }
    }
  }
}

Claude para computador

  1. Abra o Claude para computador e acesse Configurações.
  2. Na guia Desenvolvedor, clique em Editar configuração para abrir o arquivo de configuração.
  3. Gere um token de acesso para usar como API_KEY executando gcloud auth print-access-token.

  1. Adicione a seguinte configuração, substitua API_KEY pelo token gerado e salve.

{
  "mcpServers": {
    "alloydb-admin": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt", "alloydb-postgres-admin", "--stdio"],
      "env": {
        "API_KEY": "API_KEY"
      }
    }
  }
}

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. Gere um token de acesso para usar como API_KEY executando gcloud auth print-access-token.

  1. Adicione a seguinte configuração, substitua API_KEY pelo token gerado e salve.

{
  "mcpServers": {
    "alloydb-admin": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt", "alloydb-postgres-admin", "--stdio"],
      "env": {
        "API_KEY": "API_KEY"
      }
    }
  }
}

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. Gere um token de acesso para usar como API_KEY executando gcloud auth print-access-token.
  1. Adicione a seguinte configuração, substitua API_KEY pelo token gerado e salve:

{
  "mcpServers": {
    "alloydb-admin": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt", "alloydb-postgres-admin", "--stdio"],
      "env": {
        "API_KEY": "API_KEY"
      }
    }
  }
}

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. Gere um token de acesso para usar como API_KEY executando gcloud auth print-access-token.
  1. Adicione a seguinte configuração, substitua API_KEY pelo token gerado e salve.

{
  "mcp":{
    "servers": {
      "alloydb-admin": {
        "command": "./PATH/TO/toolbox",
        "args": ["--prebuilt", "alloydb-postgres-admin", "--stdio"],
        "env": {
          "API_KEY": "API_KEY"
        }
      }
    }
  }
}

Windsurf

  1. Abra o Windsurf e navegue até o assistente do Cascade.
  2. Clique no ícone do MCP e em Configurar para abrir o arquivo de configuração.
  3. Gere um token de acesso para usar como API_KEY executando gcloud auth print-access-token.

  1. Adicione a seguinte configuração, substitua API_KEY pelo token gerado e salve.

{
  "mcpServers": {
    "alloydb-admin": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt", "alloydb-postgres-admin", "--stdio"],
      "env": {
        "API_KEY": "API_KEY"
      }
    }
  }
}

CLI do Gemini

  1. Instale a CLI do Gemini.
  2. No diretório de trabalho, crie uma pasta chamada .gemini. Nele, crie um arquivo settings.json.
  3. Gere um token de acesso para usar como API_KEY executando gcloud auth print-access-token.

  1. Adicione a seguinte configuração, substitua API_KEY pelo token gerado e salve.
{
  "mcpServers": {
    "alloydb-admin": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt", "alloydb-postgres-admin", "--stdio"],
      "env": {
        "API_KEY": "API_KEY"
      }
    }
  }
}

Gemini Code Assist

  1. Instale a extensão 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. Nele, crie um arquivo settings.json.
  4. Gere um token de acesso para usar como API_KEY executando gcloud auth print-access-token.

  1. Adicione a seguinte configuração, substitua API_KEY pelo token gerado e salve:

{
  "mcpServers": {
    "alloydb-admin": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt", "alloydb-postgres-admin", "--stdio"],
      "env": {
        "API_KEY": "API_KEY"
      }
    }
  }
}

Sua ferramenta de IA agora está conectada ao plano de controle do AlloyDB para PostgreSQL usando o MCP. Peça ao assistente de IA para criar um cluster ou uma instância.

Usar ferramentas de administrador

As seguintes ferramentas estão disponíveis para o LLM:

  • alloydb-create-cluster: cria um cluster do AlloyDB.
  • alloydb-create-instance: cria uma instância do AlloyDB (PRIMARY, READ_POOL ou SECONDARY).
  • alloydb-get-operation: pesquisa a API Operations até que a operação seja concluída.

Conectar aos seus dados

Depois de configurar um cluster e uma instância do AlloyDB, você pode conectar seu ambiente de desenvolvimento integrado (IDE) ao banco de dados para consultar seus dados. Para mais informações, consulte Conectar seu ambiente de desenvolvimento integrado ao AlloyDB usando a caixa de ferramentas do MCP.