Crie uma base de dados do AlloyDB através da caixa de ferramentas da MCP no IDE

Esta página descreve como usar a caixa de ferramentas da MCP para bases de dados para criar e gerir os seus clusters e instâncias do AlloyDB for PostgreSQL a partir de ambientes de desenvolvimento integrados (IDEs). Pode usar ferramentas para programadores compatíveis com o protocolo Model Context Protocol (MCP).

O protocolo Model Context Protocol (MCP) é um protocolo aberto para ligar modelos de linguagem (conteúdo extenso) (MDIs/CEs) a origens de dados e APIs, como a API AlloyDB. Um assistente de IA é uma interface de chat com tecnologia de MDIs no seu IDE que ajuda a alcançar os seus objetivos e a concluir tarefas. Esta página descreve como usar a caixa de ferramentas do MCP para bases de dados para expor as suas ferramentas de assistente para programadores a uma instância do AlloyDB através dos seguintes IDEs:

Antes de começar

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

  2. Certifique-se de que a faturação está ativada para o seu Google Cloud projeto. Saiba como verificar se a faturação está ativada num projeto.

  3. Ative a API AlloyDB Admin.

    Ative a API

Funções necessárias

Para gerir recursos do AlloyDB, peça ao seu administrador para lhe conceder as seguintes funções de gestão de identidade e acesso no seu projeto:

  • AlloyDB Admin (roles/alloydb.admin).
  • Consumidor de utilização de serviços (roles/serviceusage.serviceUsageConsumer).

Instale a caixa de ferramentas do MCP

  1. Transfira a versão mais recente da caixa de ferramentas do MCP como um ficheiro binário. Selecione o binário correspondente ao seu sistema operativo (SO) e arquitetura da CPU. Tem de usar a versão V0.10.0 ou posterior 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. Tornar o ficheiro binário executável.

    chmod +x toolbox

  3. Valide a instalação.

    ./toolbox --version

Configure o cliente do MCP

Pode configurar o seu IDE para usar as ferramentas do plano de controlo para criar e gerir clusters e instâncias do AlloyDB. Se já tiver uma instância do AlloyDB, ignore este passo e aceda a Associe o seu IDE ao AlloyDB for PostgreSQL através da caixa de ferramentas do MCP. As instâncias são criadas com um endereço IP público através das ferramentas de plano de controlo fornecidas. Adicione a seguinte configuração ao ficheiro de definições do MCP do seu IDE. Esta 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 ficheiro .mcp.json na raiz do projeto, se 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 guarde.
{
  "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 Desktop e navegue para Definições.
  2. No separador Programador, clique em Editar configuração para abrir o ficheiro 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 guarde.

{
  "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 ficheiro 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 guarde.

{
  "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 não existir.
  2. Crie o ficheiro .cursor/mcp.json, se 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 guarde:

{
  "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 não existir.
  2. Crie o ficheiro .vscode/mcp.json, se 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 guarde.

{
  "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 para o assistente Cascade.
  2. Clique no ícone do MCP e, de seguida, em Configurar para abrir o ficheiro 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 guarde.

{
  "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 seu diretório de trabalho, crie uma pasta denominada .gemini. No interior, crie um ficheiro 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, de seguida, guarde.
{
  "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 de agente no chat do Gemini Code Assist.
  3. No seu diretório de trabalho, crie uma pasta denominada .gemini. No interior, crie um ficheiro 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, de seguida, guarde:

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

A sua ferramenta de IA está agora ligada ao plano de controlo do AlloyDB for PostgreSQL através do MCP. Peça ao seu assistente de IA para criar um cluster ou uma instância.

Use ferramentas de administrador

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

  • alloydb-create-cluster: cria um cluster do AlloyDB.
  • alloydb-create-instance: cria uma instância do AlloyDB (PRIMARY, READ_POOL ou SECONDARY).
  • alloydb-create-user: cria utilizadores baseados em ALLOYDB_BUILT_IN ou IAM para um cluster do AlloyDB.
  • alloydb-get-operation: consulta a API Operations até que a operação esteja concluída.
  • alloydb-list-clusters: lista os clusters num determinado projeto e localização.
  • alloydb-list-instances: lista as instâncias num determinado projeto e localização.
  • alloydb-list-users: lista os utilizadores num determinado projeto e localização.

Associe aos seus dados

Depois de configurar um cluster e uma instância do AlloyDB, pode ligar o IDE à base de dados para consultar os seus dados. Para mais informações, consulte o artigo Associe o seu IDE ao AlloyDB através do MCP Toolbox.