Plugin de eroq para Claude Code: servidor MCP, OAuth y una skill

Ya hay tres formas de darle a Claude Code las herramientas de eroq, y no son lo mismo. El claude mcp add de una línea le da las herramientas. El plugin le da las herramientas y una skill: un documento breve que le explica a Claude Code cómo cobra eroq, qué modelo elegir y cómo esperar un video sin que tengas que decírselo. La CLI le da un servidor local que escribe archivos. Esta guía trata del plugin: la instalación, lo que dice la skill y cuándo elegir cada opción.

Instalación

Los plugins de Claude Code vienen de marketplaces, y eroq sirve el suyo propio desde eroq.ai, sin ningún repositorio git de por medio:

/plugin marketplace add https://eroq.ai/claude-code/marketplace.json
/plugin install eroq@eroq

Después, /mcp, selecciona eroq y elige Authenticate. eroq se abre en el navegador: inicia sesión y haz clic en Allow. Claude Code obtiene su propia clave, «Claude Code (connected)», en Desarrolladores → Claves de API; revócala ahí para desconectarlo.

La entrada del marketplace es un archivo comprimido fijado por SHA-256, así que lo que se instala es exactamente lo que publicamos. Sin el plugin, el servidor solo es:

claude mcp add --transport http eroq https://eroq.ai/mcp

(añade --scope user para tenerlo en todos tus proyectos), seguido del mismo /mcp → Authenticate. ¿Prefieres una clave en una cabecera? --header "Authorization: Bearer eroq_sk_…" también funciona.

Lo que enseña la skill

Una skill es un archivo markdown que Claude Code lee cuando la tarea coincide con su descripción. La skill de eroq se activa cuando pides una imagen, un clip, una frase de voz o recursos visuales para el proyecto, y dice, en resumen:

• No adivines precios. Llama a list_models una vez por sesión cuando el usuario no haya nombrado un modelo; devuelve cada modelo con su precio y si el plan lo desbloquea. Llama a get_account para ver el saldo y, cuando una generación lo vaya a superar claramente, dilo en lugar de renderizar.
• Mejora los encargos vagos. enhance_prompt es gratis; úsalo con una petición imprecisa y enséñale el prompt al usuario cuando cambie la intención.
• Imágenes: generate_image espera y devuelve la imagen más un enlace firmado válido durante treinta minutos; aspect entre las cinco proporciones, al mismo precio; guárdala en el proyecto enseguida con curl -L -o <path> "<url>", porque el enlace caduca. Un id de job en un arranque lento significa que hay que consultar get_image_status.
• Video: asíncrono. generate_video espera hasta unos 45 segundos y luego devuelve un id de job; consulta get_video_status cada diez segundos más o menos; los renders tardan de uno a cinco minutos. Nombra el motor con model cuando el look importe; seconds lo limita el plan y se ajusta a la cuadrícula del motor; reference_image_url es el primer fotograma en los motores con imagen a video.
• Voz: generate_speech devuelve MP3; elige una voz de list_voices, o char:<id> de list_characters para hablar como uno de los personajes del usuario.
• Prompts: un solo párrafo fluido (sujeto, acción, escenario, luz, lente o movimiento de cámara, ambiente); sustantivos concretos antes que adjetivos; para video, describe el movimiento y la cámara.
• Política: nunca pidas contenido que involucre a menores ni a personas reales sin su consentimiento; muestra los mensajes de rechazo de eroq tal como llegan.

Nada de esto es magia. Es la diferencia entre un agente que renderiza un clip de 20 segundos con el motor más caro porque dijiste «haz un video» y uno que pregunta qué motor usar, te indica 45 créditos por cinco segundos con el predeterminado y consulta el estado hasta que el archivo existe.

Una sesión con el plugin

Tú: Las pantallas de onboarding necesitan ilustraciones: una por paso de steps.ts, en 4:3, estilo plano en tonos pastel, coherentes entre sí.

Claude Code lee steps.ts (cinco pasos), llama a list_models y get_account («1,240 créditos; cinco imágenes de Krea 2 son 50»), ejecuta enhance_prompt una vez sobre el estilo y reutiliza la línea de estilo mejorada en cada paso, llama a generate_image cinco veces con aspect: "4:3", guarda cada una en public/onboarding/step-N.webp con curl y actualiza steps.ts con las rutas. «Gastados 50 créditos, quedan 1,190».

Sin la skill, la misma petición suele acabar con cinco interpretaciones distintas del estilo y ninguna línea de presupuesto.

Plugin, comando o CLI

	claude mcp add	Plugin	CLI (eroq mcp)
Herramientas	Servidor remoto	Servidor remoto	Servidor local
Inicio de sesión	OAuth vía /mcp	OAuth vía /mcp	Clave en variable de entorno
Skill	No	Sí	No
Salida	Enlaces + imágenes en línea	Enlaces + imágenes en línea	Archivos en rutas
Ideal para	Probarlo	Uso diario	Pasos de build, CI

El plugin y el comando son el mismo servidor; el plugin añade la skill y fija una versión. La CLI es un servidor distinto, local, que escribe archivos: combínala con el plugin si quieres a la vez el criterio de la skill y la salida en archivos, ya que los consejos de la skill sirven para ambos.

Actualizaciones

La entrada del marketplace lleva una versión; ejecuta /plugin update eroq@eroq cuando publiquemos una nueva (la skill cambia a medida que cambian los modelos y los precios). Si haces un fork, valida tu copia local con claude plugin validate.

Preguntas frecuentes

¿Qué añade el plugin frente al comando de una línea?

El mismo servidor, más una skill que le enseña a Claude Code cómo funcionan los prompts, los precios y el video asíncrono de eroq, así que elige modelos sensatos, te indica los créditos y consulta el estado de los clips sin que se lo pidas.

¿Necesito una clave de API?

No: /mcp → Authenticate lanza el inicio de sesión en el navegador. Una clave en una cabecera sigue funcionando para configuraciones automatizadas.

¿Puede guardar los renders en mi repositorio?

El servidor remoto responde con enlaces e imágenes en línea; la skill le dice a Claude Code que los descargue en el proyecto con curl. Para obtener archivos directamente, usa el servidor local de la CLI: npx -y @eroq/cli mcp.

¿Es seguro añadir el marketplace?

Se sirve desde eroq.ai por HTTPS y el archivo del plugin está fijado por SHA-256 en el archivo del marketplace, así que Claude Code verifica lo que instala.

La página de Claude Code tiene los dos comandos listos para copiar.