Firebase MCP Server

Firebase MCP Server

El servidor Firebase Model Context Protocol (MCP) brinda a las herramientas de desarrollo impulsadas por IA la capacidad de trabajar con tus proyectos de Firebase y el código de tu aplicación. El servidor Firebase MCP funciona con cualquier herramienta que pueda actuar como cliente MCP, incluyendo: Firebase Studio, Gemini CLI, Claude Code, Cline, Cursor, VS Code Copilot, Windsurf, ¡y más!

Características

Un editor configurado para usar el servidor Firebase MCP puede aprovechar sus capacidades de IA para ayudarte a:

• Crear y administrar proyectos de Firebase - Inicializar nuevos proyectos, listar los existentes y administrar aplicaciones de Firebase
• Administrar usuarios de Firebase Authentication - Recuperar, actualizar y administrar cuentas de usuario
• Trabajar con Cloud Firestore y Firebase SQL Connect - Consultar, leer, escribir y administrar documentos de bases de datos
• Recuperar esquemas de Firebase SQL Connect - Generar esquemas y operaciones con asistencia de IA
• Comprender las reglas de seguridad - Validar y recuperar reglas de seguridad para Firestore, Cloud Storage y Realtime Database
• Enviar mensajes con Firebase Cloud Messaging - Enviar notificaciones push a dispositivos y temas
• Acceder a datos de Crashlytics - Depurar problemas, ver informes de fallos y administrar análisis de fallos
• Implementar en App Hosting - Monitorear backends y recuperar registros
• Trabajar con Realtime Database - Leer y escribir datos en tiempo real
• Consultar registros de Cloud Functions - Recuperar y analizar registros de ejecución de funciones
• Administrar Remote Config - Obtener y actualizar plantillas de configuración remota

Algunas herramientas usan Gemini in Firebase para ayudarte a:

• Generar esquemas y operaciones de Firebase SQL Connect
• Consultar a Gemini sobre productos de Firebase

Importante: Gemini in Firebase puede generar resultados que parecen plausibles pero que son incorrectos de hecho. Puede responder con información inexacta que no representa las opiniones de Google. Valida todo el resultado de Gemini antes de usarlo y no uses código generado sin probar en producción. No ingreses información de identificación personal (PII) ni datos de usuario en el chat.
Obtén más información sobre Gemini in Firebase y cómo usa tus datos.

Instalación y Configuración

Requisitos previos

Asegúrate de tener una instalación funcional de Node.js y npm.

Configuración básica

El servidor Firebase MCP puede funcionar con cualquier cliente MCP que admita entrada/salida estándar (stdio) como medio de transporte. Cuando el servidor Firebase MCP realiza llamadas a herramientas, usa las mismas credenciales de usuario que autorizan la CLI de Firebase en el entorno donde se ejecuta.

Aquí tienes instrucciones de configuración para herramientas populares de asistencia con IA:

Gemini CLI

Instala la extensión de Firebase para Gemini CLI:

gemini extensions install https://github.com/firebase/agent-skills

Claude Code

Opción 1: Instalar mediante plugin (Recomendado)

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

1. Agrega el marketplace de Firebase para plugins de Claude:

   claude plugin marketplace add firebase/firebase-tools
   

2. Instala el plugin de Claude para Firebase:

   claude plugin install firebase@firebase
   

3. Verifica la instalación:

   claude plugin
   

Opción 2: Configurar el servidor MCP manualmente

Alternativamente, puedes configurar manualmente el servidor Firebase MCP ejecutando:

claude mcp add firebase npx -- -y firebase-tools@latest mcp

Puedes verificar la instalación ejecutando:

claude mcp list

Debería mostrar:

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

Cursor

Agrega a .cursorrules en el directorio de tu proyecto o configura en la configuración de Cursor:

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

Windsurf

Agrega a ~/.codeium/windsurf/mcp_config.json:

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

Firebase Studio

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

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

Uso

Una vez configurado, el servidor MCP proporcionará automáticamente capacidades de Firebase a tu asistente de IA. Puedes:

• Pedirle a la IA que te ayude a configurar servicios de Firebase
• Consultar tu base de datos de Firestore
• Administrar usuarios de autenticación
• Implementar en Firebase Hosting
• Depurar problemas de Crashlytics
• ¡Y mucho más!

Para obtener una lista completa de herramientas y recursos disponibles, consulta la sección Capacidades del servidor a continuación.

