Cómo conectar Firebase a Gemini vía MCP

💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → Firebase, pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin git clone, sin servidor local.

Firebase + Gemini

Deja que tu IA trabaje con Firebase: lista proyectos y apps, explora y consulta Cloud Firestore, crea y actualiza documentos, busca y deshabilita usuarios de Authentication, lee Remote Config y (desactivado por defecto) publica Remote Config o envía notificaciones push. Inicia sesión con tu cuenta de Google.

Requisitos previos

Las instrucciones de configuración completas están incluidas en el conector (visibles en el store al seleccionarlo). Las variables de entorno requeridas:

GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET

Paso 1 — Obtener credenciales

1. Abre console.cloud.google.com y selecciona el proyecto de Google Cloud de tu proyecto de Firebase (tiene el mismo id de proyecto). Lo más sencillo es crear ahí el cliente OAuth, porque las llamadas a la API se imputan al proyecto del cliente y ese proyecto necesita las APIs activadas.
2. Ve a APIs & Services → Library y activa las APIs que vayas a usar: Firebase Management API, Cloud Firestore API, Identity Toolkit API, Firebase Remote Config API y Firebase Cloud Messaging API.
3. Abre APIs & Services → OAuth consent screen. Elige Internal si usas Google Workspace (la opción más sencilla); si no, External. Con External, pon el estado de publicación en In production: mientras la app está en Testing, Google revoca sus tokens de actualización a los 7 días y el conector deja de funcionar cada semana.
4. Abre APIs & Services → Credentials → Create credentials → OAuth client ID, elige el tipo de aplicación Web application y añade el URI de redirección autorizado https://cloud.anythingmcp.com/api/mcp-oauth/callback. Si alojas AnythingMCP tú mismo, introduce en su lugar https://tu-host-anythingmcp/api/mcp-oauth/callback.
5. Pega el ID de cliente en GOOGLE_CLIENT_ID y el secreto de cliente en GOOGLE_CLIENT_SECRET, instala el conector, haz clic en Authorize with Provider e inicia sesión con una cuenta que sea miembro del proyecto de Firebase.

Un solo cliente de Google para todos los conectores de Google: el mismo proyecto de Cloud y el mismo cliente OAuth sirven para todos los conectores de Google, desde Gmail y Google Sheets hasta Search Console y BigQuery. Activa cada API en ese proyecto, reutiliza el mismo ID y secreto de cliente y autoriza cada conector una vez.

Scope y roles: el conector pide https://www.googleapis.com/auth/cloud-platform, porque los scopes más limitados de Firebase no cubren la administración de usuarios ni Remote Config. Lo que puede hacer la IA lo limitan los roles de la cuenta en el proyecto: para un uso de solo lectura, dale Firebase Viewer y Cloud Datastore Viewer; los cambios requieren roles como Cloud Datastore User, Firebase Authentication Admin, Firebase Remote Config Admin y Firebase Cloud Messaging Admin.

Qué hace: lista proyectos y sus apps de Android, iOS y web; explora colecciones y documentos de Firestore y los consulta con filtros, orden y un límite; crea y actualiza documentos; busca y lista usuarios de Authentication y deshabilita o vuelve a habilitar su inicio de sesión; lee la plantilla de Remote Config y su historial de versiones.

Los cambios esperan tu sí: antes de firebase_create_document, firebase_update_document o firebase_set_user_disabled, la IA te dice exactamente qué va a cambiar y espera un sí claro. Los cambios llegan al instante a tu app en producción. Las reglas de seguridad de Firestore no se aplican aquí: el conector actúa con los permisos de la cuenta con la que se inició sesión, como el Admin SDK.

Desactivadas al instalar: firebase_delete_document (elimina de forma definitiva), firebase_publish_remote_config (sustituye la configuración en producción de todas las apps) y firebase_send_message (envía una notificación push real a dispositivos reales). Un administrador las activa una a una si hace falta; incluso entonces, la IA comprueba antes el cambio con una ejecución de validación y solo publica o envía después de tu sí.

Las lecturas de Firestore se facturan: cada documento devuelto cuenta como una lectura en tu factura de Firebase, así que la IA usa páginas pequeñas (20 documentos por defecto) y solo pide los campos que necesita. Un filtro en un campo combinado con una ordenación por otro necesita un índice compuesto, y el mensaje de error enlaza a la página que lo crea. Los hashes y salts de las contraseñas de los usuarios nunca se devuelven.

No incluido: Crashlytics no tiene ninguna API REST pública documentada, así que los datos de fallos no están disponibles. Los archivos de Cloud Storage, Realtime Database, Data Connect, App Check y Analytics también quedan fuera.

Errores comunes: 401 significa que la autorización caducó o se revocó: vuelve a hacer clic en Authorize with Provider. 403 PERMISSION_DENIED con "API has not been used in project" o SERVICE_DISABLED: activa esa API en el proyecto de Cloud del cliente OAuth; cualquier otro 403 significa que a la cuenta le falta el rol. 404: un id de proyecto, un id de base de datos o una ruta incorrectos (una ruta de documento donde se espera una ruta de colección, o al revés). 400 FAILED_PRECONDITION "The query requires an index": abre el enlace del mensaje para crear el índice. 409 al publicar Remote Config: la plantilla cambió mientras tanto, así que la IA vuelve a leerla. 429: se alcanzó una cuota; espera y vuelve a intentarlo.

Paso 2 — Instalar el adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Paso 3 — Añadir el conector en Gemini

La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestra YOUR_SERVER_ID.

Gemini CLI lee los servidores MCP de ~/.gemini/settings.json (en Windows, %USERPROFILE%\.gemini\settings.json). Añade:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Crea una clave de API MCP en AnythingMCP en MCP Servers → tu servidor → API keys y pégala en lugar de YOUR_MCP_API_KEY.
2. Guarda el archivo y reinicia gemini.
3. Ejecuta /mcp dentro de Gemini CLI (o gemini mcp list en tu terminal): anythingmcp debería aparecer como conectado.
4. Empieza a escribir prompts: Gemini CLI ya puede llamar a las herramientas de Firebase.

Herramientas disponibles

Ejemplos de prompts

• "Lista mis proyectos de Firebase y las apps de Android, iOS y web de cada uno."
• "En Firestore, muéstrame los diez documentos más recientes de orders con el estado open."
• "¿Hay algún usuario con el email [email protected] en Firebase Authentication? ¿Cuándo inició sesión por última vez?"
• "Deshabilita el inicio de sesión de la cuenta [email protected]. Dime de qué cuenta se trata antes de hacerlo."
• "¿Qué contiene nuestra plantilla de Remote Config y quién publicó las tres últimas versiones?"

FAQ

¿Dónde busca Gemini CLI los servidores MCP? En ~/.gemini/settings.json para tu usuario, o en .gemini/settings.json dentro de un proyecto. gemini mcp list muestra cada servidor y si se conecta.

Siguientes pasos

• Página del conector
• Conectar a Claude
• Conectar a ChatGPT