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

Related MCP server: Gemini Image Generator MCP

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.