Conectar con MCP

Aether ofrece un servidor remoto de Model Context Protocol (MCP). Los asistentes de IA compatibles con MCP, como Claude, Claude Code, Cursor, Antigravity, Codex y ChatGPT, pueden usarlo para generar imágenes, efectos y sprites y para ajustar imágenes con tu cuenta de Aether.

URL del servidor

https://api.aetherforgeai.com/mcp

El servidor usa el transporte Streamable HTTP.

Conectar con tu cuenta de Aether (recomendado)

Agrega la URL del servidor a tu cliente. La primera vez que el cliente se conecta, tu navegador abre la página de conexión de Aether.

1. Inicia sesión en Aether si aún no lo has hecho. Volverás a la página de conexión automáticamente.
2. Revisa el nombre del cliente y la dirección a la que volverás.
3. Selecciona Conectar.

Después, el cliente recibe su propio token de acceso. Los tokens de acceso caducan después de una hora y el cliente los renueva automáticamente.

Elige tu cliente:

Claude Code

claude mcp add --transport http aether https://api.aetherforgeai.com/mcp

Luego ejecuta /mcp en Claude Code y elige aether para iniciar sesión.

Claude

En Claude (web y escritorio), abre Configuración → Conectores → Agregar conector personalizado, introduce la URL del servidor y selecciona Agregar. Después selecciona Conectar para iniciar sesión. Claude no puede subir archivos desde el chat, así que pasa el job_id de un resultado anterior a las entradas de imagen.

Cursor

Agrega el servidor a mcp.json (Configuración → MCP). Cuando el servidor muestre Needs login, selecciónalo para iniciar sesión en el navegador.

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

Antigravity

Registra el servidor en la CLI de Antigravity e inicia una sesión. El inicio de sesión se abre en el navegador la primera vez que se usa el servidor. Si el navegador no puede volver a la CLI, pega la URL final de la barra de direcciones cuando la CLI la pida.

agy mcp add aether https://api.aetherforgeai.com/mcp
agy

Codex

Registra el servidor e inicia sesión. El inicio de sesión se abre en el navegador.

codex mcp add aether --url https://api.aetherforgeai.com/mcp
codex mcp login aether

ChatGPT

En ChatGPT, abre Configuración → Conectores → Avanzado → Modo desarrollador y selecciona Crear. Introduce un nombre y la URL del servidor, elige OAuth como autenticación y luego selecciona Crear y Conectar para iniciar sesión. ChatGPT no puede subir archivos desde el chat, así que pasa el job_id de un resultado anterior a las entradas de imagen.

Conectar con una clave de API

Los clientes que pueden enviar encabezados personalizados pueden usar una clave de API en lugar de iniciar sesión. Los conectores de Claude y ChatGPT solo admiten el inicio de sesión con cuenta.

Authorization: Bearer <api_key>

Claude Code

claude mcp add --transport http aether https://api.aetherforgeai.com/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

Cursor

Agrega una entrada headers al servidor en mcp.json.

{
  "mcpServers": {
    "aether": {
      "url": "https://api.aetherforgeai.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Antigravity

agy mcp add --header "Authorization: Bearer YOUR_API_KEY" aether https://api.aetherforgeai.com/mcp

Codex

Codex lee la clave de una variable de entorno.

export AETHER_API_KEY=YOUR_API_KEY
codex mcp add aether --url https://api.aetherforgeai.com/mcp --bearer-token-env-var AETHER_API_KEY

Herramientas

Cada herramienta usa las mismas opciones y el mismo costo en créditos que la página correspondiente de la aplicación web.

Herramienta	Función web	Costo en créditos
create_image_upload	Subir una imagen para otras herramientas	Gratis
get_job_status	Estado del trabajo y URL de resultados	Gratis
get_credit	Saldo de créditos	Gratis
list_my_ai_models	Modelos disponibles para la generación de Aether	Gratis
list_my_results	Historial (tool, sprite, aether)	Gratis
generate_image	Generar imagen	1 (GPT Image 2), 2 (GPT Image 2.5 High, Nano Banana Pro), 3 (GPT Image 2.5 XHigh)
generate_effect_v1	Generar efectos, pestaña V1	5 (1K), 7 (2K), 10 (4K)
generate_effect_v2	Generar efectos, pestaña V2	3
upscale	Escalar	5 (1K), 7 (2K), 10 (4K)
inpaint_v1	Inpaint, pestaña V1	5
inpaint_v2	Inpaint, pestaña V2	3
remove_background	Quitar fondo	1
equip_variation	Variación de equipo	5
sprite_lite	Sprite Lite	De 5 a 13 según los fotogramas
sprite_plus	Sprite Plus	9 (49 fotogramas), 13 (81 fotogramas)
sprite_zenith	Sprite Zenith	9 (36 fotogramas), 25 (100 fotogramas)
sprite_pulsar	Sprite Pulsar	3, o 4 para Sprite To Sprite
aether_generate	Aether	Gratis con los modelos incluidos; los demás, 2. list_my_ai_models muestra credit_cost por modelo

Los nombres de campo y los valores permitidos son los mismos que en las páginas de endpoints correspondientes.

Resultados

Las herramientas de generación inician un trabajo asíncrono y devuelven un job_id de inmediato. Llama a get_job_status con ese job_id para obtener el resultado. Define wait_seconds (hasta 60) para esperar el trabajo antes de que la herramienta responda. Cuando status es Succeed, image_urls contiene la imagen resultante y, en los sprites, también el GIF. Consulta Ciclo de vida de trabajos asíncronos para ver los valores de estado.

generate_image también crea una sala de chat en la página Historial de la web, listada en la pestaña API/MCP. El chat_room_id del resultado la identifica, y puedes seguir generando en esa sala desde la web.

Imágenes de entrada

Los campos de imagen aceptan una de estas opciones:

• Un upload_id de create_image_upload. Llama a la herramienta con el Content-Type de la imagen, sube el archivo a la upload_url devuelta con una petición HTTP PUT en menos de 5 minutos y luego pasa el upload_id.
• El job_id de uno de tus trabajos terminados, para reutilizar su imagen resultante. Así puedes encadenar herramientas, por ejemplo upscale y después remove_background.

curl -X PUT -H "Content-Type: image/png" --data-binary @character.png "<upload_url>"

Subir archivos requiere un cliente que pueda ejecutar comandos o enviar solicitudes HTTP, como Claude Code, Cursor, Antigravity o Codex. En aplicaciones de chat que no pueden subir archivos, reutiliza un job_id terminado.

Errores

Si una llamada a una herramienta falla, devuelve un mensaje de error en lugar de un resultado. Si no tienes créditos suficientes, el mensaje incluye un enlace a la página de precios.