Esta página foi traduzida pela API Cloud Translation.

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

Nesta página, mostramos como conectar seu banco de dados do Firestore a várias ferramentas de desenvolvedor.

Para uma experiência integrada, recomendamos usar a extensão dedicada do Firestore para a CLI do Gemini. Como a interface de linha de comando de próxima geração do Google Cloud, a CLI do Gemini agrupa o servidor MCP subjacente diretamente na extensão, o que elimina a necessidade de uma configuração de servidor separada. É possível configurar o Gemini Code Assist para usar a CLI do Gemini, oferecendo benefícios de configuração semelhantes no seu ambiente de desenvolvimento integrado.

Para outras ferramentas de desenvolvedor que oferecem suporte ao Protocolo de contexto de modelo (MCP), é possível se conectar configurando manualmente a MCP Toolbox para bancos de dados. A MCP Toolbox é um servidor MCP de código aberto que conecta agentes de IA aos seus dados gerenciando tarefas como autenticação e agrupamento de conexões. Assim, você pode interagir com seus dados usando linguagem natural diretamente do IDE. Para essas ferramentas, esse método oferece recursos básicos de interação com o banco de dados. Nesta página, descrevemos como usar a MCP Toolbox for Databases para expor suas ferramentas de assistência ao desenvolvedor 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 do Claude

Sobre a CLI do Gemini e as extensões

A CLI do Gemini é um agente de IA de código aberto projetado para ajudar nos fluxos de trabalho de desenvolvimento, auxiliando na programação, depuração, análise de dados e criação de conteúdo. A missão dele é fornecer uma interface de agente para interagir com os serviços da Data Cloud e bancos de dados de código aberto conhecidos.

Como as extensões funcionam

A CLI do Gemini é altamente extensível, permitindo a adição de novas ferramentas e recursos por extensões. É possível carregar as extensões de um URL do GitHub, um diretório local ou um registro configurável. Eles oferecem novas ferramentas, comandos de barra e comandos para ajudar no seu fluxo de trabalho.

Usar a extensão da CLI do Gemini para o Firestore

A integração com a CLI do Gemini é feita por uma extensão dedicada que oferece mais recursos em comparação com a conexã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 instalação, configuração e exemplos de uso. Para mais informações, consulte a Extensão da CLI Gemini - Firestore.

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

Categoria	Ferramentas	Exemplo de comando de linguagem natural
Recuperação de documentos e dados	`get_documents`	Mostre os dados do Firestore para os usuários de teste qa_user_123 e qa_user_456 da coleção users-staging.
	`list_collections`	Liste todas as subcoleções em "users-staging".
	`query_collection`	Encontre todos os usuários na coleção "users-staging" cuja lista de desejos contém "product-glasses".
Atualizações e exclusões de documentos	`add_documents`	Adicione o documento qa_user_789 à coleção users-staging com os campos name: tester1 e location: USA.
	`delete_documents`	Exclua o documento qa_user_789 da coleção users-staging.
	`update_document`	Atualize o documento com o ID order-987 na coleção de pedidos para definir o status como "Enviado". Para todos os 20 usuários de teste que você acabou de encontrar, remova o produto óculos(inativo) da lista de desejos.
Gerenciamento de regras de segurança	`get_rules`	Mostre as regras de segurança ativas do Firestore para este banco de dados.
Gerenciamento de regras de segurança	`validate_rules`	new_rules.txt é uma nova regra de segurança do Firestore em que estou trabalhando para teste. Você pode validar isso para mim?

Antes de começar

Para usar as ferramentas na extensão da CLI Gemini para Firestore, você precisa ter um dos seguintes papéis do Identity and Access Management (IAM) ou um papel personalizado com permissões equivalentes:

Tarefa	Nome do papel	Papel necessário do Identity and Access Management (IAM)
Ler e gravar dados no banco de dados do Firestore	Usuário do Cloud Datastore	`roles/datastore.user`
Ver e testar regras de segurança	Leitor de regras do Firebase	`roles/firebaserules.viewer`

Configurar o Firestore

