Filmsquare AyudaDocumentación

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.

Actualizado 8 min de lectura.md

En esta página
  1. Las herramientas con nombre
  2. Adónde va cada medio
  3. find_actions y run_action
  4. Ejemplos
  5. Cuando la API rechaza
  6. Lo que se deja fuera a propósito
  7. Seguridad
  8. Prompts

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 #

HerramientaQué haceNecesita
whats_waitingLos pasos de departamento que esperan tu visto bueno, y tus notificaciones sin leer. El lugar por donde empezar—
list_productionsLas producciones del espacio de trabajo con sus episodios—
get_episodeUn 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 renderizarepisode_id
get_feedbackHilos 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 anteriorestarget_type, target_id
reply_feedbackResponde 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 confirmathread_id, body
view_mediaUna 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 descargaasset_version_id
upload_fileUn 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_goEn qué pantalla va un archivo: el mapa, un árbol de decisión y ejemplos resueltos. Para leer en cuanto nombras una pantalla—
prepare_uploadURL 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 videofiles
add_to_visualizePone 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 nadaepisode_id, items
get_scriptLa última versión del guion del episodio, y los @handles del elenco, las locaciones y los objetos de utilería que ya existenepisode_id
edit_scriptCambiar 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ñanepisode_id, base_rev, edits
submit_breakdownPone 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 buenoepisode_id, breakdown
get_continuityLa 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 gratuitaepisode_id
report_continuityRegistra una comprobación visual de continuidad; cada discrepancia se convierte en una nota sobre la toma elegidaepisode_id, seen, issues
submit_stylePone 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 makername, guide
request_signoffPide a quienes dan el visto bueno de un departamento que lo den al paso de un episodio; reciben una notificaciónepisode_id, department
sign_offRegistra 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 decidieraepisode_id, department, decision
studio_analyticsPara 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 cifrasview

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:

TienesVa aCon
Render clay o cuadro de un plano, con lente, altura y movimientoStoryboard → 3D, en el planoadd_to_visualize
Clip de Blender de un plano, una toma o una escenaStoryboard → 3D, en lo que cubreadd_to_visualize
Animatic de una escena, secuencia o episodioStoryboard → Animaticadd_to_visualize
Video borrador o final de un planoStoryboard → Shots, como tomaupload_file
Imagen de referencia o moodboardHome → Filesupload_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.

  1. find_actions busca 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.
  2. run_action ejecuta una por su nombre, con path_params (no el espacio de trabajo), query y body tal 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ú dicesTambién busca
pick, chooseselect
note, notes, comment, comments, feedbackthread, message
replymessage
rendergeneration, generate
makecreate, generate
new, addcreate
remove, deletearchive
signsignoff
approvesignoff, approval
cast, character, propelement
setelement, location
production, productionsproject
crewmember, steps
costcosts, estimate
priceestimate
prompt, preview, dry rungenerate
kosten, schatting, prijs (neerlandés)generate, estimate
mismatchcontinuity
model, modelsmodels, acceptance, routing

Las acciones nuevas de la API aparecen en find_actions en cuanto salen. No hace falta ninguna herramienta nueva.

Ejemplos #

ParaBuscaAcció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_off registra 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

MCP

Tu propio Claude lo hace por MCP, en tu nombre y con tu rol:

  • find_actions

    Busca 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_action

    Ejecuta 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_waiting

    Muestra los pasos que esperan tu visto bueno y tus notificaciones sin leer.

    Pide: ¿Qué me espera en Filmsquare?

  • list_productions

    Muestra las producciones de tu espacio de trabajo con sus episodios.

    Pide: ¿Qué producciones y episodios tenemos en Filmsquare?

  • get_episode

    Muestra 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_feedback

    Lee 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_feedback

    Responde 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_media

    Mira 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_file

    Añ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_script

    Lee 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_script

    Cambia 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_breakdown

    Lleva 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_continuity

    Pone 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_continuity

    Registra 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_style

    Guarda 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_signoff

    Pide 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_off

    Registra 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_go

    Indica 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_upload

    Da enlaces de subida firmados y comandos curl listos para hasta 100 archivos en disco.

    Pide: Sube los videos de esta carpeta.

  • add_to_visualize

    Pone 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_analytics

    Para 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

Esta página en Markdown: /docs/es/claude/tools.md