Claude용 MCP
내 Claude와 일하세요.
Filmsquare의 MCP 서버를 쓰면 스태프가 자기 Claude를 자기 이름과 역할로 작품 안에서 일하게 할 수 있어요. claude.ai, Claude Desktop, Claude Code가 툴 21개와 프롬프트 12개가 있는 주소 하나에 연결돼요. Claude가 나로서 코멘트를 읽고, 시나리오를 브레이크다운하고, 시트를 쓰고, 연결을 점검하고, 러프 편집본을 만들어요.
{}→ {"workspace": "…", "waiting_on_you": [], "unread": [ … ]}{"episode_id":"…","department":"casting","note":"Leo and the griffin are in."}→ {"request_id": "…", "notified": …}{"episode_id":"…","scene":"S3"}→ {"scenes": [{ "code": "S3", "shots": [ … ] }], …}{"asset_version_id":"…"}→ image · S3-B4-04a{"asset_version_id":"…"}→ image · S3-B4-04b{"episode_id":"…","seen":[{"shot":"S3-B4-04a","asset_version_id":"…"},{"shot":"S3-B4-04b","asset_version_id":"…"}],"checked_shots":["S3-B4-04a","S3-B4-04b"],"note":"Face, costume, props, light and geography, 04a against 04b","issues":[]}→ {"check_id": "…", "checked": 2, "results": []}{"query":"draft take of a shot"}→ estimateShotGeneration · generateForShot · …{"action":"estimateShotGeneration","path_params":{"id":"…"},"body":{"kind":"video","tier":"draft"}}→ {"provider": "byteplus", "model_key": "dreamina-seedance-2-5-260628", …}{"action":"generateForShot","path_params":{"id":"…"},"body":{"kind":"video","tier":"draft","newTake":{"origin":"variant"}}}→ {"tier": "draft", "status": "queued", …}{"action":"generateForShot","path_params":{"id":"…"},"body":{"kind":"video","tier":"draft","newTake":{"origin":"variant"}}}→ {"tier": "draft", "status": "queued", …}STAGE DOOR
내게 온 코멘트

Sam Okafor · S3-B2-02 · 00:04코멘트STAGE DOOR

캐스팅
Moneyshots, 에피소드 2: Stage Door
Mira Haddad 님이 내 컨펌을 요청
Leo와 그리핀 캐스팅 끝났어요.
씬 3 · 연결

S3-B4-04aSeedance 2.5 · 파이널 1080p · 6초 · 126.36크레딧 · €6.32

S3-B4-04bSeedance 2.5 · 파이널 1080p · 6초 · 126.36크레딧 · €6.32
얼굴 · 의상 · 소품 · 조명 · 위치 관계

S3-B5-05Seedance 2.5 · 파이널 1080p · 5초 · 105.30크레딧 · €5.27
S3-B5-05 · 5 s
Seedance 2.5 · 드래프트 · 480p · 3.78크레딧 · 초당 €0.19

