Se usó la API de Cloud Translation para traducir esta página.

Usa Firestore con MCP, Gemini CLI y otros agentes

En esta página, se muestra cómo conectar tu base de datos de Firestore a varias herramientas para desarrolladores.

Para una experiencia integrada, te recomendamos que uses la extensión de Firestore dedicada para la CLI de Gemini. Como interfaz de línea de comandos de próxima generación de Google Cloud, la CLI de Gemini incluye el servidor de MCP subyacente directamente en la extensión, lo que elimina la necesidad de configurar un servidor independiente. Puedes configurar Gemini Code Assist para que use la CLI de Gemini, lo que ofrece beneficios de configuración similares en tu IDE.

En el caso de otras herramientas para desarrolladores que admiten el Protocolo de contexto del modelo (MCP), puedes conectarte configurando manualmente la MCP Toolbox for Databases. MCP Toolbox es un servidor de MCP de código abierto que conecta agentes de IA a tus datos mediante la administración de tareas como la autenticación y la agrupación de conexiones. Esto te permite interactuar con tus datos usando lenguaje natural directamente desde tu IDE. Para estas herramientas, este método proporciona capacidades básicas de interacción con la base de datos. En esta página, se describe cómo usar el MCP Toolbox for Databases para exponer tus herramientas de asistencia para desarrolladores a una instancia de Firestore con los siguientes IDE:

CLI de Gemini
Gemini Code Assist
Cursor
Windsurf (Codium)
Visual Studio Code (Copilot)
Cline (extensión de VS Code)
Claude para computadoras
Claude code

Acerca de la CLI de Gemini y las extensiones

La CLI de Gemini es un agente de IA de código abierto diseñado para ayudar con los flujos de trabajo de desarrollo, ya que asiste con la codificación, la depuración, la exploración de datos y la creación de contenido. Su misión es proporcionar una interfaz de agente para interactuar con los servicios de Data Cloud y las bases de datos de código abierto populares.

Cómo funcionan las extensiones

La CLI de Gemini es altamente extensible, lo que permite agregar nuevas herramientas y capacidades a través de extensiones. Puedes cargar las extensiones desde una URL de GitHub, un directorio local o un registro configurable. Proporcionan nuevas herramientas, comandos de barra y mensajes para ayudarte con tu flujo de trabajo.

Usa la extensión de la CLI de Gemini para Firestore

La integración con Gemini CLI se realiza a través de una extensión dedicada que ofrece capacidades adicionales en comparación con la conexión estándar de MCP Toolbox. La extensión ofrece un proceso de instalación optimizado y un conjunto de herramientas. La extensión de código abierto contiene información detallada sobre la instalación, la configuración y ejemplos de uso. Para obtener más información, consulta la extensión de la CLI de Gemini para Firestore.

La extensión firestore-native incluye herramientas para consultar la base de datos, actualizar documentos y administrar las reglas de seguridad de Firestore.

Categoría	Herramientas	Ejemplo de instrucción en lenguaje natural
Recuperación de datos y documentos	`get_documents`	Muéstrame los datos de Firestore para los usuarios de prueba qa_user_123 y qa_user_456 de la colección users-staging.
	`list_collections`	Enumera todas las subcolecciones de la colección users-staging.
	`query_collection`	Encuentra todos los usuarios de la colección users-staging cuya lista de deseos contenga product-glasses.
Actualizaciones y eliminaciones de documentos	`add_documents`	Agrega el documento qa_user_789 a la colección users-staging con los campos name: tester1 y location: USA.
	`delete_documents`	Borra el documento qa_user_789 de la colección users-staging.
	`update_document`	Actualiza el documento con el ID order-987 en la colección orders para establecer el estado como "Enviado". Para los 20 usuarios de prueba que acabas de encontrar, quita product-glasses(inactive) de su lista de deseos.
Administración de reglas de seguridad	`get_rules`	Muéstrame las reglas de seguridad de Firestore activas para esta base de datos.
Administración de reglas de seguridad	`validate_rules`	new_rules.txt es una nueva regla de seguridad de Firestore en la que estoy trabajando para la etapa de pruebas. ¿Puedes validarlo por mí?

Antes de comenzar

Para usar las herramientas de la extensión de Gemini CLI para Firestore, debes tener uno de los siguientes roles de Identity and Access Management (IAM) o un rol personalizado con permisos equivalentes:

Tarea	Nombre del rol	Rol de Identity and Access Management (IAM) requerido
Leer y escribir datos en la base de datos de Firestore	Usuario de Cloud Datastore	`roles/datastore.user`
Cómo ver y probar reglas de seguridad	Visualizador de reglas de Firebase	`roles/firebaserules.viewer`

