Mage

npx add-mcp 'https://mcp.mage.space/mcp'

Usar Mage desde Claude, ChatGPT, Grok y Cursor

Conecta Claude, ChatGPT, Claude Code, Grok o Cursor a tu cuenta de Mage a través del servidor MCP de Mage y luego pide a tu asistente que genere imágenes, video y audio, pagados en Gems.

El servidor MCP de Mage conecta asistentes de IA a tu cuenta de Mage. Una vez conectado, puedes pedir a Claude, ChatGPT, Claude Code, Grok o Cursor que elija un modelo, cotice el precio, genere una imagen, un video o un clip de audio, y te devuelva el resultado. También lee tu historial de generaciones y tus creaciones guardadas, y usa tus personajes y referencias guardados.

https://mcp.mage.space/mcp

[!WARNING]

Cada generación que inicia tu asistente se paga en Gems desde tu cuenta. Tu asistente puede consultar el precio primero, y puedes desconectarlo en cualquier momento.

Conectar tu asistente

Claude

Funciona en Claude en la web, la app de escritorio, las apps móviles y Cowork.

1. Abre Conectar Mage a Claude. El nombre del conector y la URL ya están rellenados. Selecciona Add.
2. Selecciona Connect. Se abre una página de Mage que te pide iniciar sesión si aún no lo has hecho.
3. Comprueba que la página nombra la app que estás conectando y luego selecciona Connect. Vuelves a Claude.
4. En un chat, activa el conector de Mage desde el menú + en Connectors y pide lo que quieras crear.

En un plan Team o Enterprise, un propietario primero añade el conector en Organization settings → Connectors. El plan Free permite un conector personalizado.

ChatGPT

Añade Mage como plugin personal desde la página Plugins de ChatGPT.

1. Abre ChatGPT Plugins.
2. Haz clic en Add y luego elige Create MCP App.
3. Introduce Mage en Name, https://mcp.mage.space/mcp en Server URL y selecciona OAuth en Authentication. Deja Advanced OAuth settings en blanco; no se necesita client ID ni client secret. El icono y la descripción son opcionales.
4. Revisa el aviso, marca I understand and want to continue y luego haz clic en Create.
5. Inicia sesión en Mage en la página que se abre, comprueba el nombre de la app y selecciona Connect.
6. Instala Mage desde tus plugins Personal, inicia un chat Work y menciona @Mage.

[!NOTE]

Si falta Create MCP App, activa el Developer mode en Settings → Security and login de ChatGPT y luego vuelve a Plugins. Consulta la guía de configuración de ChatGPT para más detalles.

Claude Code

Añade el servidor y luego inicia sesión desde Claude Code:

claude mcp add --transport http mage https://mcp.mage.space/mcp

Ejecuta /mcp en Claude Code, elige mage y autentícate. Se abre una página en el navegador para que inicies sesión en Mage y selecciones Connect.

Para usar una API key en lugar de iniciar sesión:

claude mcp add --transport http mage https://mcp.mage.space/mcp \
  --header "Authorization: Bearer $MAGE_API_KEY"

Grok

Añade Mage como conector MCP personalizado.

1. Abre conectores de Grok, selecciona New Connector y luego elige Custom.
2. Introduce https://mcp.mage.space/mcp y completa las solicitudes de autenticación para conectar tu cuenta de Mage.
3. Inicia una conversación y pide a Grok que use Mage para crear una imagen, un video o audio.

En Grok Business o Enterprise, un administrador del equipo primero debe aprovisionar el conector en la consola en la nube.

Cursor

El botón instala Mage con su client ID público de OAuth; inicia sesión en Mage cuando se te solicite. Si Mage ya está instalado, reemplaza su configuración existente por la de este enlace. Si el botón no hace nada, abre el enlace de instalación web en su lugar: abre Cursor desde el navegador y muestra la misma configuración para añadirla manualmente.

Para la configuración manual, añade esta entrada a ~/.cursor/mcp.json:

