Integra servicios de Firebase con asistencia de IA

Optimiza la configuración de Firebase para apps web con herramientas de desarrollo potenciadas por IA, como Antigravity, Claude Code, Codex y Cursor. Si usas las habilidades de agentes de Firebase junto con Firebase CLI y el servidor de MCP de Firebase, puedes transformar tu agente de codificación de IA en un experto especializado en Firebase que puede escribir código, configurar Firebase Security Rules y administrar recursos activos.

En esta guía, se explica cómo usar un agente de programación basado en IA para configurar Cloud Firestore, Authentication y Firebase Hosting para una app web. Vuelve a consultar esta guía pronto para obtener información sobre las apps para iOS, Android y Flutter.

¿Por qué usar las habilidades y herramientas de agentes de Firebase?

Los modelos de IA generales suelen tener dificultades con las configuraciones específicas de los proyectos o la información desactualizada. Este kit de herramientas cierra esa brecha:

  • Habilidades de agentes de Firebase: Las habilidades proporcionan al agente de programación experiencia en el dominio. Proporcionan documentación actualizada y flujos de trabajo óptimos para que el agente conozca la forma correcta y recomendada por Firebase de estructurar tu arquitectura.
  • Servidor de MCP de Firebase: El servidor de MCP le brinda contexto y acceso al agente de codificación. Establece un protocolo estándar para que el agente inspeccione de forma programática los recursos, los archivos locales y las configuraciones de tu proyecto activo.
  • CLI de Firebase: La interfaz de línea de comandos le brinda al agente de codificación poder práctico. Es la herramienta de ejecución que usa el agente para realizar tareas pesadas, como inicializar bases de datos, administrar la configuración de autenticación de usuarios y, también, implementar código en tu nombre.

Usar las habilidades del agente de Firebase junto con la CLI de Firebase y el servidor de MCP de Firebase le brinda a tu agente de programación de IA capacidades adicionales:

  • Toma medidas: Haz más que solo escribir código. Tu agente puede inicializar servicios, administrar usuarios de Authentication, implementar nuevos Firebase Security Rules y trabajar directamente con tus datos de Cloud Firestore.
  • Mantente al día: Usa instrucciones oficiales y específicas de la versión para guiar a tu agente en las tareas de configuración.
  • Mejorar la precisión: Accede al entorno y los esquemas de tu proyecto para brindar ayuda más pertinente y precisa.
  • Reducción de los costos de los tokens: Las habilidades del agente cargan documentación detallada solo cuando una tarea específica lo requiere, lo que minimiza la sobrecarga de la sesión.

¿Con qué servicios de Firebase pueden ayudar las habilidades y herramientas del agente?

En esta guía, se explica principalmente cómo las habilidades del agente, la CLI de Firebase y el servidor de MCP de Firebase trabajan en conjunto para ayudarte a configurar rápidamente estos servicios y funciones:

  • Cloud Firestore: Aprovisiona una base de datos NoSQL.
  • Authentication: Configura el acceso seguro del usuario.
  • Firebase Security Rules: Genera y define mejor la Security Rules de tu app.
  • Firebase Hosting: Configura tu proyecto para la implementación de la app web estática.

Para obtener una lista completa de lo que está disponible, consulta la lista completa de habilidades de agentes de Firebase.

Flujo de trabajo general

En los siguientes pasos, se describe un flujo de trabajo generalizado para usar las habilidades de agentes de Firebase para configurar y usar los servicios de Firebase en una app web. En segundo plano, las habilidades de agentes usan la CLI de Firebase y el servidor de MCP de Firebase para completar estas tareas.

Paso 1: Instala habilidades de agentes de Firebase

En la mayoría de los casos, puedes instalar las habilidades de agentes de Firebase en tu editor preferido con una sola instrucción:

Antigravity

Las habilidades de los agentes de Firebase se incluyen como uno de los paquetes de integración de Build with Google para Antigravity. Puedes habilitar este paquete para el acceso a nivel global en dos puntos:

  • Durante la incorporación: Selecciona la casilla de verificación de la pila de Firebase.
  • En la configuración: Navega a Configuración > Personalizaciones. En Build with Google Plugins, haz clic en Customize y, luego, en Download para la integración de Firebase.

Si prefieres el acceso a nivel del proyecto, ejecuta el siguiente comando en el directorio del proyecto:

npx skills add firebase/agent-skills --agent=antigravity

Claude Code

claude plugin marketplace add firebase/agent-skills
claude plugin install firebase@firebase

Codex

npx skills add firebase/agent-skills --agent=codex

Cursor