Configura Firestore

Crea un Google Cloud proyecto nuevo o selecciona uno existente.
Habilita la API de Firestore en modo nativo para tu proyecto.
Crea una base de datos de Firestore si aún no lo hiciste.
Configura la autenticación para tu entorno local.
- Instala gcloud CLI
- Ejecuta gcloud auth application-default login para autenticarte

Configura el cliente de MCP

En esta sección, se describe cómo configurar varias herramientas para desarrolladores para conectarse a tu instancia de Firestore con la caja de herramientas de MCP para bases de datos. La caja de herramientas actúa como un servidor de Protocolo de contexto del modelo (MCP) de código abierto que se encuentra entre tu IDE y tu base de datos, y proporciona un plano de control seguro y eficiente para tus herramientas de IA. Selecciona la pestaña de una de las siguientes herramientas para ver las instrucciones de configuración.

CLI de Gemini

Instala la CLI de Gemini.
Instala la extensión de Firestore para la CLI de Gemini desde el repositorio de GitHub con el siguiente comando:
```
gemini extensions install https://github.com/gemini-cli-extensions/firestore-native
```
Configura variables de entorno para conectarte a tu base de datos de Firestore. La variable FIRESTORE_DATABASE es opcional y se establece de forma predeterminada en (default):
```
export FIRESTORE_PROJECT="PROJECT_ID"
export FIRESTORE_DATABASE="DATABASE_NAME"
```
La extensión de la CLI de Gemini para Firestore usa tus credenciales predeterminadas de la aplicación (ADC) para la autenticación.
Inicia Gemini CLI en modo interactivo:
```
gemini
```
La CLI carga automáticamente la extensión de Firestore para la extensión de Gemini CLI y sus herramientas, que puedes usar para interactuar con tu base de datos.

Gemini Code Assist

Te recomendamos que configures Gemini Code Assist para que use la CLI de Gemini. Este enfoque elimina la necesidad de configurar manualmente un servidor de MCP.

Asegúrate de haber instalado y configurado la CLI de Gemini y la extensión de firestore-native.
Configura Gemini Code Assist para usar la CLI de Gemini.
Comienza a interactuar con tu base de datos de Firestore en lenguaje natural directamente en el chat de Gemini Code Assist.

Claude Code

Instala MCP Toolbox for Databases

Descarga la versión más reciente de Toolbox como un archivo binario. Selecciona el objeto binario correspondiente a tu sistema operativo (SO) y a la arquitectura de CPU. Debes usar la versión V0.15.0 o una posterior de Toolbox.
linux/amd64
curl -O https://storage.googleapis.com/genai-toolbox/version/linux/amd64/toolbox
Reemplaza version por el número de versión de Toolbox, por ejemplo, v0.15.0.
darwin/arm64
curl -O https://storage.googleapis.com/genai-toolbox/version/darwin/arm64/toolbox
Reemplaza version por el número de versión de Toolbox, por ejemplo, v0.15.0.
darwin/amd64
curl -O https://storage.googleapis.com/genai-toolbox/version/darwin/amd64/toolbox
Reemplaza version por el número de versión de Toolbox, por ejemplo, v0.15.0.
windows/amd64
curl -O https://storage.googleapis.com/genai-toolbox/version/windows/amd64/toolbox
Reemplaza version por el número de versión de Toolbox, por ejemplo, v0.15.0.
Haz que el objeto binario sea ejecutable.
```
chmod +x toolbox
```
Verifica la instalación:.
```
./toolbox --version
```

Conéctate al servidor de MCP

Instala Claude Code.
Crea el archivo .mcp.json en la raíz de tu proyecto si no existe.
Agrega la siguiente configuración, reemplaza las variables de entorno por tus valores y guarda. La variable FIRESTORE_DATABASE es opcional y se establece de forma predeterminada en (default).

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

Reinicia el código de Claude para aplicar la nueva configuración.

Claude para computadoras de escritorio

Instala MCP Toolbox for Databases

