Conectar seu ambiente de desenvolvimento integrado ao Firestore usando a caixa de ferramentas do MCP

Nesta página, descrevemos como usar a MCP Toolbox para bancos de dados e conectar sua instância do Firestore a ambientes de desenvolvimento integrado (IDEs) e ferramentas para desenvolvedores que oferecem suporte ao Protocolo de contexto de modelo (MCP). Use essas ferramentas para executar consultas e interagir com seu banco de dados. Este guia é destinado a desenvolvedores que usam os IDEs e as ferramentas de desenvolvimento atuais para trabalhar com o Firestore.

O Protocolo de Contexto de Modelo (MCP) é um protocolo aberto para conectar modelos de linguagem grandes (LLMs) a fontes de dados como o Firestore. Nesta página, descrevemos como usar a caixa de ferramentas do MCP para bancos de dados e expor suas ferramentas de assistência ao desenvolvedor a uma instância do Firestore usando os seguintes IDEs:

Configurar o Firestore

  1. Crie um novo Google Cloud projeto ou selecione um atual.

  2. Ative a API Firestore no projeto.

  3. Crie um banco de dados do Firestore, se ainda não tiver feito isso.

  4. Configure a autenticação para seu ambiente local.

Instalar a caixa de ferramentas do MCP

  1. Faça o download da versão mais recente da MCP Toolbox como um binário. Selecione o binário correspondente ao seu sistema operacional e à arquitetura da CPU. Use a versão V0.13.0 ou mais recente 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.

  2. Torne o binário executável.

    chmod +x toolbox

  3. Verifique a instalação.

    ./toolbox --version

Configurar o cliente MCP

Código do Claude

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

 {
    "mcpServers": {
      "firestore": {
        "command": "./PATH/TO/toolbox",
        "args": ["--prebuilt","firestore","--stdio"],
        "env": {
          "FIRESTORE_PROJECT": "PROJECT_ID",
          "FIRESTORE_DATABASE": "DATABASE_NAME"
        }
      }
    }
  }
  1. Reinicie o código do Claude para aplicar a nova configuração.

Claude para computador

  1. Abra o Claude para computador e acesse Configurações.
  2. Na guia Desenvolvedor, clique em Editar configuração para abrir o arquivo de configuração.
  3. Adicione a seguinte configuração, substitua as variáveis de ambiente pelos seus valores e salve.

 {
    "mcpServers": {
      "firestore": {
        "command": "./PATH/TO/toolbox",
        "args": ["--prebuilt","firestore","--stdio"],
        "env": {
          "FIRESTORE_PROJECT": "PROJECT_ID",
          "FIRESTORE_DATABASE": "DATABASE_NAME"
        }
      }
    }
  }
  1. Reinicie o Claude Desktop.
  2. Na nova tela de chat, um ícone de martelo (MCP) vai aparecer com o novo servidor MCP disponível.

Cline

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

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

  1. Crie o diretório .cursor na raiz do projeto, se ele não existir.
  2. Crie o arquivo .cursor/mcp.json, se ele não existir, e abra-o.
  3. Adicione a seguinte configuração, substitua as variáveis de ambiente pelos seus valores e salve.
 {
    "mcpServers": {
      "firestore": {
        "command": "./PATH/TO/toolbox",
        "args": ["--prebuilt","firestore","--stdio"],
        "env": {
          "FIRESTORE_PROJECT": "PROJECT_ID",
          "FIRESTORE_DATABASE": "DATABASE_NAME"
        }
      }
    }
  }
  1. 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)

  1. Abra o VS Code e crie o diretório .vscode na raiz do projeto, se ele não existir.
  2. Crie o arquivo .vscode/mcp.json, se ele não existir, e abra-o.
  3. Adicione a seguinte configuração, substitua as variáveis de ambiente pelos seus valores e salve.
 {
    "servers":{
      "firestore": {
        "command": "./PATH/TO/toolbox",
        "args": ["--prebuilt","firestore","--stdio"],
        "env": {
          "FIRESTORE_PROJECT": "PROJECT_ID",
          "FIRESTORE_DATABASE": "DATABASE_NAME"
        }
      }
    }
  }

Windsurf

  1. Abra o Windsurf e navegue até o assistente do Cascade.
  2. Clique no ícone do MCP e em Configurar para abrir o arquivo de configuração.
  3. Adicione a seguinte configuração, substitua as variáveis de ambiente pelos seus valores e salve.
 {
    "mcpServers": {
      "firestore": {
        "command": "./PATH/TO/toolbox",
        "args": ["--prebuilt","firestore","--stdio"],
        "env": {
          "FIRESTORE_PROJECT": "PROJECT_ID",
          "FIRESTORE_DATABASE": "DATABASE_NAME"
        }
      }
    }
  }

CLI do Gemini

  1. Instale a CLI do Gemini.
  2. No diretório de trabalho, crie uma pasta chamada .gemini. Nele, crie um arquivo settings.json.
  3. Adicione a configuração a seguir, substitua as variáveis de ambiente pelos seus valores e salve.
 {
    "mcpServers": {
      "firestore": {
        "command": "./PATH/TO/toolbox",
        "args": ["--prebuilt","firestore","--stdio"],
        "env": {
          "FIRESTORE_PROJECT": "PROJECT_ID",
          "FIRESTORE_DATABASE": "DATABASE_NAME"
        }
      }
    }
  }

Gemini Code Assist

  1. Instale a extensão Gemini Code Assist no Visual Studio Code.
  2. Ative o Modo Agente no chat do Gemini Code Assist.
  3. No diretório de trabalho, crie uma pasta chamada .gemini. Nele, crie um arquivo settings.json.
  4. Adicione a configuração a seguir, substitua as variáveis de ambiente pelos seus valores e salve.
 {
    "mcpServers": {
      "firestore": {
        "command": "./PATH/TO/toolbox",
        "args": ["--prebuilt","firestore","--stdio"],
        "env": {
          "FIRESTORE_PROJECT": "PROJECT_ID",
          "FIRESTORE_DATABASE": "DATABASE_NAME"
        }
      }
    }
  }

Usar as ferramentas

Sua ferramenta de IA agora está conectada ao Firestore usando o MCP. Peça ao assistente de IA para listar coleções, receber documentos, consultar coleções ou gerenciar regras de segurança.

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

  • firestore-add-documents: adiciona um documento a um caminho de coleção do Firestore.
  • firestore-get-documents: recebe vários documentos do Firestore pelos caminhos deles.
  • firestore-list-collections: lista as coleções do Firestore para um determinado caminho principal.
  • firestore-delete-documents: exclui vários documentos do Firestore.
  • firestore-query-collection: consulta documentos de uma coleção com opções de filtragem, ordenação e limite.
  • firestore-get-rules: recupera as regras de segurança ativas do Firestore para o projeto atual.
  • firestore-update-document: atualiza um documento existente no Firestore pelo caminho dele.
  • firestore-validate-rules: valida a sintaxe e os erros das regras de segurança do Firestore.