Gemini MCP — Tu conector personal de Gemini para Claude

Servidor MCP que conecta Claude.ai con la API de Gemini para generar imágenes (Nano Banana Pro) y videos (Veo) desde cualquier chat, incluso desde el celular. Funciona igual que el conector de Higgsfield, pero con tu propia API key de Google y pagando solo lo que uses.

Herramientas que tendrá Claude

Herramienta	Qué hace
generar_imagen	Imagen con Nano Banana Pro (1:1, 3:4, 9:16, 16:9, 21:9…)
editar_imagen	Edita una imagen existente (URL pública) con instrucciones
imagen_a_video	Anima un guide image con Veo manteniendo la composición
crear_video	Inicia un video de 8 s con Veo (16:9 o 9:16 con audio)
estado_video	Consulta el video y entrega el enlace MP4 de descarga

---

Instalación (todo se puede hacer desde el iPhone, en Safari)

Paso 1 — API key de Google

1. Entra a aistudio.google.com/apikey con tu cuenta de Google.
2. Toca "Create API key" y cópiala (empieza por AIza...).
3. Para usar Veo y Nano Banana Pro la cuenta debe tener facturación habilitada (puedes vincular el mismo proyecto de Google Cloud que ya usas en Vertex AI).

Paso 2 — Subir este código a GitHub

1. Entra a github.com → New repository → nombre: gemini-mcp → privado → Create.
2. Toca "uploading an existing file" y sube los archivos de este proyecto (puedes descomprimir el ZIP en la app Archivos del iPhone y subirlos: package.json, wrangler.jsonc, tsconfig.json, .gitignore y la carpeta src con index.ts).
   • Si GitHub web no te deja subir la carpeta, crea el archivo a mano: Add file → Create new file → escribe src/index.ts en el nombre y pega el contenido.

Paso 3 — Desplegar en Cloudflare (gratis)

1. Crea cuenta en dash.cloudflare.com.
2. Menú Compute (Workers) → Create → Import a repository.
3. Conecta tu GitHub y elige el repo gemini-mcp. Deja la configuración por defecto (Cloudflare detecta Wrangler) y toca Deploy.
4. Cuando termine, tendrás una URL tipo: https://gemini-mcp.TUUSUARIO.workers.dev

Paso 4 — Configurar la API key (secreto)

1. En el panel del Worker: Settings → Variables and Secrets → Add.
2. Tipo Secret, nombre GEMINI_API_KEY, valor: tu key de Google.
3. (Recomendado) Agrega otro secreto MCP_TOKEN con una clave inventada larga (ej. fcz-2026-pereira-glow). Esto protege tu conector para que nadie más gaste tu API.
4. Toca Deploy de nuevo para aplicar los cambios.

Paso 5 — Conectar en Claude

1. En Claude (app o claude.ai): Ajustes → Conectores → Agregar conector personalizado.
2. Nombre: Gemini — URL:
   • Sin token: https://gemini-mcp.TUUSUARIO.workers.dev/mcp
   • Con token: https://gemini-mcp.TUUSUARIO.workers.dev/mcp/TU_TOKEN
3. Guardar. Listo: aparecerá como un conector más, igual que Higgsfield.

---

Cómo se usa (desde el celular)

• Imagen: "Genera con mi conector Gemini una imagen de Sofía en la playa, 3:4."
• Video: "Crea con Gemini un video 9:16 de Sofía aplicándose el serum."
  1. Claude llama a crear_video → recibe un ID de operación.
  2. Espera ~1-3 minutos y pide: "consulta el estado del video".
  3. Claude llama a estado_video → te entrega un enlace de descarga.
  4. Abres el enlace en Safari → botón compartir → Guardar video en Fotos.

Modelos y costos (aprox., verifica en ai.google.dev/pricing)

• Imagen Nano Banana Pro: centavos de dólar por imagen.
• Video Veo 3.1 (8 s con audio): unos pocos dólares por clip; existe la variante fast más económica. Para cambiar de modelo agrega variables (no secretas) en Cloudflare:
  • IMAGE_MODEL (por defecto gemini-3-pro-image-preview)
  • VIDEO_MODEL (por defecto veo-3.1-generate-preview, prueba veo-3.1-fast-generate-preview para ahorrar)

Nota: tu suscripción Gemini Ultra no cubre la API; la API se factura aparte en Google Cloud. Los nombres de modelo cambian con el tiempo: si un modelo da error 404, revisa el nombre vigente en ai.google.dev.

Solución de problemas

• "No autorizado" → la URL del conector no incluye el MCP_TOKEN correcto.
• Error 400/403 de Gemini → API key sin facturación o modelo no disponible en tu región/cuenta.
• El video "aún se está generando" → normal, Veo tarda 1-4 minutos; vuelve a pedir el estado.