Descarga la versión más reciente de Toolbox como un archivo binario. Selecciona el objeto binario correspondiente a tu sistema operativo (SO) y a la arquitectura de CPU. Debes usar la versión V0.15.0 o una posterior de Toolbox.
linux/amd64
curl -O https://storage.googleapis.com/genai-toolbox/version/linux/amd64/toolbox
Reemplaza version por el número de versión de Toolbox, por ejemplo, v0.15.0.
darwin/arm64
curl -O https://storage.googleapis.com/genai-toolbox/version/darwin/arm64/toolbox
Reemplaza version por el número de versión de Toolbox, por ejemplo, v0.15.0.
darwin/amd64
curl -O https://storage.googleapis.com/genai-toolbox/version/darwin/amd64/toolbox
Reemplaza version por el número de versión de Toolbox, por ejemplo, v0.15.0.
windows/amd64
curl -O https://storage.googleapis.com/genai-toolbox/version/windows/amd64/toolbox
Reemplaza version por el número de versión de Toolbox, por ejemplo, v0.15.0.
Haz que el objeto binario sea ejecutable.
```
chmod +x toolbox
```
Verifica la instalación:.
```
./toolbox --version
```

Conéctate al servidor de MCP

Abre Claude Desktop y navega a Configuración.
En la pestaña Desarrollador, haz clic en Editar configuración para abrir el archivo de configuración.
Agrega la siguiente configuración, reemplaza las variables de entorno por tus valores y guarda. La variable FIRESTORE_DATABASE es opcional y se establece de forma predeterminada en (default).

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

Reinicia Claude para computadoras de escritorio.
En la nueva pantalla de chat, deberías ver un ícono de martillo (MCP) con el nuevo servidor de MCP disponible.

Cline

Instala MCP Toolbox for Databases

Descarga la versión más reciente de Toolbox como un archivo binario. Selecciona el objeto binario correspondiente a tu sistema operativo (SO) y a la arquitectura de CPU. Debes usar la versión V0.15.0 o una posterior de Toolbox.
linux/amd64
curl -O https://storage.googleapis.com/genai-toolbox/version/linux/amd64/toolbox
Reemplaza version por el número de versión de Toolbox, por ejemplo, v0.15.0.
darwin/arm64
curl -O https://storage.googleapis.com/genai-toolbox/version/darwin/arm64/toolbox
Reemplaza version por el número de versión de Toolbox, por ejemplo, v0.15.0.
darwin/amd64
curl -O https://storage.googleapis.com/genai-toolbox/version/darwin/amd64/toolbox
Reemplaza version por el número de versión de Toolbox, por ejemplo, v0.15.0.
windows/amd64
curl -O https://storage.googleapis.com/genai-toolbox/version/windows/amd64/toolbox
Reemplaza version por el número de versión de Toolbox, por ejemplo, v0.15.0.
Haz que el objeto binario sea ejecutable.
```
chmod +x toolbox
```
Verifica la instalación:.
```
./toolbox --version
```

Conéctate al servidor de MCP

Abre la extensión Cline en VS Code y presiona el ícono de Servidores de MCP.
Haz clic en Configure MCP Servers para abrir el archivo de configuración.
Agrega la siguiente configuración, reemplaza las variables de entorno por tus valores y guarda. La variable FIRESTORE_DATABASE es opcional y se establece de forma predeterminada en (default).

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

Aparece un estado activo verde después de que el servidor se conecta correctamente.

Cursor

Instala MCP Toolbox for Databases

Descarga la versión más reciente de Toolbox como un archivo binario. Selecciona el objeto binario correspondiente a tu sistema operativo (SO) y a la arquitectura de CPU. Debes usar la versión V0.15.0 o una posterior de Toolbox.
linux/amd64
curl -O https://storage.googleapis.com/genai-toolbox/version/linux/amd64/toolbox
Reemplaza version por el número de versión de Toolbox, por ejemplo, v0.15.0.
darwin/arm64
curl -O https://storage.googleapis.com/genai-toolbox/version/darwin/arm64/toolbox
Reemplaza version por el número de versión de Toolbox, por ejemplo, v0.15.0.
darwin/amd64
curl -O https://storage.googleapis.com/genai-toolbox/version/darwin/amd64/toolbox
Reemplaza version por el número de versión de Toolbox, por ejemplo, v0.15.0.
windows/amd64
curl -O https://storage.googleapis.com/genai-toolbox/version/windows/amd64/toolbox
Reemplaza version por el número de versión de Toolbox, por ejemplo, v0.15.0.
Haz que el objeto binario sea ejecutable.
```
chmod +x toolbox
```
Verifica la instalación:.
```
./toolbox --version
```

Conéctate al servidor de MCP

Crea el directorio .cursor en la raíz del proyecto si no existe.
Crea el archivo .cursor/mcp.json si no existe y ábrelo.
Agrega la siguiente configuración, reemplaza las variables de entorno por tus valores y guarda. La variable FIRESTORE_DATABASE es opcional y se establece de forma predeterminada en (default).

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

Abre Cursor y navega a Configuración > Configuración del cursor > MCP. Cuando el servidor se conecta, aparece un estado activo de color verde.

Visual Studio Code (Copilot)

