Esta página se ha traducido con Cloud Translation API.

Usar Firestore con MCP, Gemini CLI y otros agentes

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

Para disfrutar de una experiencia integrada, te recomendamos que uses la extensión de Firestore específica para la CLI de Gemini. Como interfaz de línea de comandos de nueva generación de Google Cloud, Gemini CLI 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, que ofrece ventajas de configuración similares en tu IDE.

Para otras herramientas para desarrolladores que admitan el Model Context Protocol (MCP), puedes conectarte configurando manualmente MCP Toolbox for Databases. MCP Toolbox es un servidor MCP de código abierto que conecta agentes de IA a tus datos gestionando tareas como la autenticación y la agrupación de conexiones. De esta forma, puedes interactuar con tus datos usando lenguaje natural directamente desde tu IDE. En el caso de estas herramientas, este método proporciona funciones básicas de interacción con la base de datos. En esta página se describe cómo usar MCP Toolbox for Databases para exponer tus herramientas de asistencia para desarrolladores a una instancia de Firestore con los siguientes IDEs:

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

Acerca de Gemini CLI y las extensiones

Gemini CLI es un agente de IA de código abierto diseñado para ayudar con los flujos de trabajo de desarrollo, como la programació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 más populares.

Cómo funcionan las extensiones

La CLI de Gemini es muy extensible, lo que permite añadir nuevas herramientas y funciones mediante extensiones. Puedes cargar las extensiones desde una URL de GitHub, un directorio local o un registro configurable. Proporcionan nuevas herramientas, comandos de barra y peticiones para ayudarte con tu flujo de trabajo.

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

La integración con la CLI de Gemini se realiza a través de una extensión específica que ofrece funciones 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 sección sobre 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 gestionar las reglas de seguridad de Firestore.

Categoría	Herramientas	Ejemplo de petición en lenguaje natural
Recuperación de documentos y datos	`get_documents`	Muéstrame los datos de Firestore de los usuarios de prueba qa_user_123 y qa_user_456 de la colección users-staging.
	`list_collections`	Lista todas las subcolecciones de la colección users-staging.
	`query_collection`	Busca todos los usuarios de la colección users-staging cuya lista de deseos contenga el producto glasses.
Actualizaciones y eliminaciones de documentos	`add_documents`	Añade el documento qa_user_789 a la colección users-staging con los campos name: tester1 y location: USA.
	`delete_documents`	Elimina el documento qa_user_789 de la colección users-staging.
	`update_document`	Actualiza el documento con el ID order-987 de la colección orders para definir el estado como "Shipped". En el caso de los 20 usuarios de prueba que acabas de encontrar, elimina el producto "gafas" (inactivo) de su lista de deseos.
Gestión de reglas de seguridad	`get_rules`	Muéstrame las reglas de seguridad de Firestore activas de esta base de datos.
Gestió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 fase de pruebas. ¿Puedes validarlo por mí?

Antes de empezar

Para usar las herramientas de la extensión de la CLI de Gemini para Firestore, debes tener uno de los siguientes roles de gestión de identidades y accesos (IAM) o un rol personalizado con permisos equivalentes:

Tarea	Nombre de rol	Rol de gestión de identidades y accesos (IAM) necesario
Leer y escribir datos en una base de datos de Firestore	Usuario de Cloud Datastore	`roles/datastore.user`
Ver y probar reglas de seguridad	Lector de reglas de Firebase	`roles/firebaserules.viewer`

Configurar Firestore

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

Configurar el cliente de MCP

