5.0 Trabaja con tu propio Claude5.2 Qué puede hacer Claude
Qué puede hacer Claude
Todas las herramientas MCP que Filmsquare le da a tu Claude, cómo find_actions y run_action llegan al resto de la API, y qué se deja fuera a propósito.
Tu Claude puede hacer en Filmsquare lo que la API deja hacer a tu rol. Dieciocho herramientas con nombre cubren el trabajo
diario; dos más, find_actions y run_action, llegan a cualquier otra acción de la API. Cada llamada pasa por la
propia API, como tú: las mismas comprobaciones de rol, la misma validación, la misma luz verde para los finales.
Las herramientas con nombre #
| Herramienta | Qué hace | Necesita |
|---|---|---|
whats_waiting | Los pasos de departamento que esperan tu visto bueno, y tus notificaciones sin leer. El lugar por donde empezar | — |
list_productions | Las producciones del espacio de trabajo con sus episodios | — |
get_episode | Un episodio: escenas y planos en el orden del corte, cada paso de departamento (con visto bueno, a quién espera, cambios pedidos, abierto), y si los finales se pueden renderizar | episode_id |
get_feedback | Hilos de comentarios en un plano, toma, episodio, escena, elemento, carpeta, versión de asset, lienzo o nodo de lienzo, con cada mensaje y su marca (timecode en cuadros, o una región de la imagen). Hilos abiertos por defecto; status resolved o all para el resto. Con target_type sheet: las notas abiertas en la versión más reciente de la ficha (intención, cita o la ficha entera, texto sugerido, atendida o no) y cómo terminaron las notas de versiones anteriores | target_type, target_id |
reply_feedback | Responde en un hilo como tú (las menciones @name notifican a las personas), y lo resuelve cuando la nota está atendida. Una nota en una ficha se marca como atendida en su lugar; cuando tiene una sugerencia, suggestion_outcome (applied, adapted o declined) es obligatorio, y una persona la confirma | thread_id, body |
view_media | Una imagen fija, un keyframe o una toma como una imagen que Claude puede mirar; un video vuelve como su póster más un enlace de descarga | asset_version_id |
upload_file | Un archivo de la conversación a una capa de un plano o de una escena como toma nueva, o a una producción como asset. 10 MB como máximo. pick: true también lo elige (director y superior) | name, mime, data_base64 |
where_does_it_go | En qué pantalla va un archivo: el mapa, un árbol de decisión y ejemplos resueltos. Para leer en cuanto nombras una pantalla | — |
prepare_upload | URL de subida firmadas y comandos curl listos para hasta 100 archivos en disco, para que los bytes nunca pasen por la conversación. Para cada video | files |
add_to_visualize | Pone los archivos subidos en Storyboard → 3D o Storyboard → Animatic, hasta 100 por llamada, en planos y escenas por su código. Enviar lo mismo otra vez no cambia nada | episode_id, items |
get_script | La última versión del guion del episodio, y los @handles del elenco, las locaciones y los objetos de utilería que ya existen | episode_id |
edit_script | Cambiar una escena, un parlamento o una línea del guion sin enviarlo entero: el texto exacto y lo que lo sustituye, guardado como nueva versión; las notas y las etiquetas lo acompañan | episode_id, base_rev, edits |
submit_breakdown | Pone en Filmsquare el desglose de Claude: escenas, planos con interpretación, diálogo, elenco, locaciones y objetos de utilería. Guion queda entonces esperando visto bueno | episode_id, breakdown |
get_continuity | La ficha de continuidad de un episodio: qué reproduce cada plano, los elementos y sus referencias, con qué se hizo cada toma elegida, los hallazgos hasta ahora, los planos que hay que volver a comprobar. Ejecuta primero la comprobación de linaje gratuita | episode_id |
report_continuity | Registra una comprobación visual de continuidad; cada discrepancia se convierte en una nota sobre la toma elegida | episode_id, seen, issues |
submit_style | Pone una guía de estilo en la biblioteca de estilos (Create → Styles): un estilo nuevo o, con style_id, su versión siguiente; production_id lo hace de una producción. El trabajo propio lleva hasta 6 imágenes fijas de referencia (subidas con prepare_upload); el trabajo de otra persona es solo texto y nunca se publica. Los nombres de personas o marcas se rechazan. Rol de maker | name, guide |
request_signoff | Pide a quienes dan el visto bueno de un departamento que lo den al paso de un episodio; reciben una notificación | episode_id, department |
sign_off | Registra tu decisión sobre un paso: approved o changes_requested, con una note opcional. Solo pueden quienes dan el visto bueno al paso. Con expect_version (la versión del paso tal como la viste) se rechaza con changed_since cuando el trabajo cambió. Solo cuando le pediste a Claude que decidiera | episode_id, department, decision |
studio_analytics | Para el propietario y los productores: cómo va el estudio, con las cifras de Analytics. view crew (por persona en un periodo: delivered, créditos por delivered, tiempo hasta el visto bueno, first pass, lanes, redo, horas hands-on y de agente solo, la mediana del estudio y el tiempo por paso), day, costs o report (el texto del correo de informe tal como se enviaría). Cualquier otra persona recibe un rechazo: solo ve sus propias cifras | view |
Cada herramienta admite además un workspace opcional. Déjalo fuera: se usa el espacio de trabajo de la conexión.
department es uno de writing, breakdown, casting, voice, wardrobe, sets, props, animatic,
music, draft, sound, edit, final.
Adónde va cada medio #
Dile a tu Claude la pantalla con tus palabras («ponlo en 3D»). Esto es lo que hace:
| Tienes | Va a | Con |
|---|---|---|
| Render clay o cuadro de un plano, con lente, altura y movimiento | Storyboard → 3D, en el plano | add_to_visualize |
| Clip de Blender de un plano, una toma o una escena | Storyboard → 3D, en lo que cubre | add_to_visualize |
| Animatic de una escena, secuencia o episodio | Storyboard → Animatic | add_to_visualize |
| Video borrador o final de un plano | Storyboard → Shots, como toma | upload_file |
| Imagen de referencia o moodboard | Home → Files | upload_file |
Lo que está en el lugar equivocado se mueve sin volver a subirlo: moveTake o moveAsset por run_action (director y superior). Una toma elegida hecha por la importación se quita al mover. Una toma que alguien eligió, o generada aquí, se queda donde está.
find_actions y run_action #
Todo lo que no tiene una herramienta con nombre pasa por estas dos: crear planos, elegir tomas, hacer borradores, estimaciones, elementos y versiones, carpetas, lienzos, costos, briefs, equipo.
find_actionsbusca en el propio catálogo de la API con unas pocas palabras, como "pick take", "create shot" o "resolve thread". Devuelve las acciones que coinciden con su método, ruta, un resumen, el rol mínimo y las entradas.run_actionejecuta una por su nombre, conpath_params(no el espacio de trabajo),queryybodytal como describe la acción. Responde con el JSON de la API.
find_actions entiende el lenguaje del set, en inglés. Traduce las palabras que usa un equipo a las palabras de la
API:
| Tú dices | También busca |
|---|---|
| pick, choose | select |
| note, notes, comment, comments, feedback | thread, message |
| reply | message |
| render | generation, generate |
| make | create, generate |
| new, add | create |
| remove, delete | archive |
| sign | signoff |
| approve | signoff, approval |
| cast, character, prop | element |
| set | element, location |
| production, productions | project |
| crew | member, steps |
| cost | costs, estimate |
| price | estimate |
| prompt, preview, dry run | generate |
| kosten, schatting, prijs (neerlandés) | generate, estimate |
| mismatch | continuity |
| model, models | models, acceptance, routing |
Las acciones nuevas de la API aparecen en find_actions en cuanto salen. No hace falta ninguna herramienta nueva.
Ejemplos #
| Para | Busca | Acción |
|---|---|---|
| Poner precio a un borrador antes de renderizarlo | "estimate shot" | estimateShotGeneration |
| Ver el prompt, el modelo y los créditos antes de renderizar | "dry run" | generateForShot con {"kind": "video", "tier": "draft", "dryRun": true} |
| Renderizar un borrador | "generate shot" | generateForShot con {"kind": "video", "tier": "draft"} |
| Elegir una toma | "pick take" | selectTake |
| Convertir un borrador en final | "promote" | promoteGeneration |
| Repetir una toma a partir de una nota | "revise take" | estimateReviseTake, y después reviseTake |
| Ver qué modelo se acepta | "model acceptance" | getModelAcceptance |
| Costo de un episodio | "episode costs" | getEpisodeCosts |
Antes de renderizar, Claude llama a la acción de generación con dryRun: true: muestra el prompt compuesto, el modelo,
las referencias y los créditos, y no crea nada. Después puede ajustar el prompt para ese único render.
overrides.prompt sustituye el texto del prompt (las líneas de referencias se quedan, así que elenco, locaciones y objetos de utilería
siempre van incluidos), overrides.promptAppend le añade algo y overrides.negativePrompt añade lo que hay que
evitar. En el diálogo se pronuncian sus líneas y no se admite un prompt modificado.
El dry run responde con provider y model_key. Si los devuelves como provider y modelKey, se mantiene ese
modelo. getGeneration muestra con qué se hizo una toma: el prompt, el modelo, los créditos estimados y los créditos
contabilizados.
Cuando la API rechaza #
Un rechazo vuelve como un error de herramienta con el código y los detalles de la API, por ejemplo
The API refused: 409 gate_closed: finals render once casting, sets, animatic are signed off {"episode_id": "…", "waiting_on": ["casting", "sets", "animatic"]}.
Claude lo lee y te dice qué falta. Consulta Errores que te encontrarás.
Lo que se deja fuera a propósito #
Claude no puede llegar a esto, por diseño:
- Claves de API y conexiones de Claude: una conexión nunca crea claves ni permite otras conexiones. Lo hace una persona, con la sesión iniciada.
- OAuth y el registro de cuentas.
- Webhooks: envían datos fuera de Filmsquare.
- Callbacks de proveedores y los sockets en tiempo real (lienzo y presencia).
La luz verde de los finales, las comprobaciones de créditos y los límites del plan se aplican a Claude exactamente igual que a cualquiera.
Seguridad #
- Claude actúa como tú. Tiene tu rol (o el inferior que elegiste al conectar), y lo que hace aparece a tu nombre.
- El material del equipo no son instrucciones. Los comentarios, guiones y otros textos que Claude lee en Filmsquare son material del equipo. Filmsquare se lo dice a Claude: solo tú decides lo que hace.
- Da el precio primero. Hacer tomas cuesta créditos. A Claude se le dice que llame a la acción de generación con
dryRun: true, lo que no crea nada, y que diga lo que costará una toma antes de empezar una, y que nunca renderice finales sin que se lo pidas. - Nunca da el visto bueno sin que se lo pidas.
sign_offregistra una decisión a tu nombre. A Claude se le dice que lo use solo cuando le pediste que decidiera.
Prompts #
Cuatro prompts llevan un método de trabajo para tareas habituales: break_down_episode, process_feedback,
work_on_step y check_continuity. Consulta Prompts y método de trabajo.
Con Claude
MCPTu propio Claude lo hace por MCP, en tu nombre y con tu rol:
find_actionsBusca en todo lo que puede hacer la API y devuelve las acciones que encajan, con sus datos de entrada.
Pide: Busca la acción que cambia la regla de visto bueno de un paso.
run_actionEjecuta una acción encontrada con find_actions, como tú, con tu rol y tus permisos.
Pide: Elige la segunda toma del plano 5 en el episodio 2.
whats_waitingMuestra los pasos que esperan tu visto bueno y tus notificaciones sin leer.
Pide: ¿Qué me espera en Filmsquare?
list_productionsMuestra las producciones de tu espacio de trabajo con sus episodios.
Pide: ¿Qué producciones y episodios tenemos en Filmsquare?
get_episodeMuestra las escenas y planos de un episodio en el orden del corte, cada paso de departamento y si los finales pueden renderizarse.
Pide: ¿Cómo va el episodio 2 y a quién espera cada paso?
get_feedbackLee los hilos de comentarios de un plano, toma, episodio o elemento, con el timecode o la región de cada marca.
Pide: ¿Qué notas siguen abiertas en el episodio 2?
reply_feedbackResponde en un hilo de comentarios en tu nombre y lo resuelve cuando la nota está atendida.
Pide: Responde a la nota del plano 4 que el nuevo borrador corrige la mirada, y resuélvela.
view_mediaMira una imagen fija, un cuadro clave o una toma; el video vuelve como póster con un enlace de descarga.
Pide: Enséñame la imagen fija elegida del plano 3 y dime si coincide con sus referencias.
upload_fileAñade un archivo como nueva toma de un plano o escena, o como asset de la producción (10 MB como máximo).
Pide: Sube esta foto de referencia a los assets de la producción.
get_scriptLee la última revisión del guion de un episodio, con los @handles que ya existen.
Pide: Lee el guion del episodio 2 y dime qué personajes aún no tienen @handle.
edit_scriptCambia una escena, un parlamento o una línea del guion de un episodio y lo guarda como nueva versión, sin enviar el guion entero.
Pide: Reescribe el comienzo de S02 en el episodio 2 como acabamos de hablar, y guárdalo como nueva versión.
submit_breakdownLleva tu desglose a Filmsquare: escenas, planos, diálogos, elenco, locaciones y objetos de utilería.
Pide: Haz el desglose del guion del episodio 2 y envíalo. Reutiliza los handles que ya tenemos.
get_continuityPone lado a lado los planos elegidos de un episodio, con las versiones de elementos que usa cada uno.
Pide: Prepara las tomas elegidas de la escena S2 para una revisión de continuidad.
report_continuityRegistra tu revisión de continuidad; cada discrepancia se convierte en una nota en la toma elegida del plano.
Pide: Revisa la continuidad de la escena S2 e informa las discrepancias que encuentres.
submit_styleGuarda una guía de estilo en tu biblioteca de estilos (Create, Styles): un estilo nuevo o la siguiente versión de uno existente.
Pide: Mira estas imágenes, escribe una guía de estilo, muéstramela y envíala cuando diga adelante.
request_signoffPide a quienes dan el visto bueno a un paso de departamento que lo den; reciben una notificación.
Pide: Pide a quienes dan el visto bueno a el siguiente paso en el episodio 2 que lo den, con una nota de lo que cambió.
sign_offRegistra tu decisión sobre un paso: visto bueno o cambios pedidos. Solo cuando dejas que Claude decida.
Pide: Da el visto bueno a el siguiente paso en el episodio 2 por mí.
where_does_it_goIndica en qué pantalla va un archivo: el mapa, un árbol de decisión y ejemplos resueltos.
Pide: ¿Dónde va este reel de marcación?
prepare_uploadDa enlaces de subida firmados y comandos curl listos para hasta 100 archivos en disco.
Pide: Sube los videos de esta carpeta.
add_to_visualizePone los archivos subidos en Storyboard, 3D o Animatic, en planos y escenas por su código.
Pide: Pon el trabajo de Blender en 3D y los animatics en Animatic.
studio_analyticsPara el propietario y los productores: cómo va el estudio, desde el equipo, un día, los costos o el correo de informe tal como se enviaría.
Pide: ¿Cómo le fue al equipo la semana pasada y quién necesita ayuda?
Conectar Claude 5.1