Documentación

Para obtener más información, visita la documentación oficial del servidor Firebase MCP.

Capacidades del servidor

El servidor Firebase MCP proporciona tres tipos de capacidades: Herramientas (funciones que realizan acciones), Indicaciones (plantillas de comandos reutilizables) y Recursos (archivos de documentación para modelos de IA).

Nombre de la herramienta	Grupo de funciones	Descripción
apphosting_fetch_logs	apphosting	Obtener registros recientes de servicio o compilación para un backend de App Hosting.
apphosting_list_backends	apphosting	Listar backends de App Hosting, configuraciones de tráfico y dominios personalizados en tu proyecto.
auth_get_users	auth	Recuperar usuarios de Firebase Auth por UID, correo electrónico, número de teléfono o listar todos los usuarios.
auth_update_user	auth	Actualizar la cuenta de un usuario habilitándola/deshabilitándola o estableciendo claims personalizados.
auth_set_sms_region_policy	auth	Establecer una política de región SMS que permita o deniegue códigos de país específicos para Firebase Authentication.
firebase_login	core	Iniciar sesión del usuario en Firebase CLI y el servidor MCP o verificar el estado actual de autenticación.
firebase_logout	core	Cerrar la sesión del usuario de Firebase CLI y el servidor MCP.
firebase_validate_security_rules	core	Validar sintaxis y verificar errores en reglas de seguridad de Firestore, Storage o Realtime Database.
firebase_get_project	core	Recuperar metadatos y detalles de configuración del proyecto de Firebase actualmente activo.
firebase_list_apps	core	Listar todas las aplicaciones de Firebase registradas en el proyecto activo.
firebase_list_projects	core	Listar proyectos de Firebase accesibles por el usuario autenticado.
firebase_get_sdk_config	core	Recuperar detalles de configuración del SDK o el contenido del archivo de configuración para una aplicación de Firebase registrada.
firebase_create_project	core	Crear un nuevo proyecto de Firebase o habilitar servicios de Firebase en un proyecto existente de Google Cloud.
firebase_create_app	core	Crear una nueva aplicación iOS, Android o Web en el proyecto de Firebase activo.
firebase_create_android_sha	core	Agregar un hash de certificado SHA-1 o SHA-256 a una aplicación Android en el proyecto de Firebase activo.
firebase_get_environment	core	Recuperar la configuración actual del entorno de Firebase CLI y MCP, el proyecto activo y el usuario autenticado.
firebase_update_environment	core	Actualizar configuraciones del entorno, como el directorio del proyecto, el proyecto activo o la cuenta de usuario activa.
firebase_init	core	Inicializar y configurar servicios de Firebase en tu espacio de trabajo de proyecto local.
firebase_get_security_rules	core	Recuperar las reglas de seguridad activas para Firestore, Storage o Realtime Database.
firebase_read_resources	core	Leer el contenido de los recursos de documentación internos firebase:// o listar todos los recursos disponibles.
crashlytics_create_note	crashlytics	Agregar una nota a un problema de Crashlytics para una aplicación Android o iOS.
crashlytics_delete_note	crashlytics	Eliminar una nota de un problema de Crashlytics para una aplicación Android o iOS.
crashlytics_get_issue	crashlytics	Recuperar detalles y metadatos de un problema específico de Crashlytics.
crashlytics_list_events	crashlytics	Listar eventos recientes de fallos y excepciones que coincidan con filtros especificados para un problema.
crashlytics_batch_get_events	crashlytics	Recuperar eventos de muestra de fallos y excepciones por nombre de recurso para depuración.
crashlytics_list_notes	crashlytics	Listar todas las notas adjuntas a un problema de Crashlytics para una aplicación Android o iOS.
crashlytics_get_report	crashlytics	Generar informes numéricos agregados para problemas y eventos de Crashlytics.
crashlytics_update_issue	crashlytics	Actualizar el estado (ABIERTO o CERRADO) de un problema de Crashlytics.
realtimedatabase_get_data	realtimedatabase	Leer datos de una ruta especificada en Firebase Realtime Database.
realtimedatabase_set_data	realtimedatabase	Escribir datos JSON en una ruta especificada en Firebase Realtime Database.
dataconnect_build	dataconnect	Compilar esquemas, operaciones y conectores de Firebase SQL Connect para validar sintaxis y tipos.
dataconnect_list_services	dataconnect	Listar servicios, esquemas y conectores locales e implementados de Firebase SQL Connect.
dataconnect_execute	dataconnect	Ejecutar una consulta o mutación GraphQL contra un servicio o emulador de Firebase SQL Connect.
firestore_delete_document	firestore	Usa esto para eliminar documentos de Firestore de una base de datos en el proyecto actual mediante rutas completas de documentos. Úsalo si conoces la ruta exacta de un documento.
firestore_get_documents	firestore	Usa esto para recuperar uno o más documentos de Firestore de una base de datos en el proyecto actual mediante rutas completas de documentos. Úsalo si conoces la ruta exacta de un documento.
firestore_list_collections	firestore	Usa esto para recuperar una lista de colecciones de una base de datos de Firestore en el proyecto actual.
firestore_query_collection	firestore	Consultar documentos de Firestore de una colección con filtros y ordenamiento opcionales.
functions_get_logs	functions	Recuperar y filtrar entradas de registros de Cloud Functions desde Google Cloud Logging.
functions_list_functions	functions	Listar todas las Cloud Functions implementadas en tu proyecto de Firebase.
messaging_send_message	messaging	Enviar una notificación push de Firebase Cloud Messaging a un token de registro de dispositivo o tema.
remoteconfig_get_template	remoteconfig	Recuperar la versión activa o especificada de la plantilla de Firebase Remote Config.
remoteconfig_update_template	remoteconfig	Publicar una nueva plantilla de Firebase Remote Config o revertir a una versión anterior.
storage_get_object_download_url	storage	Recuperar la URL de descarga de un objeto en un bucket de Cloud Storage.

