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

Conectar tu IDE a Firestore con MCP Toolbox

En esta página se describe cómo usar MCP Toolbox para bases de datos para conectar tu instancia de Firestore a entornos de desarrollo integrados (IDE) y herramientas para desarrolladores que admitan Model Context Protocol (MCP). Usa estas herramientas para ejecutar consultas e interactuar con tu base de datos. Esta guía está dirigida a los desarrolladores que usan sus IDEs y herramientas de desarrollo para trabajar con Firestore.

Model Context Protocol (MCP) es un protocolo abierto para conectar modelos de lenguaje extensos (LLMs) a fuentes de datos como Firestore. 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 mediante los siguientes IDEs:

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

Configurar Firestore

Crea un proyecto Google Cloud o selecciona uno que ya tengas.
Habilita la API de Firestore 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

Instalar MCP Toolbox

Descarga la última versión de MCP 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.13.0 o una posterior de MCP Toolbox.
linux/amd64
curl -O https://storage.googleapis.com/genai-toolbox/version/linux/amd64/toolbox
Sustituye version por el número de versión de la caja de herramientas de MCP (por ejemplo, v0.13.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 la caja de herramientas de MCP (por ejemplo, v0.13.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 la caja de herramientas de MCP (por ejemplo, v0.13.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 la caja de herramientas de MCP (por ejemplo, v0.13.0).
Haz que el archivo binario sea ejecutable.
```
chmod +x toolbox
```
Verifica la instalación.
```
./toolbox --version
```

Configurar el cliente de MCP

Código de Claude

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.

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

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.

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

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.

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

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.

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

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.

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

Windsurf

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.

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

Gemini CLI

Instala la CLI de Gemini.
En tu directorio de trabajo, crea una carpeta llamada .gemini. En ella, crea un archivo settings.json.
Añade la siguiente configuración, sustituye las variables de entorno por tus valores y, a continuación, guarda los cambios.

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

Gemini Code Assist

Instala la extensión Gemini Code Assist en Visual Studio Code.
Habilita el modo Agente en el chat de Gemini Code Assist.
En tu directorio de trabajo, crea una carpeta llamada .gemini. En ella, crea un archivo settings.json.
Añade la siguiente configuración, sustituye las variables de entorno por tus valores y, a continuación, guarda los cambios.

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

Usar las herramientas

Tu herramienta de IA ahora está conectada a Firestore mediante el MCP. Prueba a pedirle a tu asistente de IA que liste colecciones, obtenga documentos, consulte colecciones o gestione reglas de seguridad.

El LLM tiene acceso a las siguientes herramientas:

firestore-add-documents: añade un documento a una ruta de colección de Firestore.
firestore-get-documents: obtiene varios documentos de Firestore por sus rutas.
firestore-list-collections: enumera las colecciones de Firestore de una ruta superior determinada.
firestore-delete-documents: elimina varios documentos de Firestore.
firestore-query-collection: consulta documentos de una colección con opciones de filtrado, ordenación y límite.
firestore-get-rules: obtiene las reglas de seguridad de Firestore activas del proyecto actual.
firestore-update-document: actualiza un documento de Firestore por su ruta.
firestore-validate-rules: valida la sintaxis y los errores de las reglas de seguridad de Firestore.