Esta página foi traduzida pela API Cloud Translation.

Associe o seu IDE ao Firestore através da MCP Toolbox

Esta página descreve como usar a caixa de ferramentas do MCP para bases de dados para associar a sua instância do Firestore a ambientes de desenvolvimento integrados (IDEs) e ferramentas para programadores que suportam o protocolo Model Context Protocol (MCP). Use estas ferramentas para executar consultas e interagir com a sua base de dados. Este guia destina-se a programadores que usam os respetivos IDEs e ferramentas para programadores existentes para trabalhar com o Firestore.

O protocolo Model Context Protocol (MCP) é um protocolo aberto para ligar grandes modelos de linguagem (GMLs) a origens de dados, como o Firestore. Esta página descreve como usar a caixa de ferramentas do MCP para bases de dados para expor as suas ferramentas de assistência ao programador a uma instância do Firestore através dos seguintes IDEs:

Cursor
Windsurf (Codium)
Visual Studio Code (Copilot)
Cline (extensão do VS Code)
Claude para computador
Código Claude
CLI do Gemini
Gemini Code Assist

Configure o Firestore

Crie um novo Google Cloud projeto ou selecione um existente.
Ative a API Firestore para o seu projeto.
Crie uma base de dados do Firestore, se ainda não o fez.
Configure a autenticação para o seu ambiente local.
- Instale a CLI gcloud
- Execute gcloud auth application-default login para autenticar

Instale a caixa de ferramentas do MCP

Transfira a versão mais recente da MCP Toolbox 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.13.0 ou posterior da caixa de ferramentas do MCP.
linux/amd64
curl -O https://storage.googleapis.com/genai-toolbox/version/linux/amd64/toolbox
Substitua version pelo número da versão da caixa de ferramentas do MCP, por exemplo, v0.13.0.
darwin/arm64
curl -O https://storage.googleapis.com/genai-toolbox/version/darwin/arm64/toolbox
Substitua version pelo número da versão da caixa de ferramentas do MCP, por exemplo, v0.13.0.
darwin/amd64
curl -O https://storage.googleapis.com/genai-toolbox/version/darwin/amd64/toolbox
Substitua version pelo número da versão da caixa de ferramentas do MCP, por exemplo, v0.13.0.
windows/amd64
curl -O https://storage.googleapis.com/genai-toolbox/version/windows/amd64/toolbox
Substitua version pelo número da versão da caixa de ferramentas do MCP, por exemplo, v0.13.0.
Torne o ficheiro binário executável.
```
chmod +x toolbox
```
Valide a instalação.
```
./toolbox --version
```

Configure o cliente do MCP

Código do Claude

Instale o Claude Code.
Crie o ficheiro .mcp.json na raiz do projeto, se não existir.
Adicione a seguinte configuração, substitua as variáveis de ambiente pelos seus valores e guarde.

 {
    "mcpServers": {
      "firestore": {
        "command": "./PATH/TO/toolbox",
        "args": ["--prebuilt","firestore","--stdio"],
        "env": {
          "FIRESTORE_PROJECT": "PROJECT_ID",
          "FIRESTORE_DATABASE": "DATABASE_NAME"
        }
      }
    }
  }

Reinicie o código do Claude para aplicar a nova configuração.

Claude para computador

Abra o Claude Desktop e navegue para Definições.
No separador Programador, clique em Editar configuração para abrir o ficheiro de configuração.
Adicione a seguinte configuração, substitua as variáveis de ambiente pelos seus valores e guarde.

 {
    "mcpServers": {
      "firestore": {
        "command": "./PATH/TO/toolbox",
        "args": ["--prebuilt","firestore","--stdio"],
        "env": {
          "FIRESTORE_PROJECT": "PROJECT_ID",
          "FIRESTORE_DATABASE": "DATABASE_NAME"
        }
      }
    }
  }

Reinicie o Claude Desktop.
No novo ecrã de chat, deve ver um ícone de martelo (MCP) com o novo servidor MCP disponível.

Cline

Abra a extensão Cline no VS Code e toque no ícone Servidores MCP.
Clique em Configurar servidores MCP para abrir o ficheiro de configuração.
Adicione a seguinte configuração, substitua as variáveis de ambiente pelos seus valores e guarde.

 {
    "mcpServers": {
      "firestore": {
        "command": "./PATH/TO/toolbox",
        "args": ["--prebuilt","firestore","--stdio"],
        "env": {
          "FIRESTORE_PROJECT": "PROJECT_ID",
          "FIRESTORE_DATABASE": "DATABASE_NAME"
        }
      }
    }
  }

