Clip Studio MCP

Clip Studio MCP: añade https://clipstudio.ai/api/mcp a Claude, Cursor, ChatGPT o Grok. Inicia sesión una vez. Los agentes generan con el mismo plan mensual que el sitio web.

GitHub

Servidor MCP alojado

npx add-mcp 'https://clipstudio.ai/api/mcp'

Se instala en Claude Code, Codex, Cursor y más

Documentación

Clip Studio MCP

Servidor Model Context Protocol alojado para Clip Studio. Añade una URL a Claude, Cursor, ChatGPT o cualquier cliente MCP y usa los mismos productos públicos de Clip Studio que ya tiene un humano con sesión iniciada — Video Lab, Topic Shorts, Talking Shorts, Ad Studio, Last Frame, Image Lab, Audio Lab, Story, Ad Lab, biblioteca y herramientas gratuitas — en el mismo plan que el sitio web.

Endpoint: https://clipstudio.ai/api/mcp
Transporte: Streamable HTTP
Marketing: https://clipstudio.ai/mcp
Lista pública de herramientas: https://clipstudio.ai/mcp.md
Repositorio: https://github.com/j-acks0n/clipstudio-mcp
Smithery: https://smithery.ai/servers/clipstudioai/clipstudio

Este repositorio es un listado de conectores (server.json, fragmentos de instalación, ejemplos). El servidor está alojado. No hay nada que clonar y ejecutar.

Inicio rápido

Pega la URL. Deja el ID de cliente OAuth vacío. Inicia sesión cuando el cliente abra Clip Studio y luego aprueba.

Conectores de Claude Desktop / Claude.ai

Personalizar → Conectores → Añadir conector personalizado. Pega:

https://clipstudio.ai/api/mcp

Conecta. Deja el ID de cliente OAuth vacío.

Cursor

Añade un servidor MCP HTTP en ~/.cursor/mcp.json. Cursor ejecuta OAuth en el primer uso.

{
  "mcpServers": {
    "clipstudio": {
      "url": "https://clipstudio.ai/api/mcp"
    }
  }
}

ChatGPT (conector en modo desarrollador)

Activa el modo desarrollador, añade un conector MCP personalizado, pega https://clipstudio.ai/api/mcp y luego completa la aprobación de Clip Studio.

Windsurf

Edita ~/.codeium/windsurf/mcp_config.json (el campo remoto es serverUrl):

{
  "mcpServers": {
    "clipstudio": {
      "serverUrl": "https://clipstudio.ai/api/mcp"
    }
  }
}

Guarda y luego actualiza MCP en Cascade.

VS Code / Copilot

mcp.json de usuario o espacio de trabajo:

{
  "servers": {
    "clipstudio": {
      "type": "http",
      "url": "https://clipstudio.ai/api/mcp"
    }
  }
}

Paleta de comandos → MCP: Open User Configuration, o .vscode/mcp.json en un espacio de trabajo.

Clientes solo stdio

Puente a Streamable HTTP:

npx -y mcp-remote https://clipstudio.ai/api/mcp

Ejemplo de envoltorio:

{
  "mcpServers": {
    "clipstudio": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://clipstudio.ai/api/mcp"]
    }
  }
}

Autenticación

OAuth con un clic en la primera llamada. Las solicitudes no autenticadas — incluidas initialize y tools/list — devuelven HTTP 401 con WWW-Authenticate y metadatos de recurso protegido. El cliente se registra dinámicamente (OAuth 2.1 + PKCE, cliente público). Inicias sesión con la cuenta de Clip Studio y apruebas. Los tokens permanecen en el cliente.

No hay ID de cliente que pegar. Si un humano no puede hacer el trabajo en clipstudio.ai, el agente tampoco puede hacerlo aquí.

Cómo funciona un trabajo de pago

Cotización (quote_*). No genera.
Si la asignación mensual de generación no cubre la cotización, la herramienta devuelve HTTP 402 con campos JSON numéricos (solo nombres — son claves de API, no texto de interfaz):
```
{
  "requiredCredits": 120,
  "availableCredits": 0
}
```
Luego llama a create_checkout_url con un priceId de get_account.offerCheckout. Devuelve una URL de Stripe Checkout y no recopila datos de tarjeta.
Generar (generate_* / start_last_frame / render_storyboard / …). Usa la asignación de generación de este mes.
Consulta la herramienta get_* correspondiente hasta que el trabajo termine.

Envía y consulta. No mantengas la solicitud MCP abierta durante un renderizado completo del proveedor.

Ejemplos de indicaciones

