Logo de X Image SplitterX Image Splitter
Logo de X Image SplitterX Image Splitter

Desarrolladores

Model Context Protocol (MCP)

Conecta agentes de IA y aplicaciones cliente a %APP_NAME% mediante Model Context Protocol.

X Image Splitter proporciona un servidor remoto de Model Context Protocol (MCP) sobre Streamable HTTP, que expone capacidades idénticas a las de la API REST. Los agentes de IA conectados pueden consultar saldos de créditos, estimar e iniciar generaciones con Seedream 5.5, mejorar prompts, buscar creaciones, pasar imágenes al divisor y enviar Support Requests.

Endpoint de conexión

Configura tu cliente MCP con el endpoint del servidor:

https://ximagesplitter.com/mcp

Al conectar una cuenta se inicia la autorización OAuth. Revisa los Scopes solicitados y confirma la conexión. Una vez autorizado, el cliente queda registrado en Cuenta › Connected Apps, donde su acceso puede revocarse en cualquier momento.

Las operaciones públicas de lectura (como modelos y precios) están disponibles sin autenticación.

Autenticación y seguridad

  • Protocolo: Los endpoints MCP requieren autenticación OAuth 2.1 de forma exclusiva. Las API Keys se rechazan en /mcp.
  • Indicador de recurso: Los tokens de acceso deben solicitarse para el recurso https://ximagesplitter.com/mcp. Los metadatos están publicados en https://ximagesplitter.com/.well-known/oauth-protected-resource/mcp.
  • Validación de Scopes: Invocar una acción sin el Scope requerido devuelve un error insufficient_scope indicando el Scope ausente.
  • Revocación: Desconectar una Connected App en los ajustes de cuenta revoca la validez del token inmediatamente.

Herramientas disponibles

El servidor expone definiciones de herramientas estándar a través de tools/list:

DominioHerramientas
Productoget_product_profile, list_available_models, get_model_capabilities, estimate_generation_cost, get_pricing
Cuentaget_account_profile, update_account_profile
Créditosget_credit_balance, get_credit_history
Generacióncreate_generation, get_generation_status, list_generation_jobs, improve_prompt
Creacioneslist_creations, get_creation, update_creation_sharing, delete_creation
Subidascreate_upload_target, get_upload_status
Facturaciónlist_orders, get_order, create_checkout, get_subscription, change_subscription, cancel_subscription
Soportecreate_support_request, submit_refund_request, get_refund_status, submit_feedback

Cada herramienta corresponde a una Integration Action de la API REST. La administración de Webhook Endpoints no está expuesta vía MCP; debe gestionarse en Cuenta › Webhooks o mediante la API REST.

Modelo de ejecución y traspasos al usuario

  • Cálculo de costes: Los clientes deben invocar estimate_generation_cost antes de create_generation. Los Generation Jobs se ejecutan de forma asíncrona; los clientes consultan get_generation_status o reciben eventos de webhook.
  • Mejora de prompts: improve_prompt cuesta 1 crédito, que solo se cobra cuando se devuelve una sugerencia. Indica el coste al usuario y obtén su conformidad antes de llamarla, y envía una clave de idempotencia para que un reintento se cobre una sola vez.
  • Traspaso al divisor: get_generation_status y get_creation devuelven splitterLinks, uno por cada imagen terminada. Dale el enlace al usuario; lo abre con la sesión iniciada en la misma cuenta y la imagen se divide en su navegador. La división nunca se ejecuta en el servidor y no existe una herramienta para dividir.
  • Operaciones financieras: create_checkout devuelve una URL donde el usuario elige un método de pago y paga él mismo un paquete de créditos. Ya no se venden suscripciones; get_subscription, change_subscription y cancel_subscription solo existen para suscripciones creadas antes, y también devuelven URLs de confirmación. Los agentes no pueden completar un pago.
  • Operaciones destructivas: delete_creation oculta permanentemente una Creación y desactiva su Share Link.

Ejemplos de prompts

¿Cuántos créditos me quedan y cuándo caducan?
Crea una panorámica 16:9 de una costa con faro al atardecer en modo Listo para carrusel de X.
Indícame el precio antes de empezar y luego dame el enlace para dividirla.
Mejora mi prompt "cinco barras de labios en fila" si cuesta 1 crédito.

Especificaciones de protocolo

El servidor implementa la revisión 2026-07-28 del protocolo MCP sobre Streamable HTTP (solo POST, sin estado). Los clientes se registran mediante Client ID Metadata Documents según se detalla en Connected Apps y OAuth. Cada respuesta incluye una cabecera x-request-id para trazabilidad de diagnóstico.