El paquete yesilcam-studios lleva Yeşilçam Studios a tu terminal y a los asistentes de IA que hablan MCP (Model Context Protocol). Instala dos comandos: yesilcam, la línea de comandos para scripts y flujos de trabajo, y yesilcam-mcp, un servidor que permite a Claude Code, Claude Desktop, Cursor, VS Code, Windsurf y otros clientes MCP usar los estudios como herramientas. La versión 0.3 cubre todos los estudios con 131 operaciones: Image, Film, Animation, Cinema, Design, Website, Fashion Try-On, Maket y AI Influencer Studio, además de tu cuenta y tu biblioteca. Usa la misma cuenta, el mismo saldo de tokens y los mismos precios que la app web. Esta guía te lleva desde la instalación hasta una primera conversación que funciona. Si quieres una visión general, mira la página para desarrolladores.

¿Qué necesito?

  • Node.js 18 o superior, que incluye el comando npm.
  • Una cuenta de Yeşilçam Studios. Sirven Free, Basic y Pro; algunas funciones requieren Basic o Pro, igual que en la app.
  • Una terminal. Para la parte del asistente, un cliente MCP como Claude Code, Claude Desktop o Cursor.

¿Cómo lo instalo?

Instala el paquete de forma global desde la web de Yeşilçam Studios:

npm install -g https://yesilcamstudios.com/downloads/yesilcam-studios.tgz
yesilcam --version
yesilcam --help

yesilcam --version debería mostrar 0.3.0. yesilcam --help lista los grupos de comandos, uno por estudio, y yesilcam <group> --help (por ejemplo, yesilcam image --help) muestra los comandos y las opciones de cada grupo.

¿Cómo inicio sesión?

La forma recomendada es una clave API. La creas en la app, en Cuenta → Desarrollador. Al crear una clave eliges:

  • Un nombre, para distinguir tus claves más adelante (por ejemplo, «Portátil» o «Servidor de compilación»).
  • El acceso: Solo lectura (saldo, precios, biblioteca, estado de los trabajos) o Lectura y creación, que además puede iniciar trabajos y gastar tokens.
  • La validez: 30, 90 o 365 días, o sin caducidad.

La clave empieza por ysk_ y solo se muestra una vez, así que cópiala en ese momento. Después ejecuta yesilcam login y pégala. Lo que escribes no se ve, la clave nunca se muestra en pantalla y se guarda en ~/.config/yesilcam/config.json con permisos que solo tu usuario puede leer. Comprueba que ha funcionado:

yesilcam login
yesilcam account show

Si todavía no tienes una clave, también puedes iniciar sesión con tu correo y tu contraseña: yesilcam login --password. Así se guarda una sesión en el mismo archivo. En un servidor o en CI no guardes nada en disco: pon la clave en la variable de entorno YESILCAM_API_KEY o pásala por la entrada estándar con yesilcam login --key-stdin.

¿Cómo conecto Claude Code?

Un solo comando registra el servidor:

claude mcp add yesilcam -- yesilcam-mcp

El servidor lee las credenciales que guardó yesilcam login, así que no hay ninguna clave ni en el comando ni en la configuración de Claude Code.

¿Cómo conecto Claude Desktop, Cursor, VS Code o Windsurf?

Estos clientes leen los servidores MCP de un archivo de configuración JSON: claude_desktop_config.json en Claude Desktop, ~/.cursor/mcp.json en Cursor, y los ajustes MCP de VS Code y Windsurf. Añade esta entrada:

{"mcpServers":{"yesilcam":{"command":"yesilcam-mcp","args":[]}}}

Si el archivo ya tiene otros servidores, añade "yesilcam" dentro del objeto mcpServers que ya existe en lugar de crear otro. Después reinicia el cliente. No hace falta que te lo aprendas: yesilcam mcp muestra los fragmentos listos para cada cliente.

¿Puedo cargar menos herramientas?

Sí. 131 herramientas son una lista larga, y si solo usas unos pocos estudios, una lista más corta ayuda a que el asistente no se disperse. Indica los estudios que quieres en args:

{"mcpServers":{"yesilcam":{"command":"yesilcam-mcp","args":["--studios","image,film,influencer"]}}}

Los nombres disponibles son image, film, animation, cinema, design, website, fashion, maket e influencer. Las herramientas de cuenta y biblioteca se cargan siempre. Añade "--read-only" para cargar solo las herramientas de lectura, por ejemplo para un asistente que debe informarte de tu biblioteca pero nunca iniciar trabajos.

¿Cómo sería mi primera conversación?

Empieza por algo gratuito: «¿Cuál es mi saldo de tokens en Yeşilçam y cuánto cuesta una imagen en calidad borrador con mi plan?». El asistente llama a las herramientas de saldo y de precios y te responde. Luego prueba un trabajo pequeño: «Haz una imagen en borrador, 16:9, de un faro al atardecer. Dime primero el precio y luego guárdala en mi escritorio». Lo primero que recibe el asistente es un presupuesto, y no se cobra nada. Te muestra el precio y, solo cuando le dices que sí, vuelve a llamar a la herramienta con tu aprobación, espera a la imagen y la descarga. La guía de aprobación de tokens explica este paso en detalle, y las recetas por estudio te dan ideas para lo siguiente.

Solución de problemas

  • «command not found». La carpeta donde npm instala los comandos globales no está en tu PATH. npm prefix -g te indica dónde está; añade su carpeta bin al PATH y abre una terminal nueva.
  • «not signed in» (código de salida 2). No se han encontrado credenciales guardadas. Vuelve a ejecutar yesilcam login o comprueba que YESILCAM_API_KEY está definida en el entorno donde se ejecuta el comando.
  • El asistente no muestra las herramientas de Yeşilçam. Reinicia el cliente después de editar su configuración. Si aun así no consigue arrancar el servidor, escribe en "command" la ruta completa del comando (en macOS y Linux te la da which yesilcam-mcp).
  • La clave se rechaza. Puede que haya caducado o que se haya revocado. Crea una clave nueva en Cuenta → Desarrollador y vuelve a ejecutar yesilcam login.
  • No te deja crear, o el asistente no tiene herramientas de creación. La clave se creó con acceso Solo lectura, o el servidor se inició con --read-only.

Preguntas frecuentes

¿El CLI o el servidor MCP cuestan algo extra? No. Cada operación cuesta exactamente lo mismo que en la app, con los precios de tu plan, y no se cobra nada hasta que apruebas un presupuesto.

¿Mi clave acaba en la configuración del asistente? No. La configuración solo nombra el comando yesilcam-mcp; el servidor lee la clave que yesilcam login guardó en tu ordenador.

¿Cómo cierro sesión en un ordenador? Ejecuta yesilcam logout. Borra las credenciales guardadas en ese ordenador. Una clave API sigue funcionando en otros sitios hasta que la revoques en Cuenta → Desarrollador.

¿Puedo usar la app y el CLI a la vez? Sí. Lo que inicias desde la terminal o desde un asistente aparece en la misma biblioteca y usa el mismo saldo que la app.