Esta página foi traduzida pela API Cloud Translation.

Use o Firestore com o MCP, a CLI do Gemini e outros agentes

Esta página mostra-lhe como associar a sua base de dados do Firestore a várias ferramentas para programadores.

Para uma experiência integrada, recomendamos que use a extensão do Firestore dedicada para a CLI Gemini. Como interface de linha de comandos de próxima geração do Google Cloud, a CLI Gemini agrupa o servidor MCP subjacente diretamente na extensão, o que elimina a necessidade de uma configuração de servidor separada. Pode configurar o Gemini Code Assist para usar a CLI do Gemini, oferecendo vantagens de configuração semelhantes no seu IDE.

Para outras ferramentas para programadores que suportam o protocolo Model Context Protocol (MCP), pode estabelecer ligação configurando manualmente a caixa de ferramentas do MCP para bases de dados. A caixa de ferramentas MCP é um servidor MCP de código aberto que liga agentes de IA aos seus dados através da gestão de tarefas como a autenticação e a partilha de ligações. Isto permite-lhe interagir com os seus dados através de linguagem natural diretamente a partir do IDE. Para estas ferramentas, este método oferece capacidades de interação com a base de dados essenciais. Esta página descreve como usar a caixa de ferramentas do MCP para bases de dados para expor as suas ferramentas de assistência para programadores a uma instância do Firestore usando os seguintes IDEs:

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

Acerca da CLI do Gemini e das extensões

A CLI do Gemini é um agente de IA de código aberto concebido para ajudar com fluxos de trabalho de desenvolvimento, auxiliando na programação, na depuração, na exploração de dados e na criação de conteúdo. A sua missão é fornecer uma interface de agente para interagir com os serviços do Data Cloud e bases de dados de código aberto populares.

Como funcionam as extensões

A CLI Gemini é altamente extensível, o que permite a adição de novas ferramentas e capacidades através de extensões. Pode carregar as extensões a partir de um URL do GitHub, de um diretório local ou de um registo configurável. Oferecem novas ferramentas, comandos de barra e comandos para ajudar no seu fluxo de trabalho.

Use a extensão da CLI Gemini para o Firestore

A integração com a CLI do Gemini é feita através de uma extensão dedicada que oferece capacidades adicionais em comparação com a ligação padrão da caixa de ferramentas do MCP. A extensão oferece um processo de instalação simplificado e um conjunto de ferramentas. A extensão de código aberto contém informações detalhadas sobre a instalação, a configuração e exemplos de utilização. Para mais informações, consulte o artigo Extensão da CLI do Gemini – Firestore.

A extensão firestore-native inclui ferramentas para consultar a base de dados, atualizar documentos e gerir regras de segurança do Firestore.

Categoria	Ferramentas	Exemplo de comando de linguagem natural
Obtenção de documentos e dados	`get_documents`	Mostra-me os dados do Firestore para os utilizadores de teste qa_user_123 e qa_user_456 da coleção users-staging.
	`list_collections`	Apresenta todas as subcoleções na coleção users-staging.
	`query_collection`	Encontre todos os utilizadores na coleção users-staging cuja lista de desejos contenha product-glasses.
Atualizações e eliminações de documentos	`add_documents`	Adiciona o documento qa_user_789 à coleção users-staging com os campos name: tester1 e location: USA.
	`delete_documents`	Elimine o documento qa_user_789 da coleção users-staging.
	`update_document`	Atualize o documento com o ID order-987 na coleção orders para definir o estado como "Shipped" (Enviado). Para todos os 20 utilizadores de teste que acabou de encontrar, remova product-glasses(inactive) da respetiva lista de desejos.
Gestão de regras de segurança	`get_rules`	Mostra-me as regras de segurança do Firestore ativas para esta base de dados.
Gestão de regras de segurança	`validate_rules`	new_rules.txt é uma nova regra de segurança do Firestore na qual estou a trabalhar para a preparação. Pode validá-lo por mim?

Antes de começar

Para usar as ferramentas na extensão da CLI do Gemini para o Firestore, tem de ter uma das seguintes funções de gestão de identidade e acesso (IAM) ou uma função personalizada com autorizações equivalentes:

Tarefa	Nome da função	Função de gestão de identidade e de acesso (IAM) necessária
Ler e gravar dados na base de dados do Firestore	Utilizador do Cloud Datastore	`roles/datastore.user`
Veja e teste as regras de segurança	Visualizador de regras do Firebase	`roles/firebaserules.viewer`

Configure o Firestore

Crie um novo Google Cloud projeto ou selecione um existente.
Ative a API Firestore no modo nativo 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

Configure o cliente do MCP

Esta secção descreve como configurar várias ferramentas para programadores para estabelecer ligação à sua instância do Firestore através da caixa de ferramentas da MCP para bases de dados. O conjunto de ferramentas funciona como um servidor de protocolo Model Context Protocol (MCP) de código aberto que se encontra entre o seu IDE e a sua base de dados, oferecendo um plano de controlo seguro e eficiente para as suas ferramentas de IA. Selecione o separador de uma das seguintes ferramentas para ver as instruções de configuração.

CLI do Gemini

Instale a CLI do Gemini.
Instale a extensão do Firestore para a Gemini CLI a partir do repositório do GitHub com o seguinte comando:
```
gemini extensions install https://github.com/gemini-cli-extensions/firestore-native
```
Defina variáveis de ambiente para estabelecer ligação à sua base de dados do Firestore. A variável FIRESTORE_DATABASE é opcional e tem como predefinição (default):
```
export FIRESTORE_PROJECT="PROJECT_ID"
export FIRESTORE_DATABASE="DATABASE_NAME"
```
A extensão da CLI Gemini para o Firestore usa as suas Credenciais padrão da aplicação (ADC) para autenticação.
Inicie a CLI do Gemini no modo interativo:
```
gemini
```
A CLI carrega automaticamente a extensão do Firestore para a extensão da CLI do Gemini e as respetivas ferramentas, que pode usar para interagir com a sua base de dados.

