dimo imagine

npx add-mcp 'https://dimosoftwares.ir/imagine/mcp'

Configuración

Hay dos formas de conectarse. Si tu cliente admite «Iniciar sesión», la primera opción es más sencilla y segura.

1. Inicio de sesión (OAuth)

Para claude.ai, Claude Desktop, la aplicación móvil de Claude, Cursor, VS Code y Claude Code. Solo ingresa la dirección del servidor; se abrirá la página de inicio de sesión de dimo imagine y, después de hacer clic en «Permitir», la conexión estará establecida. No se necesita token.

2. Token personal

Para clientes que solo aceptan encabezados (Hermes, scripts, curl) o cuando no quieres que se abra el navegador. Crea el token en la siguiente sección y envíalo en el encabezado Authorization.

1. Agrega la dirección del servidor en tu cliente.
   El tipo de conexión es HTTP (Streamable HTTP). En la sección «Configuración de clientes» encontrarás ejemplos para cada cliente.
2. Inicia sesión o ingresa el token.
   Con OAuth, presiona el botón Connect/Authenticate del cliente. Con token, colócalo en el encabezado.
3. Prueba la conexión.
   Pídele al asistente que ejecute check_account_status; debería mostrar tu consumo y el límite de tu clave.

Tu token personal

Solo es necesario para conectarse con token (segunda opción). El token es como una contraseña: no lo coloques en código ni en repositorios públicos, e ingrésalo únicamente en la configuración del cliente MCP.

Para crear un token personal, inicia sesión en tu cuenta.

Configuración de clientes

En los ejemplos con token, reemplaza DIMO_MCP_TOKEN con tu token (si ya creaste uno, se habrá reemplazado automáticamente). Para conectarte con inicio de sesión, elimina la sección headers.

No se necesita token. En claude.ai ve a Settings → Connectors → Add custom connector, ingresa la siguiente dirección y haz clic en «Connect» después de «Add». Se abrirá la página de inicio de sesión de dimo imagine; haz clic en «Permitir».

https://dimosoftwares.ir/imagine/mcp

Deja vacía la sección «Advanced settings» (Client ID / Secret). Claude Desktop y la aplicación móvil también usan este mismo conector.

Autenticación

Cada solicitud HTTP debe incluir el token en el encabezado. El token no se acepta en la URL (query string), porque las URLs quedan registradas en los registros. Los clientes que admiten inicio de sesión encuentran automáticamente la ruta OAuth desde el encabezado de la respuesta 401.

Authorization: Bearer dimo_mcp_…     # توکن شخصی
Authorization: Bearer dimo_oat_…     # صادرشده با OAuth (claude.ai، Cursor)

# یا به‌جای آن:
X-Dimo-Key: dimo_mcp_…

401 No autorizado

El token no se envió, expiró o fue invalidado. La respuesta incluye el encabezado WWW-Authenticate para que los clientes inicien automáticamente el inicio de sesión OAuth.

Acceso no activo

Si el acceso de IA de la cuenta no está activo, la conexión se establece, pero las herramientas de generación de mensajes devuelven un error con instrucciones.

Tokens OAuth

El token de acceso tiene una validez de una hora y el cliente lo renueva automáticamente; si no se usa durante 60 días, deberás iniciar sesión nuevamente. Con el botón «Desconectar todas las aplicaciones», todas estas conexiones se invalidan de inmediato.

Agentes de dimo imagine

Cada agente tiene su propio token (dimo_mcpa_…) y no depende de tu token personal. Desactivar imagine o eliminar el agente corta su acceso.

Cambio de token

Con «Crear nuevo token», el token anterior deja de funcionar de inmediato; actualiza tus clientes.

Mantenimiento

dimo imagine solo almacena el hash de los tokens; por eso no es posible volver a mostrar el token personal.

Herramientas

El cliente obtiene automáticamente la lista de herramientas. Obtén los identificadores de los modelos con list_models; modality es uno de image, video, speech (voz) o audio (música). Las herramientas de catálogo y estado de cuenta son de solo lectura y no tienen costo.

generate_imageImagen