{
  "mcpServers": {
    "mage": {
      "url": "https://mcp.mage.space/mcp",
      "auth": {
        "CLIENT_ID": "https://cursor.com/mcp",
        "scopes": [
          "mage",
          "offline_access"
        ]
      }
    }
  }
}

El client ID es público y no necesita client secret. Cursor usa la configuración estática de OAuth para abrir la página de consentimiento de Mage.

También puedes conectar con una API key:

{
  "mcpServers": {
    "mage": {
      "url": "https://mcp.mage.space/mcp",
      "headers": { "Authorization": "Bearer ${env:MAGE_API_KEY}" }
    }
  }
}

Cuando una app se conecta iniciando sesión, Mage muestra quién lo solicita antes de compartir nada: el nombre de la app, el sitio del que proviene y a dónde vuelves después. Una sesión de invitado no puede conectar una app; inicia sesión con tu cuenta de Mage primero.

Qué puede hacer tu asistente

Herramienta	Qué hace
list_models	Enumera los modelos recomendados con sus precios, para qué es mejor cada uno y sus ventajas y desventajas; el resto, a petición.
get_model	Describe un modelo: sus campos, valores permitidos, valores predeterminados, reglas y precio.
estimate_cost	Cotiza una generación antes de que empiece. No se cobra nada.
create_upload	Obtiene un enlace firmado para subir un archivo desde tu computadora, para asistentes que pueden ejecutar comandos.
generate	Inicia una generación, pagada en Gems.
get_request	Espera a que termine una generación y devuelve el enlace del resultado.
cancel_request	Detiene una generación en curso. Los Gems no se reembolsan.
get_account	Muestra la cuenta conectada y su saldo de Gems.
list_characters	Enumera tus personajes y sus @handle.
create_character	Guarda un personaje privado a partir de un enlace de imagen, opcionalmente con un clip de voz.
delete_character	Elimina uno de tus personajes.
list_references	Enumera tus outfits, poses, ubicaciones, objetos y clips de voz, todos o de un solo tipo.
create_reference	Guarda una referencia privada a partir de un enlace de imagen o audio.
delete_reference	Elimina una de tus referencias.
list_history	Enumera tus generaciones de los últimos 30 días, incluidas las que hiciste tú mismo en Mage.
search_creations	Busca en las creaciones que guardaste, por lo que muestran, por colección o por fecha.

Menciona un personaje o referencia guardados en una solicitud con su handle, por ejemplo "Haz un retrato de @ana con @red-coat", y tu asistente lo pasa al modelo.

Skills

Las skills de Mage enseñan a tu asistente trabajos completos sobre estas herramientas: sesiones de fotos de producto, listados de marketplace, variaciones de anuncios, videos UGC y sin rostro, miniaturas de YouTube y las apps de Mage, desde face swaps y relighting hasta ediciones de video y lip sync. Añádelas con npx skills add mage-space/skills, o explóralas con ejemplos en mage.space/skills.

Qué modelo usa tu asistente

A menos que nombres un modelo, tu asistente crea imágenes con Mango 3, video con Cherry 2 Pro y audio con Seed Audio. Te indica el modelo y el precio antes de empezar, y después de un resultado puede sugerir una alternativa cuando su ventaja encaja con lo que estás haciendo.

	Imágenes	Video
Predeterminado	Mango 3	Cherry 2 Pro
Misma familia	Mango 3S (más barato, hasta 3K), Mango 2 (hasta 4K), Mango	Cherry Pro (4K), Cherry, Cherry Mini (el Cherry más barato)
También recomendados	Guava 2 Pro y Guava 2 (fotorrealista), GPT Image 2.5 Flare (texto y ediciones precisas)	Lemon (primer y último fotograma, clips de hasta 30 segundos)

Todos los demás modelos se ejecutan solo cuando los pides por su nombre, por ejemplo "hazlo con Melon" o "usa Nano Banana 2". Tu asistente puede sugerir uno cuando se adapte mejor a una solicitud, como un modelo de anime para un clip de anime, y espera tu respuesta. ¿Qué modelo debería usar? los compara todos.