Gemini Code Assist

Recomendamos que configure o Gemini Code Assist para usar a CLI do Gemini. Esta abordagem elimina a necessidade de configurar manualmente um servidor MCP.

Certifique-se de que instalou e configurou a CLI do Gemini e a extensão firestore-native.
Configure o Gemini Code Assist para usar a CLI do Gemini.
Comece a interagir com a sua base de dados do Firestore através de linguagem natural diretamente no chat do Gemini Code Assist.

Código do Claude

Instale a caixa de ferramentas do MCP para bases de dados

Transfira a versão mais recente da caixa de ferramentas 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.15.0 ou posterior da caixa de ferramentas.
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, por exemplo, v0.15.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, por exemplo, v0.15.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, por exemplo, v0.15.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, por exemplo, v0.15.0.
Torne o ficheiro binário executável.
```
chmod +x toolbox
```
Valide a instalação.
```
./toolbox --version
```

Estabeleça ligação ao servidor MCP

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. A variável FIRESTORE_DATABASE é opcional e tem como predefinição (default).

 {
    "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

Instale a caixa de ferramentas do MCP para bases de dados

Transfira a versão mais recente da caixa de ferramentas 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.15.0 ou posterior da caixa de ferramentas.
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, por exemplo, v0.15.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, por exemplo, v0.15.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, por exemplo, v0.15.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, por exemplo, v0.15.0.
Torne o ficheiro binário executável.
```
chmod +x toolbox
```
Valide a instalação.
```
./toolbox --version
```

Estabeleça ligação ao servidor MCP

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. A variável FIRESTORE_DATABASE é opcional e tem como predefinição (default).

 {
    "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

Instale a caixa de ferramentas do MCP para bases de dados

Transfira a versão mais recente da caixa de ferramentas 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.15.0 ou posterior da caixa de ferramentas.
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, por exemplo, v0.15.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, por exemplo, v0.15.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, por exemplo, v0.15.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, por exemplo, v0.15.0.
Torne o ficheiro binário executável.
```
chmod +x toolbox
```
Valide a instalação.
```
./toolbox --version
```

Estabeleça ligação ao servidor MCP

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. A variável FIRESTORE_DATABASE é opcional e tem como predefinição (default).

 {
    "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

Instale a caixa de ferramentas do MCP para bases de dados

Transfira a versão mais recente da caixa de ferramentas 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.15.0 ou posterior da caixa de ferramentas.
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, por exemplo, v0.15.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, por exemplo, v0.15.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, por exemplo, v0.15.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, por exemplo, v0.15.0.
Torne o ficheiro binário executável.
```
chmod +x toolbox
```
Valide a instalação.
```
./toolbox --version
```

Estabeleça ligação ao servidor MCP

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. A variável FIRESTORE_DATABASE é opcional e tem como predefinição (default).

 {
    "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)

Instale a caixa de ferramentas do MCP para bases de dados

Transfira a versão mais recente da caixa de ferramentas 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.15.0 ou posterior da caixa de ferramentas.
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, por exemplo, v0.15.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, por exemplo, v0.15.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, por exemplo, v0.15.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, por exemplo, v0.15.0.
Torne o ficheiro binário executável.
```
chmod +x toolbox
```
Valide a instalação.
```
./toolbox --version
```

Estabeleça ligação ao servidor MCP

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. A variável FIRESTORE_DATABASE é opcional e tem como predefinição (default).

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

Windsurf

Instale a caixa de ferramentas do MCP para bases de dados

Transfira a versão mais recente da caixa de ferramentas 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.15.0 ou posterior da caixa de ferramentas.
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, por exemplo, v0.15.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, por exemplo, v0.15.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, por exemplo, v0.15.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, por exemplo, v0.15.0.
Torne o ficheiro binário executável.
```
chmod +x toolbox
```
Valide a instalação.
```
./toolbox --version
```

Estabeleça ligação ao servidor MCP

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. A variável FIRESTORE_DATABASE é opcional e tem como predefinição (default).

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

Use o Firestore com o MCP, a CLI do Gemini e outros agentes

Acerca da CLI do Gemini e das extensões

Como funcionam as extensões

Use a extensão da CLI Gemini para o Firestore

Antes de começar

Configure o Firestore

Configure o cliente do MCP

CLI do Gemini

Gemini Code Assist

Código do Claude

Instale a caixa de ferramentas do MCP para bases de dados

linux/amd64

darwin/arm64

darwin/amd64

windows/amd64

Estabeleça ligação ao servidor MCP

Claude para computador

Instale a caixa de ferramentas do MCP para bases de dados

linux/amd64

darwin/arm64

darwin/amd64

windows/amd64

Estabeleça ligação ao servidor MCP

Cline

Instale a caixa de ferramentas do MCP para bases de dados

linux/amd64

darwin/arm64

darwin/amd64

windows/amd64

Estabeleça ligação ao servidor MCP

Cursor

Instale a caixa de ferramentas do MCP para bases de dados

linux/amd64

darwin/arm64

darwin/amd64

windows/amd64

Estabeleça ligação ao servidor MCP

Visual Studio Code (Copilot)

Instale a caixa de ferramentas do MCP para bases de dados

linux/amd64

darwin/arm64

darwin/amd64

windows/amd64

Estabeleça ligação ao servidor MCP

Windsurf

Instale a caixa de ferramentas do MCP para bases de dados

linux/amd64

darwin/arm64

darwin/amd64

windows/amd64

Estabeleça ligação ao servidor MCP