Este guia mostra como usar a caixa de ferramentas da MCP para bases de dados para ligar a sua instância do Cloud SQL a vários ambientes de desenvolvimento integrados (IDEs) e ferramentas para programadores que suportam o protocolo de contexto do modelo (MCP). Use estas ferramentas para executar consultas SQL e interagir com a sua base de dados.
O Model Context Protocol (MCP) é um protocolo aberto para ligar grandes modelos de linguagem (GMLs) a origens de dados, como o Cloud SQL. Os IDEs suportados são:
- Cursor
- Windsurf
- Visual Studio Code (Copilot)
- Cline(extensão do VS Code)
- Claude para computador
- Código Claude
- CLI do Gemini
- Gemini Code Assist
Antes de começar
Na Google Cloud consola, na página do seletor de projetos, selecione ou crie um Google Cloud projeto.
Certifique-se de que a faturação está ativada para o seu Google Cloud projeto.
Verifique se o IP público está configurado para a instância do Cloud SQL. Por predefinição, o Cloud SQL atribui um endereço IP público a uma nova instância. A caixa de ferramentas estabelece ligação de forma segura através dos conetores de linguagem do Cloud SQL.
Configure as funções e as autorizações necessárias para concluir esta tarefa. Precisa da função Cloud SQL > Cliente (
roles/cloudsql.client) ou de autorizações do Identity and Access Management equivalentes para se ligar à instância.Configure as Credenciais padrão da aplicação (ADC) para o seu ambiente.
Crie ou reutilize um utilizador da base de dados e tenha o nome de utilizador e a palavra-passe preparados.
Instale a caixa de ferramentas do MCP
Para instalar o conjunto de ferramentas, transfira o ficheiro binário que corresponde ao seu sistema operativo e arquitetura da CPU.
linux/amd64
curl -O https://storage.googleapis.com/genai-toolbox/v0.7.0/linux/amd64/toolbox
darwin/arm64
curl -O https://storage.googleapis.com/genai-toolbox/v0.7.0/darwin/arm64/toolbox
darwin/amd64
curl -O https://storage.googleapis.com/genai-toolbox/v0.7.0/darwin/amd64/toolbox
windows/amd64
curl -O https://storage.googleapis.com/genai-toolbox/v0.7.0/windows/amd64/toolbox
Torne o executável binário:
chmod +x toolboxValide a instalação através do seguinte comando:
./toolbox --version
Configure o cliente MCP
Código do Claude
1. Instale o Claude Code.
2. Crie o ficheiro
.mcp.json na raiz do projeto, se não existir. 3. Adicione a configuração, substitua as variáveis de ambiente pelos seus valores e guarde:
{
"mcpServers": {
"cloud-sql-postgres": {
"command": "./PATH/TO/toolbox",
"args": ["--prebuilt","cloud-sql-postgres","--stdio"],
"env": {
"CLOUD_SQL_POSTGRES_PROJECT": "PROJECT_ID",
"CLOUD_SQL_POSTGRES_REGION": "REGION",
"CLOUD_SQL_POSTGRES_INSTANCE": "INSTANCE_ID",
"CLOUD_SQL_POSTGRES_DATABASE": "DATABASE_NAME",
"CLOUD_SQL_POSTGRES_USER": "USER_ID",
"CLOUD_SQL_POSTGRES_PASSWORD": "PASSWORD"
}
}
}
}
Claude para computador
1. Abra o Claude Desktop e navegue para Definições.
2. No separador Programador, toque em Editar config para abrir o ficheiro de configuração.
3. Adicione a configuração, substitua as variáveis de ambiente pelos seus valores e guarde:
{
"mcpServers": {
"cloud-sql-postgres": {
"command": "./PATH/TO/toolbox",
"args": ["--prebuilt","cloud-sql-postgres","--stdio"],
"env": {
"CLOUD_SQL_POSTGRES_PROJECT": "PROJECT_ID",
"CLOUD_SQL_POSTGRES_REGION": "REGION",
"CLOUD_SQL_POSTGRES_INSTANCE": "INSTANCE_ID",
"CLOUD_SQL_POSTGRES_DATABASE": "DATABASE_NAME",
"CLOUD_SQL_POSTGRES_USER": "USER_ID",
"CLOUD_SQL_POSTGRES_PASSWORD": "PASSWORD"
}
}
}
5. Reinicie o Claude Desktop.
6. O novo ecrã de chat apresenta um ícone de martelo (MCP) com o novo servidor MCP disponível.
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. Adicione a seguinte configuração, substitua as variáveis de ambiente pelos seus valores e guarde:
{
"mcpServers": {
"cloud-sql-postgres": {
"command": "./PATH/TO/toolbox",
"args": ["--prebuilt","cloud-sql-postgres","--stdio"],
"env": {
"CLOUD_SQL_POSTGRES_PROJECT": "PROJECT_ID",
"CLOUD_SQL_POSTGRES_REGION": "REGION",
"CLOUD_SQL_POSTGRES_INSTANCE": "INSTANCE_ID",
"CLOUD_SQL_POSTGRES_DATABASE": "DATABASE_NAME",
"CLOUD_SQL_POSTGRES_USER": "USER_ID",
"CLOUD_SQL_POSTGRES_PASSWORD": "PASSWORD"
}
}
}
}
4. É apresentado um estado ativo verde depois de o servidor se ligar com êxito.
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. Adicione a seguinte configuração, substitua as variáveis de ambiente pelos seus valores e guarde:
{
"mcpServers": {
"cloud-sql-postgres": {
"command": "./PATH/TO/toolbox",
"args": ["--prebuilt","cloud-sql-postgres","--stdio"],
"env": {
"CLOUD_SQL_POSTGRES_PROJECT": "PROJECT_ID",
"CLOUD_SQL_POSTGRES_REGION": "REGION",
"CLOUD_SQL_POSTGRES_INSTANCE": "INSTANCE_ID",
"CLOUD_SQL_POSTGRES_DATABASE": "DATABASE_NAME",
"CLOUD_SQL_POSTGRES_USER": "USER_ID",
"CLOUD_SQL_POSTGRES_PASSWORD": "PASSWORD"
}
}
}
}
4. Abra o Cursor e navegue para Definições > Definições do cursor > MCP. É apresentado um estado ativo verde quando o servidor se liga.
Visual Studio Code (Copilot)
1. Abra o VS Code e crie o diretório
.vscode na raiz do projeto, se não existir. 2. Cria o ficheiro
.vscode/mcp.json se não existir e abre-o. 3. Adicione a seguinte configuração, substitua as variáveis de ambiente pelos seus valores e guarde:
{
"servers": {
"cloud-sql-postgres": {
"command": "./PATH/TO/toolbox",
"args": ["--prebuilt","cloud-sql-postgres","--stdio"],
"env": {
"CLOUD_SQL_POSTGRES_PROJECT": "PROJECT_ID",
"CLOUD_SQL_POSTGRES_REGION": "REGION",
"CLOUD_SQL_POSTGRES_INSTANCE": "INSTANCE_ID",
"CLOUD_SQL_POSTGRES_DATABASE": "DATABASE_NAME",
"CLOUD_SQL_POSTGRES_USER": "USER_ID",
"CLOUD_SQL_POSTGRES_PASSWORD": "PASSWORD"
}
}
}
}
Windsurf
1. Abra o Windsurf e navegue para o assistente Cascade.
2. Toque no ícone do MCP e, de seguida, em Configurar para abrir o ficheiro de configuração.
3. Adicione a seguinte configuração, substitua as variáveis de ambiente pelos seus valores e guarde:
{
"mcpServers": {
"cloud-sql-postgres": {
"command": "./PATH/TO/toolbox",
"args": ["--prebuilt","cloud-sql-postgres","--stdio"],
"env": {
"CLOUD_SQL_POSTGRES_PROJECT": "PROJECT_ID",
"CLOUD_SQL_POSTGRES_REGION": "REGION",
"CLOUD_SQL_POSTGRES_INSTANCE": "INSTANCE_ID",
"CLOUD_SQL_POSTGRES_DATABASE": "DATABASE_NAME",
"CLOUD_SQL_POSTGRES_USER": "USER_ID",
"CLOUD_SQL_POSTGRES_PASSWORD": "PASSWORD"
}
}
}
}
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. Adicione a seguinte configuração, substitua as variáveis de ambiente pelos seus valores e, de seguida, guarde:
{
"mcpServers": {
"cloud-sql-postgres": {
"command": "./PATH/TO/toolbox",
"args": ["--prebuilt","cloud-sql-postgres","--stdio"],
"env": {
"CLOUD_SQL_POSTGRES_PROJECT": "PROJECT_ID",
"CLOUD_SQL_POSTGRES_REGION": "REGION",
"CLOUD_SQL_POSTGRES_INSTANCE": "INSTANCE_ID",
"CLOUD_SQL_POSTGRES_DATABASE": "DATABASE_NAME",
"CLOUD_SQL_POSTGRES_USER": "USER_ID",
"CLOUD_SQL_POSTGRES_PASSWORD": "PASSWORD"
}
}
}
}
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. Adicione a seguinte configuração, substitua as variáveis de ambiente pelos seus valores e, de seguida, guarde:
{
"mcpServers": {
"cloud-sql-postgres": {
"command": "./PATH/TO/toolbox",
"args": ["--prebuilt","cloud-sql-postgres","--stdio"],
"env": {
"CLOUD_SQL_POSTGRES_PROJECT": "PROJECT_ID",
"CLOUD_SQL_POSTGRES_REGION": "REGION",
"CLOUD_SQL_POSTGRES_INSTANCE": "INSTANCE_ID",
"CLOUD_SQL_POSTGRES_DATABASE": "DATABASE_NAME",
"CLOUD_SQL_POSTGRES_USER": "USER_ID",
"CLOUD_SQL_POSTGRES_PASSWORD": "PASSWORD"
}
}
}
}
Use ferramentas
A sua ferramenta de IA está agora ligada ao Cloud SQL através do MCP. Experimente pedir ao assistente de IA para listar tabelas, criar uma tabela ou definir e executar outras declarações SQL.
As seguintes ferramentas estão disponíveis para o MDG:
- list_tables: apresenta tabelas e descrições
- execute_sql: executar qualquer declaração SQL