En esta sección se describe cómo configurar varias herramientas para desarrolladores para conectarse a tu instancia de Firestore mediante el MCP Toolbox for Databases (Caja de herramientas de MCP para bases de datos). Esta caja de herramientas actúa como un servidor Model Context Protocol (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.

Gemini CLI

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
```
Define variables de entorno para conectarte a tu base de datos de Firestore. La variable FIRESTORE_DATABASE es opcional y su valor predeterminado es (default):
```
export FIRESTORE_PROJECT="PROJECT_ID"
export FIRESTORE_DATABASE="DATABASE_NAME"
```
La extensión de Gemini CLI para Firestore usa las credenciales predeterminadas de tu aplicación (ADC) para la autenticación.
Inicia la CLI de Gemini 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 usar la CLI de Gemini, ya que así no tendrás que configurar manualmente un servidor MCP.

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

Código de Claude

Instalar MCP Toolbox for Databases

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

Conectarse al servidor MCP

Instala Claude Code.
Crea el archivo .mcp.json en la raíz de tu proyecto, si no existe.
Añade la siguiente configuración, sustituye las variables de entorno por tus valores y guarda los cambios. La variable FIRESTORE_DATABASE es opcional y su valor predeterminado es (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 ordenadores

Instalar MCP Toolbox for Databases

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

Conectarse al servidor MCP

Abre Claude Desktop y ve a Configuración.
En la pestaña Desarrollador, haz clic en Editar configuración para abrir el archivo de configuración.
Añade la siguiente configuración, sustituye las variables de entorno por tus valores y guarda los cambios. La variable FIRESTORE_DATABASE es opcional y su valor predeterminado es (default).

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

Reinicia Claude Desktop.
En la pantalla de nuevo chat, debería aparecer un icono de martillo (MCP) con el nuevo servidor MCP disponible.

Cline

Instalar MCP Toolbox for Databases

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

Conectarse al servidor MCP

Abre la extensión Cline en VS Code y toca el icono Servidores MCP.
Haz clic en Configurar servidores MCP para abrir el archivo de configuración.
Añade la siguiente configuración, sustituye las variables de entorno por tus valores y guarda los cambios. La variable FIRESTORE_DATABASE es opcional y su valor predeterminado es (default).

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

Si el servidor se conecta correctamente, aparecerá el estado activo en verde.

Cursor

Instalar MCP Toolbox for Databases

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

Conectarse al servidor MCP

Crea el directorio .cursor en la raíz de tu proyecto si no existe.
Crea el archivo .cursor/mcp.json si no existe y ábrelo.
Añade la siguiente configuración, sustituye las variables de entorno por tus valores y guarda los cambios. La variable FIRESTORE_DATABASE es opcional y su valor predeterminado es (default).

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

Abre Cursor y ve a Configuración > Configuración del cursor > MCP. Cuando el servidor se conecta, aparece el estado activo en verde.

Visual Studio Code (Copilot)

Instalar MCP Toolbox for Databases

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

Conectarse al servidor 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.
Añade la siguiente configuración, sustituye las variables de entorno por tus valores y guarda los cambios. La variable FIRESTORE_DATABASE es opcional y su valor predeterminado es (default).

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

Windsurf

Instalar MCP Toolbox for Databases

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

Conectarse al servidor MCP

Abre Windsurf y ve al asistente de Cascade.
Haz clic en el icono de MCP y, a continuación, en Configurar para abrir el archivo de configuración.
Añade la siguiente configuración, sustituye las variables de entorno por tus valores y guarda los cambios. La variable FIRESTORE_DATABASE es opcional y su valor predeterminado es (default).

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

Usar Firestore con MCP, Gemini CLI y otros agentes

Acerca de Gemini CLI y las extensiones

Cómo funcionan las extensiones

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

Antes de empezar

Configurar Firestore

Configurar el cliente de MCP

Gemini CLI

Gemini Code Assist

Código de Claude

Instalar MCP Toolbox for Databases

linux/amd64

darwin/arm64

darwin/amd64

windows/amd64

Conectarse al servidor MCP

Claude para ordenadores

Instalar MCP Toolbox for Databases

linux/amd64

darwin/arm64

darwin/amd64

windows/amd64

Conectarse al servidor MCP

Cline

Instalar MCP Toolbox for Databases

linux/amd64

darwin/arm64

darwin/amd64

windows/amd64

Conectarse al servidor MCP

Cursor

Instalar MCP Toolbox for Databases

linux/amd64

darwin/arm64

darwin/amd64

windows/amd64

Conectarse al servidor MCP

Visual Studio Code (Copilot)

Instalar MCP Toolbox for Databases

linux/amd64

darwin/arm64

darwin/amd64

windows/amd64

Conectarse al servidor MCP

Windsurf

Instalar MCP Toolbox for Databases

linux/amd64

darwin/arm64

darwin/amd64

windows/amd64

Conectarse al servidor MCP