---
title: "Qué puede hacer Claude"
description: "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."
url: https://www.filmsquare.ai/docs/es/claude/tools/
lang: es
section: claude
updated: 2026-11-15
mcp: [find_actions, run_action, whats_waiting, list_productions, get_episode, get_feedback, reply_feedback, view_media, upload_file, get_script, edit_script, submit_breakdown, get_continuity, report_continuity, submit_style, request_signoff, sign_off, where_does_it_go, prepare_upload, add_to_visualize, studio_analytics]
---

# Qué puede hacer Claude

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.

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ú 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](https://www.filmsquare.ai/docs/es/api/overview/#errors-you-will-meet).

## 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](https://www.filmsquare.ai/docs/es/claude/prompts/).