Crie um novo Google Cloud projeto ou selecione um atual.
Ative a API Firestore no modo nativo no projeto.
Crie um banco de dados do Firestore, se ainda não tiver feito isso.
Configure a autenticação para seu ambiente local.
- Instalar a CLI gcloud
- Execute gcloud auth application-default login para autenticar

Configurar o cliente MCP

Nesta seção, descrevemos como configurar várias ferramentas de desenvolvedor para se conectar à sua instância do Firestore usando a Caixa de ferramentas do MCP para bancos de dados. A caixa de ferramentas funciona como um servidor Protocolo de contexto de modelo (MCP) de código aberto que fica entre o IDE e o banco de dados, fornecendo um plano de controle seguro e eficiente para suas ferramentas de IA. Selecione a guia de uma das ferramentas a seguir para conferir as instruções de configuração.

CLI do Gemini

Instale a CLI do Gemini.
Instale a extensão do Firestore para a CLI Gemini no repositório do GitHub usando o seguinte comando:
```
gemini extensions install https://github.com/gemini-cli-extensions/firestore-native
```
Defina variáveis de ambiente para se conectar ao banco de dados do Firestore. A variável FIRESTORE_DATABASE é opcional e o padrão é (default):
```
export FIRESTORE_PROJECT="PROJECT_ID"
export FIRESTORE_DATABASE="DATABASE_NAME"
```
A extensão da CLI Gemini para o Firestore usa suas credenciais padrão do aplicativo (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 ferramentas dela, que você pode usar para interagir com seu banco de dados.

Gemini Code Assist

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

Confira se você instalou e configurou a CLI Gemini e a extensão firestore-native.
Configure o Gemini Code Assist para usar a CLI do Gemini.
Comece a interagir com seu banco de dados do Firestore usando linguagem natural diretamente no chat do Gemini Code Assist.

Código do Claude

Instalar a MCP Toolbox for Databases

Faça o download da versão mais recente da caixa de ferramentas como um binário. Selecione o binário correspondente ao seu sistema operacional e à arquitetura da CPU. Use a versão V0.15.0 ou mais recente 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 Toolbox, 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 Toolbox, 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 Toolbox, 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 Toolbox, por exemplo, v0.15.0.
Torne o binário executável.
```
chmod +x toolbox
```
Verifique a instalação.
```
./toolbox --version
```

Conectar-se ao servidor MCP

Instale o Claude Code.
Crie o arquivo .mcp.json na raiz do projeto, se ele não existir.
Adicione a seguinte configuração, substitua as variáveis de ambiente pelos seus valores e salve. A variável FIRESTORE_DATABASE é opcional e o padrã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

Instalar a MCP Toolbox for Databases

Faça o download da versão mais recente da caixa de ferramentas como um binário. Selecione o binário correspondente ao seu sistema operacional e à arquitetura da CPU. Use a versão V0.15.0 ou mais recente 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 Toolbox, 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 Toolbox, 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 Toolbox, 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 Toolbox, por exemplo, v0.15.0.
Torne o binário executável.
```
chmod +x toolbox
```
Verifique a instalação.
```
./toolbox --version
```

Conectar-se ao servidor MCP

Abra o Claude para computador e acesse Configurações.
Na guia Desenvolvedor, clique em Editar configuração para abrir o arquivo de configuração.
Adicione a seguinte configuração, substitua as variáveis de ambiente pelos seus valores e salve. A variável FIRESTORE_DATABASE é opcional e o padrã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.
Na nova tela de chat, um ícone de martelo (MCP) vai aparecer com o novo servidor MCP disponível.

Cline

Instalar a MCP Toolbox for Databases

Faça o download da versão mais recente da caixa de ferramentas como um binário. Selecione o binário correspondente ao seu sistema operacional e à arquitetura da CPU. Use a versão V0.15.0 ou mais recente 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 Toolbox, 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 Toolbox, 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 Toolbox, 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 Toolbox, por exemplo, v0.15.0.
Torne o binário executável.
```
chmod +x toolbox
```
Verifique a instalação.
```
./toolbox --version
```

Conectar-se 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 arquivo de configuração.
Adicione a seguinte configuração, substitua as variáveis de ambiente pelos seus valores e salve. A variável FIRESTORE_DATABASE é opcional e o padrão é (default).

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

Um status ativo verde aparece depois que o servidor se conecta.

Cursor

Instalar a MCP Toolbox for Databases

Faça o download da versão mais recente da caixa de ferramentas como um binário. Selecione o binário correspondente ao seu sistema operacional e à arquitetura da CPU. Use a versão V0.15.0 ou mais recente 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 Toolbox, 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 Toolbox, 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 Toolbox, 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 Toolbox, por exemplo, v0.15.0.
Torne o binário executável.
```
chmod +x toolbox
```
Verifique a instalação.
```
./toolbox --version
```

Conectar-se ao servidor MCP

Crie o diretório .cursor na raiz do projeto, se ele não existir.
Crie o arquivo .cursor/mcp.json, se ele não existir, e abra-o.
Adicione a seguinte configuração, substitua as variáveis de ambiente pelos seus valores e salve. A variável FIRESTORE_DATABASE é opcional e o padrão é (default).

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

Abra Cursor e navegue até Configurações > Configurações do cursor > MCP. Um status verde ativo aparece quando o servidor se conecta.

Visual Studio Code (Copilot)

Instalar a MCP Toolbox for Databases

Faça o download da versão mais recente da caixa de ferramentas como um binário. Selecione o binário correspondente ao seu sistema operacional e à arquitetura da CPU. Use a versão V0.15.0 ou mais recente 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 Toolbox, 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 Toolbox, 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 Toolbox, 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 Toolbox, por exemplo, v0.15.0.
Torne o binário executável.
```
chmod +x toolbox
```
Verifique a instalação.
```
./toolbox --version
```

Conectar-se ao servidor MCP

Abra o VS Code e crie o diretório .vscode na raiz do projeto, se ele não existir.
Crie o arquivo .vscode/mcp.json, se ele não existir, e abra-o.
Adicione a seguinte configuração, substitua as variáveis de ambiente pelos seus valores e salve. A variável FIRESTORE_DATABASE é opcional e o padrão é (default).

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

Windsurf

Instalar a MCP Toolbox for Databases

Faça o download da versão mais recente da caixa de ferramentas como um binário. Selecione o binário correspondente ao seu sistema operacional e à arquitetura da CPU. Use a versão V0.15.0 ou mais recente 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 Toolbox, 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 Toolbox, 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 Toolbox, 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 Toolbox, por exemplo, v0.15.0.
Torne o binário executável.
```
chmod +x toolbox
```
Verifique a instalação.
```
./toolbox --version
```

Conectar-se ao servidor MCP

Abra o Windsurf e navegue até o assistente do Cascade.
Clique no ícone do MCP e em Configurar para abrir o arquivo de configuração.
Adicione a seguinte configuração, substitua as variáveis de ambiente pelos seus valores e salve. A variável FIRESTORE_DATABASE é opcional e o padrão é (default).

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

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

Sobre a CLI do Gemini e as extensões

Como as extensões funcionam

Usar a extensão da CLI do Gemini para o Firestore

Antes de começar

Configurar o Firestore

Configurar o cliente MCP

CLI do Gemini

Gemini Code Assist

Código do Claude

Instalar a MCP Toolbox for Databases

linux/amd64

darwin/arm64

darwin/amd64

windows/amd64

Conectar-se ao servidor MCP

Claude para computador

Instalar a MCP Toolbox for Databases

linux/amd64

darwin/arm64

darwin/amd64

windows/amd64

Conectar-se ao servidor MCP

Cline

Instalar a MCP Toolbox for Databases

linux/amd64

darwin/arm64

darwin/amd64

windows/amd64

Conectar-se ao servidor MCP

Cursor

Instalar a MCP Toolbox for Databases

linux/amd64

darwin/arm64

darwin/amd64

windows/amd64

Conectar-se ao servidor MCP

Visual Studio Code (Copilot)

Instalar a MCP Toolbox for Databases

linux/amd64

darwin/arm64

darwin/amd64

windows/amd64

Conectar-se ao servidor MCP

Windsurf

Instalar a MCP Toolbox for Databases

linux/amd64

darwin/arm64

darwin/amd64

windows/amd64

Conectar-se ao servidor MCP