Conecta tu IDE a Firestore con MCP Toolbox

Conecta tu IDE a Firestore con MCP Toolbox

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

El Protocolo de contexto del modelo (MCP) es un protocolo abierto para conectar modelos de lenguaje grandes (LLM) a fuentes de datos como Firestore. En esta página, se describe cómo usar la caja de herramientas de MCP para bases de datos y exponer tus herramientas de asistencia para desarrolladores a una instancia de Firestore con los siguientes IDEs:

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

Configura Firestore

1. Crea un Google Cloud proyecto nuevo o selecciona uno existente.

2. Habilita la API de Firestore para tu proyecto.

3. Crea una base de datos de Firestore si aún no lo hiciste.

4. Configura la autenticación para tu entorno local.

   • Instala gcloud CLI
   • Ejecuta gcloud auth application-default login para autenticarte

Instala MCP Toolbox

1. Descarga la versión más reciente de MCP 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.13.0 o una posterior de MCP 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 MCP Toolbox, por ejemplo, v0.13.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 MCP Toolbox, por ejemplo, v0.13.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 MCP Toolbox, por ejemplo, v0.13.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 MCP Toolbox, por ejemplo, v0.13.0.

2. Haz que el objeto binario sea ejecutable.

   chmod +x toolbox
   

3. Verifica la instalación:.

   ./toolbox --version
   

Configura el cliente de MCP

Código de Claude

1. Instala Claude Code.
2. Crea el archivo .mcp.json en la raíz del proyecto si no existe.
3. Agrega la siguiente configuración, reemplaza las variables de entorno por tus valores y guarda.

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

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

Claude para computadoras

1. Abre Claude Desktop y navega a Configuración.
2. En la pestaña Desarrollador, haz clic en Editar configuración para abrir el archivo de configuración.
3. Agrega la siguiente configuración, reemplaza las variables de entorno por tus valores y guarda.

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

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

Cline

1. Abre la extensión Cline en VS Code y presiona el ícono de Servidores de MCP.
2. Haz clic en Configure MCP Servers para abrir el archivo de configuración.
3. Agrega la siguiente configuración, reemplaza las variables de entorno por tus valores y guarda.

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

1. Crea el directorio .cursor en la raíz del proyecto si no existe.
2. Crea el archivo .cursor/mcp.json si no existe y ábrelo.
3. Agrega la siguiente configuración, reemplaza las variables de entorno por tus valores y guarda.

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

4. 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)

1. Abre VS Code y crea el directorio .vscode en la raíz de tu proyecto si no existe.
2. Crea el archivo .vscode/mcp.json si no existe y ábrelo.
3. Agrega la siguiente configuración, reemplaza las variables de entorno por tus valores y guarda.

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

Windsurf

1. Abre Windsurf y navega al asistente de Cascade.
2. Haz clic en el ícono de MCP y, luego, en Configurar para abrir el archivo de configuración.
3. Agrega la siguiente configuración, reemplaza las variables de entorno por tus valores y guarda.

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

CLI de Gemini

1. Instala la CLI de Gemini.
2. En tu directorio de trabajo, crea una carpeta llamada .gemini. Dentro de él, crea un archivo settings.json.
3. Agrega la siguiente configuración, reemplaza las variables de entorno por tus valores y, luego, 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

1. Instala la extensión de Gemini Code Assist en Visual Studio Code.
2. Habilita el modo de agente en el chat de Gemini Code Assist.
3. En tu directorio de trabajo, crea una carpeta llamada .gemini. Dentro de él, crea un archivo settings.json.
4. Agrega la siguiente configuración, reemplaza las variables de entorno por tus valores y, luego, guarda los cambios.

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

Usa las herramientas

Tu herramienta de IA ahora está conectada a Firestore a través de MCP. Intenta pedirle a tu asistente de IA que enumere colecciones, obtenga documentos, consulte colecciones o administre reglas de seguridad.

Las siguientes herramientas están disponibles para el LLM:

• firestore-add-documents: Agrega un documento a una ruta de acceso de la colección de Firestore.
• firestore-get-documents: Obtiene varios documentos de Firestore por sus rutas.
• firestore-list-collections: Enumera las colecciones de Firestore para una ruta principal determinada.
• firestore-delete-documents: Borra varios documentos de Firestore.
• firestore-query-collection: Consulta documentos de una colección con opciones de filtrado, ordenamiento y límite.
• firestore-get-rules: Recupera las reglas de seguridad activas de Firestore para el proyecto actual.
• firestore-update-document: Actualiza un documento existente en Firestore por su ruta de acceso.
• firestore-validate-rules: Valida la sintaxis y los errores de las reglas de seguridad de Firestore.

Nota: Las herramientas prediseñadas son anteriores a la versión 1.0, por lo que se esperan algunos cambios entre las versiones. Los LLM se adaptarán a las herramientas disponibles, por lo que esto no afectará a la mayoría de los usuarios.