Previsualiza un Topic Short de 15 segundos sobre por qué fracasan la mayoría de las rutinas matutinas, luego cotiza y genera.
Lista los modelos de Video Lab, cotiza un clip de 8 segundos en 16:9 de una zapatilla de correr en una pista mojada, genera y consulta hasta que esté listo.
Continúa mi historia: carga el proyecto más reciente, escribe la siguiente parte y luego renderízala.
Comprueba mi asignación mensual restante de generación. Si una cotización devuelve 402, abre el checkout desde offerCheckout.
Investiga un clip de Ad Studio desde esta URL de producto, elige un creador del catálogo, cotiza, genera y consulta.

Tutoriales: examples/.

Herramientas

Los nombres coinciden con https://clipstudio.ai/mcp.md. Las herramientas de pago usan la asignación de generación de este mes.

Video Lab

Video de vanguardia de texto a video e imagen a video. Cotiza antes de generar.

Herramienta	Descripción
`list_video_lab_models`	Lista modelos, modos y valores predeterminados. Mismo catálogo que `/video-lab`.
`quote_video_lab`	Cotiza una configuración. No genera. La generación de pago necesita esta cotización.
`generate_video_lab`	Inicia una generación de pago. Consulta `get_video_lab_generation`.
`list_video_lab_generations`	Lista las generaciones de Video Lab de esta cuenta.
`get_video_lab_generation`	Obtiene una generación por ID de video.
`reconcile_video_lab_generation`	Actualiza un trabajo desde el proveedor. No vuelve a debitar.
`presign_generation_asset`	Crea un espacio de carga para una imagen fuente o MP4. Luego `complete_generation_asset`.
`complete_generation_asset`	Marca una imagen fuente o carga de MP4 como lista.

Topic Shorts

Tema → historia + material de archivo + voz. Modo de subtítulos predeterminado current. Modo de transición predeterminado dynamic.

Herramienta	Descripción
`list_hook_bank`	Plantillas de ganchos de apertura (Problema, Curiosidad, Confianza, Nicho). Siembra tema/breve; no es estilo de subtítulos.
`create_topic_short_story`	Previsualiza ritmos, narración y consultas de material en inglés. No renderiza.
`quote_topic_short`	Cotiza un Topic Short. No renderiza. Se cotiza por duración.
`generate_topic_short`	Genera desde un tema o `storyPlan` revisado. Consulta `get_topic_short`.
`get_topic_short`	Obtiene una generación.

Talking Shorts

URL de producto o breve → clip de cabeza parlante. Catálogo de rostros y voces.

Herramienta	Descripción
`research_talking_short`	Investiga desde una URL o breve. No renderiza.
`quote_talking_short`	Cotiza un Talking Short. No renderiza.
`generate_talking_short`	Inicia un Talking Short de pago. Consulta `get_talking_short`.
`get_talking_short`	Obtiene una generación.
`list_talking_short_actors`	Lista imágenes fijas del catálogo. No renderiza.

Ad Studio

Producto → ángulo → guion de 5 ritmos → creador del catálogo → un clip vertical.

Herramienta	Descripción
`research_ad_studio`	Investiga ángulos y un guion fijo de 5 ritmos. No renderiza.
`quote_ad_studio`	Cotiza un trabajo de Ad Studio. Solo creadores del catálogo.
`generate_ad_studio`	Inicia un clip de pago. Consulta `get_ad_studio`.
`get_ad_studio`	Obtiene una generación. Envía y consulta.

Last Frame

Reproduce una película generada. El último fotograma es el canon.

Herramienta	Descripción
`list_last_frame_games`	Lista juegos (Adventure, Heist, Tape y el resto).
`list_last_frame_worlds`	Lista mundos/mapas del catálogo.
`quote_last_frame`	Cotiza una toma de apertura o la siguiente. No filma.
`start_last_frame`	Inicia una partida y filma la toma de apertura.
`get_last_frame_run`	Obtiene una partida, incluida la última toma y las opciones.
`choose_last_frame`	Elige una opción numerada. Filma la siguiente toma.
`type_last_frame`	Escribe un movimiento personalizado. Filma la siguiente toma.
`timeout_last_frame`	Aplica el tiempo de espera de opción (temporizador HUD).
`end_last_frame_clip`	Indica a la partida que la toma actual terminó de reproducirse.
`arm_last_frame_item`	Arma un objeto del inventario para el siguiente movimiento (`itemIndex` es de base 0).
`create_last_frame_world`	Crea un mundo personalizado a partir de una descripción.

Image Lab

Imágenes fijas cotizadas. Mismo catálogo que /image-lab.

