실마리를 Claude에 연결하기
실마리 커넥터 (MCP) 안내 · 2026년 11월
실마리는 장편 AI 영상·게임·소설의 장부입니다 — 작품 › 에피소드 › 회차 › 컷, 캐릭터·장소 시트, 장부(훅·실마리·펀치라인), 점검, 그레이박스 3D 구도. 실마리를 Claude의 커스텀 커넥터로 연결하면 Claude가 이 장부를 직접 읽고 씁니다. 원고 정리, 전체 수정, 회차 이어 쓰기, 일관성 점검, 캐릭터 시트 쓰기, 구도 구성, 영상 붙이기까지 당신의 Claude로 할 수 있고, 실마리 이용권은 쓰지 않습니다.
1. 주소
https://silmary.ai/mcp이 주소를 그대로 넣습니다 (끝에 슬래시 없이).
2. 추가 방법
- Claude 웹 · 데스크톱 · 모바일 — 설정(Customize) › 커넥터(Connectors) › 「커스텀 커넥터 추가(Add custom connector)」에 위 주소를 넣습니다. 무료·Pro·Max·Team·Enterprise 플랜 모두 됩니다.
- 실마리 로그인 → 허용 — 실마리 로그인 화면(구글)이 열리면 로그인하고 「허용」을 누릅니다. Claude로 돌아오면 「연결됨(Connected)」이 됩니다.
- 채팅에서 켜기 — 채팅의 + › 커넥터에서 실마리를 켠 뒤 말로 시킵니다. 커넥터 설정의 「도구 권한(Tool permissions)」에서 쓰기 도구를 늘 묻게 하거나 허용할 수 있습니다.
Claude Code(터미널): claude mcp add --transport http silmary https://silmary.ai/mcp
3. 이렇게 말해 보세요
- “내 작품 목록 보여 줘”
- “「악마 주식회사」 3화 컷 목록이랑 장부를 보여 줘”
- “이 원고를 「악마 주식회사」 2화로 정리해서 넣어 줘 (컷 8~12개, 대사 포함)”
- “5화에 1화 설정이랑 어긋나는 데 있는지 점검해서 점검 목록에 남겨 줘”
- “주인공 민수의 캐릭터 시트를 더 구체적으로 써 줘 (외형, 말투)”
- “3화 C05를 식당 세트에서 바스트샷으로 구성해 줘”
- “(그레이박스를 열어 두고) 민수를 카운터 옆으로 옮기고 지수를 보게 해 줘”
- “3화 C02의 힉스필드 꾸러미를 받아서 영상을 만들고 테이크로 넣어 줘”
4. 어떻게 동작하나
- 실마리 웹에 로그인해 두면 작품을 저장할 때마다 사본이 실마리 서버에 올라가고, Claude는 그 사본을 읽고 씁니다. Claude가 고친 것은 웹이 10초 안에 받아 화면에 보여 주고 구글 드라이브에 다시 저장합니다. 고친 자리는 아래쪽 알림과 「마지막 작업」 표시로 알 수 있습니다.
- 읽기 도구는 바로 실행되고, 쓰기·삭제 도구는 Claude가 매번 확인한 뒤 실행합니다. Claude가 고치기 전 사본은 작품마다 최근 5개가 남아, 실마리 홈 › 「Claude 연결」에서 되돌릴 수 있습니다.
- 그레이박스: 실마리 웹에서 그레이박스(자유 스테이지나 컷의 구도 잡기)를 열어 두면 Claude의 구성·조작이 몇 초 안에 그 화면에서 바로 움직이고, Claude는 렌즈로 본 그림을 돌려받습니다. 창이 닫혀 있으면 컷에 구성이 남았다가 다음에 그 컷을 열 때 지어집니다.
- 영상: 실마리 커넥터는 컷의 프롬프트와 레퍼런스 이미지 주소(2시간 유효)를 내주고, 결과 영상 URL을 컷의 테이크로 받습니다. 영상 생성 자체는 Claude의 힉스필드 커넥터 등 영상 모델 쪽에서 합니다. 실마리 서버는 영상·이미지를 생성하지 않습니다.
- 연결은 「Claude 연결」에서 언제든 끊을 수 있습니다(그 앱의 토큰 폐기). 로그인 없이 쓰는 로컬 모드에서는 작품이 서버에 없어 커넥터를 쓸 수 없습니다.
5. 도구
| 도구 | 하는 일 |
|---|---|
| list_works · get_work | 내 작품 목록, 기획과 목차 |
| get_episode · get_hwa · get_cut | 에피소드, 회차 장부(개요·장부·컷 목록), 컷 상세(대사·연출·테이크·구도) |
| list_characters · get_character · list_places · get_place | 캐릭터·장소 시트 |
| list_clues · list_checks · search_work | 장부 모아 보기(미회수 표시), 점검 항목, 작품 안 검색 |
| create_work · update_work | 새 작품, 기획·무드·아트 디렉션 수정 |
| create_episode · update_episode · delete_episode | 에피소드 |
| create_hwa · update_hwa · delete_hwa | 회차 (컷·장부 포함 가능) |
| add_cuts · update_cut · set_cut_shot · delete_cut | 컷 추가·수정·연출(샷)·삭제 |
| upsert_character · upsert_place · set_sheet_image · delete_sheet | 시트 만들기·고치기, 기준 이미지(URL) 넣기 |
| add_clue · update_clue · add_check · resolve_check | 장부 항목, 점검 항목 |
| get_cut_package · attach_take | 힉스필드 꾸러미(프롬프트·레퍼런스 주소), 영상 URL을 테이크로 |
| list_greybox_sets · list_greybox_vocab · get_stage · stage_plan · stage_patch | 그레이박스 세트·어휘, 무대 읽기, 구성, 조작 |
모든 도구는 요청을 보낸 계정의 작품만 다룹니다. 읽기 도구에는 readOnlyHint, 삭제 도구에는 destructiveHint가 붙어 있습니다. 도구 호출 하나는 수 초 안에 끝납니다(무대 조작은 창의 응답을 최대 40초 기다립니다).
6. 데이터
연결을 허용한 이용자의 작품 사본이 운영자 서버(카페24)에 보관됩니다. 대화 내용은 실마리에 오지 않으며, 도구 호출 기록(도구 이름, 시각, 작품 id)만 남습니다. 자세한 것은 개인정보처리방침의 「AI 앱 연결(커넥터)」 항목을 보세요. 문의: [email protected]
7. 안 될 때
- “Couldn't reach the MCP server” — 서버의
/.well-known/oauth-protected-resource가 열리지 않는 경우입니다. - “Authorization with the MCP server failed” — 로그인 창에서 허용을 누르지 않았거나 10분이 지난 경우입니다. 커넥터를 지우고 다시 추가해 보세요.
- 작품이 안 보일 때 — 실마리 웹에 같은 구글 계정으로 로그인해 작품을 한 번 열어(저장되게) 두세요.