Instala MCP Toolbox for Databases

Descarga la versión más reciente de Toolbox como un archivo binario. Selecciona el objeto binario correspondiente a tu sistema operativo (SO) y a la arquitectura de CPU. Debes usar la versión V0.15.0 o una posterior de Toolbox.
linux/amd64
curl -O https://storage.googleapis.com/genai-toolbox/version/linux/amd64/toolbox
Reemplaza version por el número de versión de Toolbox, por ejemplo, v0.15.0.
darwin/arm64
curl -O https://storage.googleapis.com/genai-toolbox/version/darwin/arm64/toolbox
Reemplaza version por el número de versión de Toolbox, por ejemplo, v0.15.0.
darwin/amd64
curl -O https://storage.googleapis.com/genai-toolbox/version/darwin/amd64/toolbox
Reemplaza version por el número de versión de Toolbox, por ejemplo, v0.15.0.
windows/amd64
curl -O https://storage.googleapis.com/genai-toolbox/version/windows/amd64/toolbox
Reemplaza version por el número de versión de Toolbox, por ejemplo, v0.15.0.
Haz que el objeto binario sea ejecutable.
```
chmod +x toolbox
```
Verifica la instalación:.
```
./toolbox --version
```

Conéctate al servidor de MCP

Abre VS Code y crea el directorio .vscode en la raíz de tu proyecto si no existe.
Crea el archivo .vscode/mcp.json si no existe y ábrelo.
Agrega la siguiente configuración, reemplaza las variables de entorno por tus valores y guarda. La variable FIRESTORE_DATABASE es opcional y se establece de forma predeterminada en (default).

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

Windsurf

Instala MCP Toolbox for Databases

Descarga la versión más reciente de Toolbox como un archivo binario. Selecciona el objeto binario correspondiente a tu sistema operativo (SO) y a la arquitectura de CPU. Debes usar la versión V0.15.0 o una posterior de Toolbox.
linux/amd64
curl -O https://storage.googleapis.com/genai-toolbox/version/linux/amd64/toolbox
Reemplaza version por el número de versión de Toolbox, por ejemplo, v0.15.0.
darwin/arm64
curl -O https://storage.googleapis.com/genai-toolbox/version/darwin/arm64/toolbox
Reemplaza version por el número de versión de Toolbox, por ejemplo, v0.15.0.
darwin/amd64
curl -O https://storage.googleapis.com/genai-toolbox/version/darwin/amd64/toolbox
Reemplaza version por el número de versión de Toolbox, por ejemplo, v0.15.0.
windows/amd64
curl -O https://storage.googleapis.com/genai-toolbox/version/windows/amd64/toolbox
Reemplaza version por el número de versión de Toolbox, por ejemplo, v0.15.0.
Haz que el objeto binario sea ejecutable.
```
chmod +x toolbox
```
Verifica la instalación:.
```
./toolbox --version
```

Conéctate al servidor de MCP

Abre Windsurf y navega al asistente de Cascade.
Haz clic en el ícono de MCP y, luego, en Configurar para abrir el archivo de configuración.
Agrega la siguiente configuración, reemplaza las variables de entorno por tus valores y guarda. La variable FIRESTORE_DATABASE es opcional y se establece de forma predeterminada en (default).

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

Usa Firestore con MCP, Gemini CLI y otros agentes

Acerca de la CLI de Gemini y las extensiones

Cómo funcionan las extensiones

Usa la extensión de la CLI de Gemini para Firestore

Antes de comenzar

Configura Firestore

Configura el cliente de MCP

CLI de Gemini

Gemini Code Assist

Claude Code

Instala MCP Toolbox for Databases

linux/amd64

darwin/arm64

darwin/amd64

windows/amd64

Conéctate al servidor de MCP

Claude para computadoras de escritorio

Instala MCP Toolbox for Databases

linux/amd64

darwin/arm64

darwin/amd64

windows/amd64

Conéctate al servidor de MCP

Cline

Instala MCP Toolbox for Databases

linux/amd64

darwin/arm64

darwin/amd64

windows/amd64

Conéctate al servidor de MCP

Cursor

Instala MCP Toolbox for Databases

linux/amd64

darwin/arm64

darwin/amd64

windows/amd64

Conéctate al servidor de MCP

Visual Studio Code (Copilot)

Instala MCP Toolbox for Databases

linux/amd64

darwin/arm64

darwin/amd64

windows/amd64

Conéctate al servidor de MCP

Windsurf

Instala MCP Toolbox for Databases

linux/amd64

darwin/arm64

darwin/amd64

windows/amd64

Conéctate al servidor de MCP