Servidor MCP: imágenes, vídeo y voz en apps de IA

Dale a Claude, ChatGPT, Cursor, VS Code y otras apps de IA los modelos de imagenn, video y voz de Zurelay. Conecta el servidor MCP una vez, inicia sesión y pide una imagen, un clip o una locución en el chat: se crea con Nano Banana, GPT Image, Seedance, Kling, Wan o Gemini TTS y se paga con tu saldo de Zurelay, a los mismos precios que la API.

https://api.zurelay.com/mcp

Es un servidor remoto (Streamable HTTP), así que no hay nada que instalar. Inicia sesión desde la app o envía una clave de API. Está listado en el MCP Registry oficial como com.zurelay/mcp.

Qué hace

Los modelos de chat no son herramientas aquí: una app que ya funciona con un modelo ya tiene uno. Para usar Claude Code, Cursor o cualquier otra app con los modelos de chat de Zurelay, cambia su URL base (ver Integraciones).

Conecta tu app

Todas las apps de abajo pueden iniciar sesión: la autorizas una vez en zurelay.com y nunca pegas una clave. Las apps que no pueden iniciar sesión, o las configuraciones que no deberían abrir un navegador (servidores, CI), envían una clave de API en su lugar.

Claude (web, escritorio y móvil)

Agregar Zurelay a Claude abre el formulario ya rellenado. O hazlo a mano:

1. Ve a Personalizar, luego a Conectores, elige Agregar y después Agregar conector personalizado.
2. Ponle el nombre Zurelay y pega https://api.zurelay.com/mcp como URL del servidor MCP. Cualquiera de las dos opciones de cliente OAuth funciona: Usar la identidad publicada de Claude o Registrar automáticamente. Agrégalo.
3. Elige Conectar. Se abre Zurelay: inicia sesión, elige un límite de gasto diario y selecciona Permitir.
4. En un chat, abre +, luego Conectores, activa Zurelay y pide lo que quieras: «Haz un póster de 16:9 de…», «Anima esto en un clip de 5 segundos», «Lee esto en voz alta con una voz serena».

Los conectores funcionan en la web, en la app de escritorio y en tu teléfono, en todos los planes (Free permite un conector personalizado). En Team y Enterprise, un propietario agrega Zurelay en Configuración de la organización, Conectores (Agregar, Personalizado, Web); después cada miembro conecta su propia cuenta de Zurelay.

Claude Code

claude mcp add --scope user --transport http zurelay https://api.zurelay.com/mcp

Luego escribe /mcp en Claude Code, elige zurelay e inicia sesión en el navegador que se abre (o ejecuta claude mcp login zurelay). Con una clave de API en su lugar, no hace falta navegador:

claude mcp add --scope user --transport http zurelay https://api.zurelay.com/mcp \
  --header "Authorization: Bearer $ZURELAY_API_KEY"

--scope user lo agrega para todas las carpetas. Si lo omites, solo aparece cuando Claude Code se ejecuta en la carpeta desde la que lo agregaste; usa --scope project para compartirlo mediante el .mcp.json del proyecto (mantén las claves fuera de los archivos compartidos: .mcp.json lee ${ZURELAY_API_KEY} del entorno). Ejecuta el comando en una terminal normal, no dentro de Claude Code, y reinicia Claude Code si ya estaba abierto.

ChatGPT

1. En Configuración, Seguridad e inicio de sesión, activa el Modo desarrollador (Plus, Pro, Business, Enterprise y Edu; puede que un administrador del espacio de trabajo tenga que permitirlo).
2. Abre Plugins de ChatGPT y pulsa +. Ponle el nombre Zurelay e ingresa https://api.zurelay.com/mcp como URL de conexión, con OAuth.
3. Inicia sesión en Zurelay y elige Permitir. En un chat, abre +, elige Modo desarrollador y selecciona Zurelay.

ChatGPT solo inicia sesión: no puede enviar una clave de API.

Cursor