Puedes instalar habilidades de agentes de Firebase directamente desde Cursor Marketplace o ejecutando el siguiente comando en tu terminal:

npx skills add firebase/agent-skills --agent=cursor

Otros agentes

npx skills add firebase/agent-skills

Paso 2: Conéctate al servidor de MCP de Firebase

Si bien muchas habilidades de agentes de Firebase usan la CLI de Firebase para las tareas, se recomienda conectar tu agente de codificación de IA al servidor de MCP de Firebase. Esta conexión mejora la capacidad del agente para interactuar con tu entorno de Firebase, lo que proporciona una integración y un acceso más profundos.

Método asistido por IA

En la mayoría de los casos, puedes pedirle a tu agente de programación con IA que configure el servidor de MCP de Firebase. Sin embargo, si tienes problemas o no ves el servidor de MCP de Firebase en la lista, cambia al método manual.

Método manual

Antigravity

Para configurar Antigravity para que use el servidor de MCP de Firebase, haz lo siguiente:

  1. En Antigravity, haz clic en el menú en el panel Agent > MCP Servers.
  2. Selecciona Firebase > Install.

Esto actualiza automáticamente tu archivo mcp_config.json, que puedes ver haciendo clic en Manage MCP Servers en la parte superior del panel de MCP Store > View raw config, con el siguiente contenido:

{
  "mcpServers": {
    "firebase-mcp-server": {
      "command": "npx",
      "args": ["-y", "firebase-tools@latest", "mcp"]
    }
  }
}

Firebase Studio

Para configurar Firebase Studio para que use el servidor de MCP de Firebase, edita o crea el archivo de configuración: .idx/mcp.json.

Si el archivo aún no existe, créalo haciendo clic con el botón derecho en el directorio principal y seleccionando Nuevo archivo. Agrega el siguiente contenido al archivo:

{
  "mcpServers": {
    "firebase": {
      "command": "npx",
      "args": ["-y", "firebase-tools@latest", "mcp"]
    }
  }
}

Claude

Claude Code

  • Opción 1: Instala mediante el complemento (recomendado)

    La forma más fácil de configurar el servidor de MCP de Firebase en Claude Code es instalar el complemento oficial de Firebase:

    1. Agrega Marketplace de Firebase para los complementos de Claude:

      claude plugin marketplace add firebase/firebase-tools
    2. Instala el complemento de Claude para Firebase:

      claude plugin install firebase@firebase
    3. Verifica la instalación:

      claude plugin marketplace list
  • Opción 2: Configura el servidor de MCP de forma manual

    Como alternativa, puedes configurar manualmente el servidor de MCP de Firebase:

    1. Ejecuta el siguiente comando en la carpeta de tu app:

      claude mcp add firebase npx -- -y firebase-tools@latest mcp
    2. Verifica la instalación:

      claude mcp list

      Debería mostrar lo siguiente:

      firebase: npx -y firebase-tools@latest mcp - ✓ Connected
      

Claude para computadoras de escritorio

Para configurar Claude Desktop para que use el servidor MCP de Firebase, edita el archivo claude_desktop_config.json. Puedes abrir o crear este archivo desde el menú Claude > Configuración. Selecciona la pestaña Desarrollador y, luego, haz clic en Editar configuración.

{
  "mcpServers": {
    "firebase": {
      "command": "npx",
      "args": ["-y", "firebase-tools@latest", "mcp"]
    }
  }
}

Cline

Para configurar Cline para que use el servidor MCP de Firebase, edita el archivo cline_mcp_settings.json. Para abrir o crear este archivo, haz clic en el ícono de los servidores de MCP en la parte superior del panel de Cline y, luego, en el botón Configure MCP Servers.

{
  "mcpServers": {
    "firebase": {
      "command": "npx",
      "args": ["-y", "firebase-tools@latest", "mcp"],
      "disabled": false
    }
  }
}

Cursor

Opción 1: Complemento de Marketplace (recomendado)

Instala el complemento de Firebase desde Cursor Marketplace. Esta acción configura automáticamente el servidor de MCP y proporciona acceso a las habilidades de agentes de Firebase.

Opción 2: Configuración del MCP con un solo clic

Si solo quieres agregar el servidor de MCP a tu configuración global, haz clic en el siguiente botón:

Instala el servidor de MCP

Opción 3: Configuración manual

Si prefieres configurar el servidor para un proyecto específico o editar la configuración de forma manual, actualiza el archivo mcp.json:

  • Para un proyecto específico, edita .cursor/mcp.json
  • Para todos los proyectos (global), edita ~/.cursor/mcp.json