É apresentado um estado ativo verde depois de o servidor se ligar com êxito.

Cursor

Crie o diretório .cursor na raiz do projeto, se não existir.
Crie o ficheiro .cursor/mcp.json, se não existir, e abra-o.
Adicione a seguinte configuração, substitua as variáveis de ambiente pelos seus valores e guarde.

 {
    "mcpServers": {
      "firestore": {
        "command": "./PATH/TO/toolbox",
        "args": ["--prebuilt","firestore","--stdio"],
        "env": {
          "FIRESTORE_PROJECT": "PROJECT_ID",
          "FIRESTORE_DATABASE": "DATABASE_NAME"
        }
      }
    }
  }

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)

Abra o VS Code e crie o diretório .vscode na raiz do projeto, se não existir.
Crie o ficheiro .vscode/mcp.json, se não existir, e abra-o.
Adicione a seguinte configuração, substitua as variáveis de ambiente pelos seus valores e guarde.

 {
    "servers":{
      "firestore": {
        "command": "./PATH/TO/toolbox",
        "args": ["--prebuilt","firestore","--stdio"],
        "env": {
          "FIRESTORE_PROJECT": "PROJECT_ID",
          "FIRESTORE_DATABASE": "DATABASE_NAME"
        }
      }
    }
  }

Windsurf

Abra o Windsurf e navegue para o assistente Cascade.
Clique no ícone do MCP e, de seguida, em Configurar para abrir o ficheiro de configuração.
Adicione a seguinte configuração, substitua as variáveis de ambiente pelos seus valores e guarde.

 {
    "mcpServers": {
      "firestore": {
        "command": "./PATH/TO/toolbox",
        "args": ["--prebuilt","firestore","--stdio"],
        "env": {
          "FIRESTORE_PROJECT": "PROJECT_ID",
          "FIRESTORE_DATABASE": "DATABASE_NAME"
        }
      }
    }
  }

CLI do Gemini

Instale a CLI do Gemini.
No seu diretório de trabalho, crie uma pasta denominada .gemini. No interior, crie um ficheiro settings.json.
Adicione a seguinte configuração, substitua as variáveis de ambiente pelos seus valores e, de seguida, guarde.

 {
    "mcpServers": {
      "firestore": {
        "command": "./PATH/TO/toolbox",
        "args": ["--prebuilt","firestore","--stdio"],
        "env": {
          "FIRESTORE_PROJECT": "PROJECT_ID",
          "FIRESTORE_DATABASE": "DATABASE_NAME"
        }
      }
    }
  }

Gemini Code Assist

Instale a extensão Gemini Code Assist no Visual Studio Code.
Ative o modo de agente no chat do Gemini Code Assist.
No seu diretório de trabalho, crie uma pasta denominada .gemini. No interior, crie um ficheiro settings.json.
Adicione a seguinte configuração, substitua as variáveis de ambiente pelos seus valores e, de seguida, guarde.

 {
    "mcpServers": {
      "firestore": {
        "command": "./PATH/TO/toolbox",
        "args": ["--prebuilt","firestore","--stdio"],
        "env": {
          "FIRESTORE_PROJECT": "PROJECT_ID",
          "FIRESTORE_DATABASE": "DATABASE_NAME"
        }
      }
    }
  }

Use as ferramentas

A sua ferramenta de IA está agora ligada ao Firestore através do MCP. Experimente pedir ao seu assistente de IA para listar coleções, obter documentos, consultar coleções ou gerir regras de segurança.

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

firestore-add-documents: adicione um documento a um caminho de coleção do Firestore.
firestore-get-documents: recebe vários documentos do Firestore pelos respetivos caminhos.
firestore-list-collections: lista as coleções do Firestore para um determinado caminho principal.
firestore-delete-documents: elimine vários documentos do Firestore.
firestore-query-collection: consulte documentos de uma coleção com opções de filtragem, ordenação e limite.
firestore-get-rules: obtém as regras de segurança do Firestore ativas para o projeto atual.
firestore-update-document: atualize um documento existente no Firestore através do respetivo caminho.
firestore-validate-rules: valida a sintaxe e os erros das regras de segurança do Firestore.