Genera de 1 a 4 imágenes. Devuelve una vista previa de la imagen y el enlace del archivo guardado en el almacenamiento.

model, prompt, n, aspect_ratio, resolution, output_format, quality, background, seed, reference_urls, include_preview, include_base64

submit_videoVídeo

Registra un trabajo de generación de video. Devuelve el identificador del trabajo (job_id).

model, prompt, duration, resolution, aspect_ratio, size, generate_audio, seed, frame_image_urls, reference_urls

poll_videoVídeo

Consulta (y si es necesario espera por) el trabajo de video; cuando esté listo, el archivo se guarda automáticamente y se devuelve su enlace.

job_id, wait_seconds, include_base64

download_videoVídeo

Guardado manual del video listo (para compatibilidad con clientes antiguos).

job_id | url, include_base64

generate_speechVoz

Convierte texto a voz; el archivo de audio se guarda y se devuelve su enlace.

model, text, voice (voz del propio modelo), response_format (mp3/wav), instructions

generate_musicVoz

Crea música a partir de una descripción textual; el archivo se guarda y se devuelve su enlace.

model, prompt, instrumental, lyrics, seed

list_modelsCatálogo

Lista los modelos de un tipo de salida: image, video, speech o audio.

modality, force_refresh

find_modelCatálogo

Detalles de un modelo específico.

modality, model_id

full_catalogueCatálogo

Catálogo completo de todos los modelos.

force_refresh

check_account_statusCuenta

Consumo y límite restante de tu clave.

—

Ejemplos de solicitudes

No es necesario que conozcas los nombres de las herramientas; basta con pedirlo en lenguaje natural. El asistente encontrará el modelo adecuado por sí mismo.

Imagen

«Crea con imagine un póster minimalista 9:16 de una taza de café bajo la lluvia.»

Varias opciones

«Crea tres versiones diferentes del logotipo de una panadería con fondo transparente.»

Vídeo

«Crea un video de 5 segundos de olas del mar al atardecer y dame el enlace cuando esté listo.»

Voz

«Convierte este texto a un archivo de audio con la voz nova y un tono tranquilo: …»

Música

«Crea una pieza lo-fi relajante de 30 segundos para el fondo de un video.»

Modelos

«¿Qué modelos de imagen de imagine admiten fondo transparente?»

Notas

Costo

Todas las generaciones se calculan sobre la clave de tu cuenta; el mismo límite que tienes en el estudio.

Salida

Todos los archivos se guardan en la carpeta «Salidas de imagine» de tu almacenamiento y también se ven en la galería de imagine. El cliente recibe un enlace de visualización y descarga, y para las imágenes una vista previa. Para recibir el archivo en formato base64, envía include_base64=true.

Vídeo

Es asíncrono: submit_video y luego poll_video con wait_seconds hasta que esté listo; el archivo final se guarda automáticamente.

Imágenes de referencia

reference_urls debe ser una URL pública https o una data URL.

Agentes

La salida de los agentes, además del almacenamiento, también se coloca en el disco del propio agente para que pueda usarla en pasos posteriores o en Telegram.

Tiempo de respuesta

La imagen suele tardar desde unos segundos hasta un minuto; el video, desde unos 30 segundos hasta varios minutos.

Solución de problemas

claude.ai no se conecta

Ingresa la dirección exactamente como arriba, sin / al final, y deja vacía la sección Advanced settings. Si después de «Permitir» no vuelves a claude.ai, presiona el botón «Volver a la aplicación».

401 con token

El token fue invalidado o cambiado, o falta el prefijo Bearer . Crea un token nuevo y reemplázalo en el cliente.

«Acceso no activo»

Contacta con soporte para activar el acceso de IA de la cuenta; no es necesario volver a conectarse.

Crédito insuficiente

El error 402 significa que el crédito de IA de la cuenta se agotó. Consulta el límite restante con check_account_status.

Interrupción en trabajos largos

El tiempo de espera predeterminado de algunos clientes es corto. Para video, usa poll_video con un wait_seconds menor para que cada llamada sea breve.

No se ven las herramientas

Después de cambiar la configuración, reinicia el cliente o haz clic en Refresh en la lista de servidores MCP.