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 la Firebase CLI y el servidor de MCP de Firebase, puedes transformar tu agente de programació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 de IA para configurar Cloud Firestore, Authentication, y Firebase Hosting para una app web. Vuelve a consultar pronto para obtener información sobre las apps para iOS, Android y Flutter.

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

Los modelos generales de IA suelen tener problemas con configuraciones de proyectos específicas o información desactualizada. Este kit de herramientas resuelve ese problema:

  • 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 proporciona al agente de programación contexto y acceso. 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.
  • Firebase CLI: La interfaz de línea de comandos le proporciona al agente de programación poder de acción. Es la herramienta de ejecución que usa el agente para realizar tareas pesadas, como inicializar bases de datos, administrar configuraciones de autenticación de usuarios y, también, implementar código en tu nombre.

Si usas las habilidades de agentes de Firebase junto con la Firebase CLI y el servidor de MCP de Firebase , tu agente de programación de IA tendrá capacidades adicionales:

  • Toma medidas: Haz más que solo escribir código. Tu agente puede inicializar servicios, administrar Authentication usuarios, implementar nuevas Firebase Security Rules, y trabajar directamente con tus Cloud Firestore datos.
  • Mantenerse actualizado: Usa instrucciones oficiales que tengan en cuenta 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 proporcionar ayuda más pertinente y precisa.
  • Reducir los costos de tokens: Las habilidades de agentes 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 las herramientas de agentes?

Esta guía se centra principalmente en cómo las habilidades de agentes, la Firebase CLI y el servidor de MCP de Firebase trabajan juntos para ayudarte a configurar rápidamente estos servicios y funciones:

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

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 Firebase y el servidor de MCP de Firebase para completar estas tareas.

Paso 1: Instala las 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 agentes de Firebase se incluyen como uno de los Build with Google paquetes de integración para Antigravity. Puedes habilitar este paquete para el acceso a nivel global en dos puntos:

  • Durante la incorporación: Elige 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 de tu 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 el 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 Firebase CLI para las tareas, se recomienda conectar tu agente de programación de IA al servidor de MCP de Firebase. Esta conexión mejora la capacidad de tu 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 de IA que configure el servidor de MCP de Firebase. Sin embargo, si tiene problemas o no ves el servidor de MCP de Firebase en la lista, cambia al método manual.

Método manual

Antigravity

Si deseas 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 las herramientas de agentes configuradas, ahora puedes usar el lenguaje natural para que tu agente de programación de IA configure Cloud Firestore, Authentication, y Firebase Hosting.

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

    • Configura Cloud Firestore como la base de datos para 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 pueda proporcionar tu agente, como los siguientes:

    1. Planes: Tu agente propone una estrategia basada en tu base de código existente.
    2. Conexiones: Tu agente vincula tu código local a un proyecto de Firebase existente o te ayuda a crear un proyecto de Firebase nuevo.
    3. Inicializa recursos: Tu agente agrega las bibliotecas y la configuración necesarias de Firebase 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 Firebase CLI 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 solicitar un agente de programación de IA

Para aprovechar al máximo tu agente de programación de IA, en especial cuando trabajas con integraciones multifacéticas como Firebase, trata 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 le proporciona al agente un contexto significativo sobre tu proyecto, las instrucciones de lenguaje natural claras y específicas producen los mejores resultados. Evita las solicitudes vagas.

  • Vago: "Fix the database error."
  • Específico: "I'm getting a 'permission denied' error when trying to write to the 'users' collection in Cloud Firestore. Review my firestore.rules and suggest a fix that allows authenticated users to write to their own document".

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: "That code uses the older v8 SDK. Rewrite it using the Firebase v9 modular SDK".
  • Solicita explicaciones: "Explain how those Firebase Security Rules protect user data."

Verifica antes de ejecutar

Los agentes de programació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 Firebase Security Rules y los archivos de configuración (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 de implementación personalizado.

  • Ejemplo: "Look at my src/web/index.html file and show me where to add the standard Firebase initialization script."

Próximos pasos