5.0 내 Claude와 일하기5.1 Claude 연결(MCP)
Claude 연결(MCP)
내 Claude(claude.ai, Claude Desktop, Claude Code)를 MCP로 Filmsquare에 연결하고, 연결을 관리하거나 해제하는 방법이에요.
스태프는 누구나 자기 Claude를 Filmsquare에 연결할 수 있어요. 그러면 Claude가 내 워크스페이스에서 내 이름과 내 역할로, 내 Claude 구독으로 일해요. 내가 처리할 일을 보고, 피드백을 훑고, 시나리오를 브레이크다운하고, 팀 작업을 준비해요. Filmsquare는 이 일에 AI 토큰을 쓰지 않고, 나도 Claude가 생각하는 데 Filmsquare 크레딧을 쓰지 않아요.
연결에는 MCP(Model Context Protocol)를 써요. 주소는 이거예요.
https://app.filmsquare.ai/v1/mcp
복사 버튼이 붙은 주소는 Settings → Claude에 있어요. 사이드바 맨 위의 워크스페이스 메뉴를 열고 Settings, 그다음 Claude를 선택하세요.

claude.ai 또는 Claude Desktop #
- Claude에서 Settings → Connectors를 열고 Add custom connector를 선택해요.
- 이름을 Filmsquare로 하고 주소
https://app.filmsquare.ai/v1/mcp를 붙여넣어요. - Connect를 선택해요. 브라우저에 Filmsquare의 Connect Claude 페이지가 열려요. 로그인이 안 되어 있으면 로그인하세요.
- Claude가 일할 Workspace를 골라요.
- Claude works as(Claude의 역할) 아래에서 내 역할 그대로 두거나 더 낮은 역할을 골라요.
- Allow(허용)를 선택해요. Claude가 열리면 탭을 닫아도 돼요.
Claude Code #
터미널에서 이걸 실행하세요.
claude mcp add --transport http filmsquare https://app.filmsquare.ai/v1/mcp
Claude Code가 브라우저를 열어 연결해요. 위와 같은 Connect Claude 페이지가 나와요. 안 열리면 Claude Code에서 /mcp를 실행하고 filmsquare 서버를 선택해 로그인하세요.
대신 개인 키로 #
브라우저 로그인이 맞지 않는 기기에서는 개인 키를 써요.
- Settings → Claude에서 Use a personal key instead(대신 개인 키 사용)를 선택해요.
- Name of the key(키 이름, 예: “내 노트북의 Claude Code”)를 짓고 Create a personal key(개인 키 만들기)를 선택해요.
- 명령을 복사해요. 키는 한 번만 보여요.
claude mcp add --transport http filmsquare https://app.filmsquare.ai/v1/mcp \
--header "Authorization: Bearer fsk_…"
이 키를 가진 사람은 누구나 이 워크스페이스에서 내 이름으로 일할 수 있어요. 키가 새면 바로 연결을 해제하세요.
잘 되는지 확인하기 #
Claude에게 평소 말투로 요청해 보세요. 예를 들어 이런 식이에요.
- “Filmsquare에서 내가 처리할 게 뭐가 있어?”
- “내 작품에 열려 있는 피드백을 훑어보고 처리해 줘.”
- “내 작품 1화 시나리오를 브레이크다운해 줘.”
Claude는 whats_waiting이나 list_productions로 시작해요. 연결되면 곧바로 Settings → Claude에 내 연결이 나타나고, 시작 체크리스트의 Connect your Claude가 체크돼요.
연결 확인하고 해제하기 #
Settings → Claude의 Your Claude connections(내 Claude 연결)에는 연결마다 이름, 역할, 마지막으로 쓴 때가 나와요. Disconnect(연결 해제)는 바로 멈춰요. 이 페이지에는 내 연결과 키만 나와요.
연결이 할 수 있는 일 #
- 내 이름의 키이고, 워크스페이스 하나에서, 많아야 내 역할까지만 가져요. 더 낮은 역할을 골랐다면 Claude는 그 역할이에요.
- 호출마다 내 역할을 다시 확인하고, 내가 볼 수 있는 것만 보여 줘요. 내 역할이 낮아지거나 워크스페이스를 떠나면 Claude의 권한도 함께 사라져요.
- Claude가 한 일은 나로 나타나요. 코멘트, OK컷, 컨펌, 항목별 활동에서요.
- 연결로는 API 키를 만들거나, 다른 연결을 허용하거나, 웹훅을 관리할 수 없어요.
일부러 뺀 것은 Claude가 할 수 있는 일을, Claude가 따르는 안전 규칙은 프롬프트와 작업 방식을 보세요.
기술 상세 #
- 전송: Streamable HTTP, 스테이트리스 JSON-RPC. 배치는 지원하지 않아요.
- 인증: PKCE(S256)를 쓰는 OAuth 2.1,
/oauth/register의 동적 클라이언트 등록, 메타데이터는/.well-known/oauth-protected-resource/v1/mcp와/.well-known/oauth-authorization-server. 코드는 한 번만 쓸 수 있고 10분 동안 유효해요. - 자격 증명이 없으면 엔드포인트는 메타데이터를 가리키는
WWW-Authenticate헤더와 함께401로 답해요. - 개인 키나 API 키(
Authorization: Bearer fsk_…)도 되고, 로그인된 세션도 돼요. - 다른 오리진의 브라우저 페이지는 엔드포인트를 호출할 수 없어요(claude.ai는 허용돼요).
Claude와 함께
MCP내 Claude가 MCP로 이 일을 해요. 내 이름으로, 내 역할대로요:
whats_waiting내 컨펌을 기다리는 단계와 읽지 않은 알림을 보여 줘요.
이렇게 요청해요: Filmsquare에서 내가 처리할 게 뭐가 있어?
Claude 연결 5.1