Agentes (MCP)

OIM ofrece un servidor remoto de Model Context Protocol para que un agente de IA (Claude, o cualquier cliente MCP) cree proyectos, componga capas y exporte archivos .oim firmados en tu cuenta.

Beta cerrada

El conector funciona en cuentas con acceso a OIM-Studio, que de momento es solo por invitación. Todo lo que hace el agente queda en los proyectos y medios de tu cuenta, y cuenta para tus cuotas igual que el trabajo hecho a mano.

Conectar


Endpoint	`https://mcp.oim.media/mcp`
Transporte	HTTP transmitible (respuestas JSON, sin estado)
Autenticación	Token bearer OAuth 2.1 emitido por el inicio de sesión de OIM
Descubrimiento	`https://mcp.oim.media/.well-known/oauth-protected-resource`

Añade https://mcp.oim.media/mcp como conector personalizado en tu cliente MCP. La primera llamada responde 401 con una cabecera WWW-Authenticate que apunta al documento de descubrimiento; el cliente abre entonces el inicio de sesión de OIM y guarda el token. No hay clave de API que copiar.

Herramientas

Grupo	Herramientas	Qué hacen
Proyectos y páginas	`oim_create_project`, `oim_add_page`, `oim_add_pages`, `oim_list_pages`, `oim_select_page`, `oim_rename_page`, `oim_set_languages`	Crear un proyecto, añadir y elegir páginas, declarar los idiomas de su texto
Lienzo	`oim_set_canvas_size`, `oim_set_canvas_background`, `oim_set_canvas_texture`, `oim_apply_theme`, `oim_clear_canvas`	Tamaño, fondo, textura y tema de color de una página
Capas	`oim_create_shape`, `oim_create_artistic_text`, `oim_create_card`, `oim_create_mask`, `oim_update_shape`, `oim_batch_design`, `oim_auto_layout`, `oim_ungroup_layers`, `oim_convert_group_to_component`	Añadir y editar formas, texto, marcos, máscaras y grupos; `oim_batch_design` aplica muchos cambios en una llamada
Imágenes	`oim_upload_media`, `oim_crop_layer`, `oim_apply_filter`	Subir una imagen a tus medios, encuadrarla y aplicarle filtros
Movimiento	`oim_set_animation`, `oim_configure_scene_loop`	Keyframes, presets y escenas de parallax en bucle
Lectura	`oim_get_canvas_summary`, `oim_inspect_layers`, `oim_search_elements`, `oim_design_guide`	Qué hay en el lienzo y la guía de diseño que debe seguir el agente
Salida	`oim_preview`, `oim_export`, `oim_export_status`, `oim_export_to_blog`	Previsualizar, exportar un `.oim` firmado (o una imagen) y publicar en el blog de OIM

Toda herramienta que edita un lienzo acepta un page_id opcional (de oim_list_pages); sin él, se usa la página activa.

Ejemplo

Una petición para crear una capa de texto:

json

{
  "name": "oim_create_artistic_text",
  "arguments": {
    "project_id": "6f1c2a4e-8b3d-4c9a-9e21-3d5b7a0c1f42",
    "text": "Siempre sin conexión",
    "content": { "es": "Siempre sin conexión", "en": "Always offline" },
    "x": 80, "y": 120, "fontSize": 64,
    "fontFamily": "Pixelify Sans",
    "artisticPreset": "custom"
  }
}

Cómo funciona la exportación

El agente no firma archivos. oim_export pide a tu pestaña abierta de OIM-Studio que exporte la página, y esta la empaqueta con el mismo servicio de firma que una exportación manual. Mantén studio.oim.media abierto y actualizado mientras el agente exporta; oim_export_status sigue una exportación que tarda más que la llamada.

Seguridad

Tu sesión, tus datos. El token es tu sesión de OIM. El agente solo lee y escribe lo que tu cuenta puede: la seguridad a nivel de fila se aplica a cada consulta, igual que en el editor.
Revocable. Al revocar la app desde tu cuenta termina la sesión; la siguiente llamada responde 401.
Sin secretos en el agente. El conector no guarda claves de firma ni credenciales de servicio en tu nombre; la firma la hace el servicio de firma cuando tu editor exporta.
Publicar en el blog está restringido. oim_export_to_blog solo sube para administradores y moderadores.

Límites

Límite	Valor
Peticiones	60 por minuto por cuenta (`429 rate_limited` por encima)
Exportación en línea	Los archivos de hasta 5 MB vuelven en la respuesta; los mayores se quedan en tus medios de OIM-Studio
Cuotas	El almacenamiento y las firmas cuentan para tu plan, igual que en el editor
Coste de IA	La generación ocurre en tu agente y la paga su proveedor; OIM no añade cargos de IA

Errores

Estado	Significado
`401 unauthorized`	Token ausente, caducado o revocado: vuelve a iniciar sesión desde tu cliente
`429 rate_limited`	Demasiadas peticiones: espera un minuto
`503`	OIM no pudo verificar la sesión (es cosa nuestra); reintenta más tarde

Agentes (MCP) ​

Conectar ​

Herramientas ​

Ejemplo ​

Cómo funciona la exportación ​

Seguridad ​

Límites ​

Errores ​