S3-B5-05Seedance 2.5 · 파이널 1080p · 5초 · 105.30크레딧 · €5.27
S3-B5-05 · 5 s
Seedance 2.5 · 드래프트 · 480p · 3.78크레딧 · 초당 €0.19
연결
모든 Claude를 위한 주소 하나
워크스페이스와 Claude가 일할 역할은 내가 골라요.
https://app.filmsquare.ai/v1/mcp01 · CLAUDE.AI 또는 CLAUDE DESKTOP
커넥터 추가
- Settings → Connectors → Add custom connector.
- 이름은 Filmsquare로 하고 주소를 붙여 넣으세요.
- 연결하고, Connect Claude 페이지에서 워크스페이스를 고르세요.
- 내 역할 그대로 두거나 더 낮은 역할을 고른 뒤 Allow.
02 · CLAUDE CODE
명령어 하나 실행
브라우저에서 같은 Connect Claude 페이지가 열려요. 열리지 않으면 /mcp을 실행하고 filmsquare을 고르세요.
claude mcp add --transport http filmsquare https://app.filmsquare.ai/v1/mcp03 · 개인 키
브라우저 로그인 없이
Settings → Claude → Use a personal key instead. 키는 한 번만 보여 주고, 워크스페이스 하나에서 내 권한으로 동작해요.
claude mcp add --transport http filmsquare https://app.filmsquare.ai/v1/mcp \
--header "Authorization: Bearer fsk_…"대기 중인 일
내가 참여하는 모든 작품의 열린 코멘트, 컨펌 요청, 단계.
whats_waitinglist_productionsget_episode코멘트와 답글
코멘트마다 타임코드나 영역을 읽고, 테이크를 보고, 답하고, 스레드를 해결해요.
get_feedbackview_mediareply_feedback브레이크다운
시나리오를 읽고 씬, 컷, 캐스트, 세트, 소품으로 나누고, 빠뜨린 건 경고해요.
get_scriptedit_scriptsubmit_breakdown시트
인물 분석, 장소 노트, 연기 코멘트: 씬, 컷, 요소에 붙는 Markdown 시트.
submit_sheetsget_sheets연결
OK컷 사이의 얼굴, 의상, 소품, 빛, 공간을 확인하고 맞지 않는 곳을 알려 줘요.
get_continuityreport_continuity가져오기와 업로드
각본, 프리비즈, 파일을 맞는 자리에 넣어요. 한 번에 최대 100개까지.
where_does_it_goprepare_uploadupload_fileadd_to_visualize러프 컷
OK컷을 FilmCraft 타임라인에 올려 브라우저 없이 편집하고, 리뷰로 보내요.
view_edit_framerun_action컨펌
적절한 사람에게 단계 컨펌을 요청해요. 컨펌은 컨펌 담당자를 대신해서, 요청받았을 때만 해요.
request_signoffsign_off그 밖의 모든 것
API의 모든 라우트를 영화 스태프의 말로 찾아서 이름으로 실행해요. 새 라우트가 생겨도 새 툴이 필요 없어요.
find_actionsrun_action
프롬프트 8개
스태프의 일, 그 방법과 함께
먼저 계획하고, 비용을 알려 주고, 모든 스레드에 답하고, 요청하지 않은 파이널 렌더나 컨펌은 절대 하지 않아요. Claude Code에서는 /mcp__filmsquare__break_down_episode처럼 슬래시 명령어예요. 프롬프트와 일하는 방법
break_down_episodeprocess_feedbackwork_on_stepcheck_continuityrough_cutbring_in_writingbring_in_previsdeliver_to_filmsquare
비용과 권한
내 권한 그대로, 그 이상은 없어요
- Claude가 생각하는 값은 내 요금제로Claude는 내 Claude 구독으로 돌아가요. Filmsquare는 이에 대한 AI 토큰을 내지 않고 크레딧도 받지 않아요.
- 스태프의 일에는 크레딧이 들지 않아요브레이크다운, 코멘트와 답글, 시트, 연결 체크, 러프 컷에는 크레딧이 들지 않아요.
- 테이크에는 크레딧이 들어요테이크 비용은 다른 스태프가 낼 때와 똑같아요. Claude는 시작하기 전에 견적을 알려 줘요.
- 같은 제한크레딧 확인, 요금제 한도, 파이널 게이트가 다른 스태프와 똑같이 Claude에게도 적용돼요. Claude는 요청하지 않은 파이널을 렌더하지 않아요.
- 내 이름으로연결은 내 이름의 키예요. 코멘트, OK컷, 컨펌이 내 이름으로 남고, 작품에는 Claude가 함께 있다는 표시가 붙어요.
- 내 역할 이하워크스페이스 하나, 내 역할이거나 내가 고른 더 낮은 역할. 호출할 때마다 역할을 다시 확인하고, 내가 볼 수 있는 것만 보여 줘요.
- 연결 해제는 즉시 적용돼요Settings → Claude에 연결마다 역할과 마지막 사용 시점이 나와요. Disconnect를 누르면 바로 끊겨요. 워크스페이스를 나가면 권한도 함께 사라져요.
- 닿을 수 없는 곳Claude는 API 키, 연결, 웹훅, 공유 링크, 로그인에 손댈 수 없어요.
- 자료이지 지시가 아니에요코멘트, 시나리오, 시트는 Claude가 작업하는 대상이에요. 그 안의 텍스트가 Claude에게 무엇을 하라고 시키는 일은 없어요.
- 표준 로그인PKCE를 쓰는 OAuth 2.1, 한 번만 쓰고 10분이면 만료되는 로그인 코드, 해시로만 저장되는 키.
파이널 게이트는 Claude에게도 적용돼요. 기다리는 컨펌이 나기 전에는 파이널이 없어요
자주 묻는 질문
어떤 Claude를 연결할 수 있나요?
claude.ai, Claude Desktop, Claude Code. 모두 MCP(Streamable HTTP)로 같은 주소에 연결하고 OAuth로 로그인하며, Claude Code에서는 개인 키도 쓸 수 있어요.
Claude 비용은 Filmsquare가 내나요, 제가 내나요?
Claude는 내 Claude 요금제로 돌아가요. Claude가 생각하고, 브레이크다운하고, 코멘트를 처리하고, 연결을 체크하는 데는 Filmsquare 크레딧이 들지 않아요. 테이크는 누구에게나 그렇듯 크레딧이 들어요.
Claude가 나보다 더 많은 걸 할 수 있나요?
아니요. 연결은 워크스페이스 하나에서 내 역할 이하로 동작하고, 호출할 때마다 역할을 다시 확인해요. 내 역할이 내려가거나 내가 나가면 Claude의 권한도 함께 사라져요.
Claude가 알아서 파이널을 렌더하나요?
아니요. Claude는 테이크를 만들기 전에 비용을 알려 주고, 요청하지 않은 파이널은 렌더하지 않고, 파이널 게이트는 다른 스태프와 똑같이 Claude에게도 적용돼요.
코멘트가 Claude에게 뭘 시키면 어떻게 되나요?
코멘트, 시나리오, 시트는 작업 대상 자료이지 지시가 아니에요. Claude는 읽은 텍스트가 아니라 내 말을 따라요.
연결은 어떻게 끊나요?
Settings → Claude에 연결마다 역할과 마지막 사용 시점이 나와요. Disconnect를 누르면 바로 끊겨요.