Agregar Zurelay a Cursor, luego elige Conectar junto a él en la configuración de MCP de Cursor para iniciar sesión. O agrégalo a ~/.cursor/mcp.json (todos los proyectos) o a .cursor/mcp.json (un proyecto):

{
  "mcpServers": {
    "zurelay": {
      "url": "https://api.zurelay.com/mcp"
    }
  }
}

VS Code

Agregar Zurelay a VS Code, o agrégalo a .vscode/mcp.json en tu proyecto (o ejecuta MCP: Add Server desde la Paleta de comandos y elige HTTP). VS Code te pide iniciar sesión la primera vez que el modo agente de Copilot lo usa. Con una clave de API, la pide una vez y la mantiene cifrada:

{
  "servers": {
    "zurelay": {
      "type": "http",
      "url": "https://api.zurelay.com/mcp"
    }
  }
}

Agentes de IA

Los agentes siempre activos y personales agregan el servidor de la misma forma: Grok Bot y Meta Muse cuando pegas un mensaje pidiéndolo, OpenAI dots mediante los plugins de ChatGPT, Gemini Spark, Manus y Perplexity en sus ajustes de conectores. OpenClaw y Hermes Agent también pueden usarlo, o la skill de Zurelay, que les consigue una clave propia a partir de un enlace que tú apruebas. Los pasos de cada agente están en Agentes de IA.

Codex, Gemini CLI y otras apps

Sirve cualquier app que hable MCP sobre Streamable HTTP. Codex inicia sesión con codex mcp login zurelay y Gemini CLI con /mcp auth zurelay; para usar una clave, la mayoría de las apps aceptan un encabezado Authorization:

# or: codex mcp add zurelay --url 'https://api.zurelay.com/mcp' --bearer-token-env-var ZURELAY_API_KEY
[mcp_servers.zurelay]
url = "https://api.zurelay.com/mcp"
bearer_token_env_var = "ZURELAY_API_KEY"

Iniciar sesión o una clave de API

Iniciar sesión es la forma más fácil y segura. La app abre zurelay.com, donde inicias sesión con un código enviado por correo, eliges el espacio de trabajo del que se cobra y un límite de gasto diario, y la autorizas. Zurelay entonces agrega una clave con el nombre de la app, como «Claude (MCP)», a tu página de Claves, con ese límite. La app nunca ve una clave de API: tiene un token que dura una hora y un token de actualización que cambia cada vez que se usa, y ambos funcionan solo en el servidor MCP, nunca en el resto de la API. Cambia el límite en la página de Claves, o revoca la clave allí para desconectar la app.

API de Una clave de va en el encabezado Authorization: Bearer zr_live_…. Se aplica todo lo configurado en la clave: sus presupuestos, límite de velocidad, modelos permitidos e IP permitidas. Crea una clave solo para la app, con un presupuesto diario, para que un agente ocupado no pueda gastar más de lo que planeaste (ver Límites y reglas de claves). Apps como Claude y ChatGPT llaman desde sus propios servidores, así que deja vacías las IP permitidas en una clave destinada a ellas.

Precios, enlaces y esperas

• Los mismos precios que la API: consulta cada modelo en la página de modelos, o pídele a la IA que llame a list_models. No se cobra nada por una solicitud que falla, y un video se cobra solo una vez que está listo.
• Una herramienta responde en unos 35 segundos. Las imágenes y el audio suelen estar listos para entonces; lo más lento (la mayoría de los vídeos) vuelve con un id y la IA llama a get_result, que espera hasta 45 segundos más cada vez.
• Los resultados son enlaces a nuestro almacenamiento, válidos durante 24 horas. Las imágenes y los vídeos permanecen en tu Biblioteca durante 30 días, y cada solicitud aparece en tu página de Solicitudes como cualquier otra.
• Las imágenes también vuelven como una pequeña vista previa, para que la IA pueda ver lo que ha creado y ajustarlo. Pídele que omita las vistas previas para ahorrar contexto.

Archivos de tu ordenador