"mcpServers": {
  "firebase": {
    "command": "npx",
    "args": ["-y", "firebase-tools@latest", "mcp"]
  }
}

Copilot en VS Code

Para configurar un solo proyecto, edita el archivo .vscode/mcp.json en tu espacio de trabajo:

"servers": {
  "firebase": {
    "type": "stdio",
    "command": "npx",
    "args": ["-y", "firebase-tools@latest", "mcp"]
  }
}

Para que el servidor esté disponible en todos los proyectos que abras, edita la configuración del usuario, por ejemplo:

"mcp": {
  "servers": {
    "firebase": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "firebase-tools@latest", "mcp"]
    }
  }
}

Windsurf

Para configurar Windsurf Editor, edita el archivo ~/.codeium/windsurf/mcp_config.json:

"mcpServers": {
  "firebase": {
    "command": "npx",
    "args": ["-y", "firebase-tools@latest", "mcp"]
  }
}

Paso 3: Inicializa los servicios de Firebase

Con las habilidades y herramientas del agente configuradas, ahora puedes usar lenguaje natural para que tu agente de programación con IA configure Cloud Firestore, Authentication y Firebase Hosting.

  1. Solicita a tu agente que configure un servicio. Por ejemplo, puedes usar instrucciones como las siguientes:

    • Configura Cloud Firestore como la base de datos de esta app.
    • Crea una página de acceso con Authentication y actualiza Security Rules para garantizar que solo los usuarios autorizados puedan leer y escribir sus propios datos.
    • Configura Firebase Hosting y, luego, implementa la app en producción.
  2. Revisa la información y sigue los pasos guiados que te proporcione el agente, como los siguientes:

    1. Planes: Tu agente propone una estrategia basada en tu base de código existente.
    2. Conecta: Tu agente vincula tu código local a un proyecto de Firebase existente o te ayuda a crear uno nuevo.
    3. Inicializa recursos: Tu agente agrega las bibliotecas y la configuración de Firebase requeridas a tu base de código.
    4. Actualiza archivos: Tu agente crea y actualiza los archivos necesarios, como firestore.rules (para definir quién puede leer, escribir o consultar datos en tu base de datos) o firebase.json (para informar a la CLI de Firebase qué servicios implementar y cómo configurarlos).
    5. Ejecuta: Tu agente te guía a través de pasos adicionales de configuración o implementación.

Sugerencias generales para dar instrucciones a un agente de programación de IA

Para aprovechar al máximo tu agente de programación con IA, especialmente cuando trabajas con integraciones multifacéticas como Firebase, considera la interacción como una colaboración en lugar de un comando único.

Escribir instrucciones específicas y proporcionar contexto

Si bien el servidor de MCP de Firebase proporciona al agente un contexto significativo sobre tu proyecto, las instrucciones claras y específicas en lenguaje natural producen los mejores resultados. Evita las solicitudes vagas.

  • Vago: "Corrige el error de la base de datos".
  • Específico: "Recibo un error de "permiso denegado" cuando intento escribir en la colección "usuarios" en Cloud Firestore. Revisa mi firestore.rules y sugiere una corrección que permita a los usuarios autenticados escribir en su propio documento".

Itera y define mejor

Los agentes de programación de IA rara vez generan código perfecto en el primer intento para tareas complejas. Si una respuesta no es del todo correcta, continúa la conversación:

  • Proporciona mensajes de error: Pega los errores de la terminal o los registros de la consola en el chat.
  • Solicita ajustes: "Ese código usa el SDK de la versión 8 anterior. Reescríbelo con el SDK modular v9 de Firebase".
  • Solicita explicaciones: "Explica cómo esos Firebase Security Rules protegen los datos del usuario".

Verifica antes de ejecutar

Los agentes de codificación de IA son potentes, pero pueden cometer errores o "alucinar" (inventar funciones o servicios con nombres incorrectos).

  • Revisa el código: Siempre lee el código generado, en especial los archivos de configuración y Firebase Security Rules (como firebase.json), antes de realizar la implementación en producción.
  • Prueba de forma local: Siempre que sea posible, pídele al agente que te ayude a probar los cambios de forma local antes de publicarlos.

Usa la conexión de MCP

Dado que el servidor de MCP de Firebase le brinda a tu agente visibilidad directa de la estructura de tu proyecto, puedes hacer referencia a archivos específicos para obtener asesoramiento personalizado sobre la implementación.

  • Ejemplo: "Mira mi archivo src/web/index.html y muéstrame dónde agregar la secuencia de comandos de inicialización estándar de Firebase".

Próximos pasos