Nombre del prompt	Grupo de funciones	Descripción
firebase:deploy	core	Usa este comando para implementar recursos en Firebase. Argumentos: <prompt> (opcional): cualquier instrucción específica que desees proporcionar sobre la implementación
firebase:init	core	Usa este comando para configurar servicios de Firebase, como funciones backend y funciones de IA.
firestore:generate_security_rules	firestore	Genera reglas de seguridad seguras de Firebase Firestore y las pruebas unitarias correspondientes para tu proyecto.
storage:generate_security_rules	storage	Genera reglas de seguridad seguras de Firebase Storage y las pruebas unitarias correspondientes para tu proyecto.
crashlytics:connect	crashlytics	Usa este comando para acceder a los datos de Crashlytics de una aplicación de Firebase.
Nombre del recurso	Descripción
--------------------------------	-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
app_id_guide	Guía de ID de App de Firebase: guía al agente de codificación para elegir un ID de App de Firebase en el proyecto actual
crashlytics_investigations_guide	Guía de investigaciones de Crashlytics de Firebase: guía al agente de codificación al investigar errores reportados en problemas de Crashlytics, incluidos los procedimientos para diagnosticar y corregir fallos.
crashlytics_issues_guide	Guía de problemas de Crashlytics de Firebase: guía al agente de codificación al trabajar con problemas de Crashlytics, incluidas las reglas de priorización y los procedimientos para diagnosticar y corregir fallos.
crashlytics_reports_guide	Guía de informes de Crashlytics de Firebase: guía al agente de codificación para solicitar informes de Crashlytics, incluido el establecimiento de filtros apropiados y cómo entender las métricas. El agente debe leer esta guía antes de solicitar cualquier informe.
backend_init_guide	Guía de inicialización de backend de Firebase: guía al agente de codificación para configurar los servicios de backend de Firebase en el proyecto actual
ai_init_guide	Guía de inicialización de GenAI de Firebase: guía al agente de codificación para configurar las capacidades de GenAI en el proyecto actual utilizando Firebase
firestore_init_guide	Guía de inicialización de Firestore: guía al agente de codificación para configurar Firestore en el proyecto actual
firestore_rules_init_guide	Guía de inicialización de reglas de Firestore: guía al agente de codificación para configurar las reglas de seguridad de Firestore en el proyecto
auth_init_guide	Guía de inicialización de autenticación de Firebase: guía al agente de codificación para configurar Firebase Authentication en el proyecto actual
hosting_init_guide	Guía de implementación de Firebase Hosting: guía al agente de codificación para implementar en Firebase Hosting en el proyecto actual
docs	Documentación de Firebase: carga contenido de texto plano de la documentación de Firebase, por ejemplo, https://firebase.google.com/docs/functions se convierte en firebase://docs/functions