Para editar una imagen o animar un fotograma, el modelo necesita el archivo en un enlace. Los archivos que ya están en línea se pueden pasar como sus enlaces https. Para archivos de tu ordenador, las apps que pueden ejecutar comandos (Claude Code, Cursor, Codex) usan create_upload_link: un PNG, JPEG, WebP, MP4, MOV, MP3 o WAV de hasta 20 MB, subido en los últimos 15 minutos. El enlace que devuelve funciona durante 2 horas y el archivo se elimina a los 2 días. Los enlaces de subida necesitan saldo en la cuenta.

# 1. The agent calls create_upload_link and gets a one-time URL.
# 2. It uploads the file with curl:
curl -sS -T ./product-photo.png 'https://api.zurelay.com/mcp/uploads/…'
# {"url":"https://…/inputs/2026-10-05/….png","type":"image/png","bytes":482113,…}
# 3. It passes that url to generate_image's reference_images or generate_video's first_frame.

Seguridad

• El inicio de sesión sigue la especificación MCP: OAuth 2.1 con PKCE (solo S256), únicamente direcciones de redirección registradas y códigos de un solo uso que duran 5 minutos. Un código usado dos veces termina aquello por lo que se canjeó.
• Los tokens son aleatorios y se guardan solo como hashes SHA-256. Los tokens de acceso duran una hora y funcionan únicamente en el servidor MCP. Los tokens de actualización cambian en cada uso; uno reutilizado más de un minuto después fue copiado, así que la conexión se cierra y su clave se revoca.
• Cada conexión es una clave en tu página de Claves con su propio límite diario, visible para los miembros de tu espacio de trabajo. Revocarla, o salir del espacio de trabajo, desconecta la app.
• La página de consentimiento no se puede mostrar dentro de otro sitio, y te avisa cuando una app no es una que Zurelay reconozca y adónde te devolverá.
• Los enlaces de subida están firmados, aceptan un solo archivo y caducan en 15 minutos; los archivos subidos se eliminan a los 2 días.
• Cada clave y cada espacio de trabajo tiene su propio límite de velocidad para las llamadas MCP, y cada llamada de un lote cuenta.

Para desarrolladores

El servidor habla MCP 2025-11-25 (y 2025-06-18, 2025-03-26 y 2024-11-05) sobre Streamable HTTP: envía JSON-RPC por POST a https://api.zurelay.com/mcp y recibe JSON. No mantiene sesiones, así que no hay eventos enviados por el servidor y GET responde 405. Sin token, responde 401 con WWW-Authenticate apuntando a https://api.zurelay.com/.well-known/oauth-protected-resource/mcp; los metadatos del servidor de autorización están en https://api.zurelay.com/.well-known/oauth-authorization-server, con registro dinámico de clientes.

curl https://api.zurelay.com/mcp \
  -H "Authorization: Bearer $ZURELAY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "generate_image",
      "arguments": { "prompt": "A lighthouse at dusk, oil painting", "model": "nano-banana-pro" }
    }
  }'

Solución de problemas

• zurelay no aparece en la lista de /mcp de Claude Code: se añadió para otra carpeta, o Claude Code ya estaba en ejecución. Cierra Claude Code, ejecuta el comando de arriba (con --scope user) en una terminal normal y vuelve a iniciar Claude Code. claude mcp list lo muestra como pendiente de autenticación hasta que inicies sesión.
• La app no deja de pedir que inicies sesión: la clave que creó se revocó, o su inicio de sesión no se usó en un año. Vuelve a conectarla.
• «El saldo de tu Zurelay está vacío» o «se alcanzó su presupuesto diario»: añade saldo en la página de Facturación, o sube el límite de la clave en la página de Claves.
• «Este token pertenece a una app conectada a través del servidor MCP de Zurelay»: enviaste el token de una app a la API. Usa ahí una clave de API.
• Un vídeo parece atascado: pídele a la IA que vuelva a llamar a get_result; los vídeos tardan de 1 a 5 minutos, a veces más cuando un modelo está ocupado.