Herramienta	Descripción
`list_image_lab_models`	Lista modelos, modos y relaciones de aspecto.
`quote_image_lab`	Cotiza una imagen fija. No genera. La generación de pago necesita esta cotización.
`generate_image_lab`	Inicia una imagen fija de pago. Consulta `get_image_lab_generation`.
`list_image_lab_generations`	Lista las generaciones de Image Lab de esta cuenta.
`get_image_lab_generation`	Obtiene una generación y la actualiza desde el proveedor.

Audio Lab

Guion → narración descargable con voces de Clip Studio.

Herramienta	Descripción
`list_audio_lab_voices`	Lista voces de narración (acento y configuración regional).
`quote_audio_lab`	Cotiza un guion. No genera.
`generate_audio_lab`	Inicia narración de pago. Consulta `get_audio_lab_generation`.
`list_audio_lab_generations`	Lista las generaciones de Audio Lab de esta cuenta.
`get_audio_lab_generation`	Obtiene una generación y la actualiza desde el proveedor.

Story

Historia completa → partes → película. Continúa mi historia en el mismo projectId.

Herramienta	Descripción
`list_storyboard_themes`	Lista temas visuales (se mantienen entre partes).
`list_storyboard_voices`	Lista voces de narración (se mantienen entre partes).
`estimate_storyboard`	Estima la siguiente parte desde un guion. No renderiza.
`create_storyboard`	Inicia un proyecto desde una historia completa. No escribe una parte ni filma.
`get_storyboard`	Obtiene un proyecto, u omite `projectId` para listar los recientes.
`generate_storyboard_part`	Escribe la siguiente parte en un proyecto existente. No filma.
`render_storyboard`	Filma la última parte. Consulta `get_storyboard`.

Ad Lab

Sitio web → diseños estáticos, paquete de consejos, paquete Proof o película Explain.

Herramienta	Descripción
`import_ad_website`	Lee un sitio web público en un perfil de empresa.
`quote_ad`	Cotiza un diseño estático. No genera.
`generate_ad`	Genera imágenes fijas (`layout` 9:16, 1:1, 4:5 o 16:9). Consulta `get_ad_generation`.
`quote_ad_tip_pack`	Cotiza un paquete de consejos. No genera.
`generate_ad_tip_pack`	Genera un paquete de consejos. Consulta `get_ad_generation`.
`quote_ad_proof_pack`	Cotiza un paquete Proof. No genera.
`generate_ad_proof_pack`	Genera un paquete Proof. Consulta `get_ad_generation`.
`quote_ad_explain`	Cotiza una película Explain. No genera.
`generate_ad_explain`	Genera una película Explain desde una foto de producto y un breve.
`list_ad_generations`	Lista trabajos. Opcional `companyId` o `kind` `tip_pack`, `proof_pack`, `explain`.
`get_ad_generation`	Obtiene un trabajo.

Biblioteca

Clips que ya generaste. Publicar es una página pública de Clip Studio, no una publicación automática en redes sociales.

Herramienta	Descripción
`list_library`	Lista clips en la biblioteca.
`get_clip`	Obtiene un clip de la biblioteca.
`publish_generation`	Publica una generación completada en una página pública.
`unpublish_generation`	Deja de publicar una generación que hiciste pública.
`get_generation_publication`	Indica si una generación es pública y su URL pública si lo es.
`list_public_generations`	Lista publicaciones públicas. Opcional `kind`, `model`, `limit`.
`get_public_generation`	Obtiene una publicación pública por ID de clip.

Herramientas gratuitas

Copias, ganchos, breves y herramientas de planificación en /tools. No genera video.

Herramienta	Descripción
`list_free_tools`	Lista herramientas gratuitas públicas.
`run_free_tool`	Ejecuta una herramienta gratuita (`slug` + `input`).

Cuenta

Ayudantes de plan, uso y facturación.

Herramienta	Descripción
`list_public_products`	Lista productos públicos que un agente puede usar a través de este servidor.
`get_account`	Plan y uso de la cuenta con sesión iniciada, incluidos los ID de precio `offerCheckout` después de un 402.
`create_checkout_url`	Crea una URL de Stripe Checkout para un `priceId`. No recopila datos de tarjeta.

Enlaces

Producto: https://clipstudio.ai/mcp
Precios: https://clipstudio.ai/pricing
Soporte: https://clipstudio.ai/support
Correo electrónico: support@clipstudio.ai
Smithery: https://smithery.ai/servers/clipstudioai/clipstudio
Entrada del registro: server.json (ai.clipstudio/mcp) — consulta PUBLISHING.md

Mantener esto sincronizado

La lista de herramientas refleja https://clipstudio.ai/mcp.md. Cuando esa página cambie, actualiza las tablas aquí manualmente. Consulta scripts/sync-tools.md. Este repositorio no importa el código fuente privado de Clip Studio.