Cherry 2 Pro es el modelo de video más capaz y más caro de Mage, y su precio sube pronunciadamente con la resolución y la duración. Pide Cherry Mini o Lemon mientras estás haciendo borradores.

Cómo funcionan las generaciones

1. Tu asistente elige un modelo con list_models, como se indicó antes, y lee sus campos con get_model.
2. Comprueba el precio con estimate_cost, que también detecta una solicitud que el modelo rechazaría. El precio de un video depende de su duración: Mage mide un video que ya está en Mage, como un archivo subido o un resultado anterior, cuando cotiza el precio, y un video enlazado desde otro sitio solo cuando empieza la generación.
3. Inicia la generación con generate, que cobra tus Gems. Cada generación lleva una clave que tu asistente inventa, de modo que un reintento tras una conexión interrumpida devuelve la misma generación en lugar de pagar dos veces.
4. Espera con get_request hasta que el resultado esté listo y te da el enlace.

Los resultados permanecen disponibles durante 30 días: descarga lo que quieras conservar o guárdalo en Mage. Un resultado marcado por la moderación como NSFW se señala como tal. Consulta Requests para conocer los estados por los que pasa una generación y Billing para saber cómo se cobran los Gems.

Imágenes y archivos

Las entradas de medios, como un primer fotograma, una imagen de referencia o un video para editar, son enlaces: un enlace público de https al archivo en sí, o una data URL de hasta unos 3 MB.

• Claude Code, Cursor y otros asistentes que ejecutan comandos pueden subir un archivo desde tu computadora: obtienen un enlace de subida firmado con create_upload, envían el archivo allí y usan el nuevo enlace del archivo como cualquier otro. Un archivo puede pesar hasta 100 MB y se elimina después de 30 días. Cada subida contiene un archivo: un archivo corregido se sube como una nueva subida, ya que el enlace antiguo puede seguir mostrando el primer archivo durante hasta 4 horas.
• Los chats de Claude, ChatGPT y Grok no pueden pasar a Mage un archivo que adjuntes al chat. Comparte un enlace directo al archivo en su lugar, o usa una creación que ya esté en Mage.
• Un enlace a una página web, como un video de YouTube o TikTok, no es un archivo y se rechaza.

Gestionar apps conectadas

Cada app que conectaste aparece en MCP → Connected apps, con cuándo la conectaste y cuándo se usó por última vez. Selecciona Disconnect para detener una app de inmediato; ya no podrá usar tu cuenta ni gastar tus Gems hasta que la vuelvas a conectar. Abre MCP en la navegación flotante y luego selecciona Connected apps.

Límites

• Se pueden ejecutar hasta 20 generaciones a la vez para tu cuenta, igual que con la API.
• Una app puede hacer hasta 120 llamadas a herramientas por minuto.
• get_request espera hasta 2 minutos por llamada; tu asistente la vuelve a llamar para generaciones más largas.

Solución de problemas

• Cursor dice "Incompatible auth server: does not support dynamic client registration": actualiza la entrada existente de Mage en ~/.cursor/mcp.json para incluir el bloque auth de la configuración de Cursor anterior, y luego vuelve a conectar. Una URL de servidor por sí sola no incluye el client ID de Cursor preregistrado de Mage.

• "Couldn't reach the MCP server": comprueba que la URL sea exactamente https://mcp.mage.space/mcp, luego elimina el conector y añádelo de nuevo.

• La conexión te pide iniciar sesión de nuevo: la conexión dura hasta 180 días, tras lo cual la app te pide que la apruebes de nuevo. Desconectarla en Mage también la finaliza.

• Una generación falló con insufficient_gems: añade Gems en API → Billing y vuelve a intentarlo.

Esta documentación está creada y alojada en Mintlify, una plataforma de documentación para desarrolladores.