문서 › AI 앱과 Scenaloom 연결하기: 시나리오 MCP 서버

AI 앱과 Scenaloom 연결하기: 시나리오 MCP 서버

Scenaloom의 시나리오 MCP 서버는 내 프로젝트를 평소 쓰는 AI 앱과 연결합니다. Claude, ChatGPT, Cursor, VS Code에 https://scenaloom.com/mcp를 추가하고, Scenaloom에 한 번 로그인해 앱이 할 수 있는 일을 승인하면 끝입니다. 그때부터 앱은 시나리오, 시리즈, 소설을 읽고, 작가가 검토한 뒤에야 반영되는 수정을 제안하고, 메모를 남길 수 있습니다. 대본을 채팅 창에 복사해 붙일 필요가 없습니다.

https://scenaloom.com/mcp

시나리오 MCP 서버로 할 수 있는 일

• 읽기: 프로젝트 목록을 보고, 에피소드를 블록 단위로 또는 장면 하나씩 읽고, 소설의 장을 읽고, 인물, 장소, 소품, 비트, 개요, 댓글을 찾아봅니다.
• 편집: 대본이나 장에 수정을 제안하고, 변경 전과 후를 하나하나 보여 준 뒤 작가가 동의할 때만 적용합니다. 적용한 수정은 같은 순간에 쓰고 있는 사람의 입력과 병합되고, 버전 기록에 남으며, 되돌릴 수 있습니다.
• 댓글: 특정 줄에 고정된 메모를 남기고(어느 앱이 썼는지 표시됩니다), 메모를 해결 처리합니다.
• 생성: 인물 초상, 스토리보드 프레임 같은 생성의 가격을 확인하고, 작가가 크레딧을 확인한 뒤에만 시작합니다.

앱이 붙여 넣은 사본이 아니라 실제 프로젝트에서 일하기 때문에, 이 AI 시나리오 연동 방식에서는 장면, 인물, 기록이 한곳에 그대로 모여 있습니다. 모든 도구는 도구 레퍼런스에 정리되어 있습니다. Claude에서 더 나은 결과를 얻으려면 Scenaloom Agent Skill을 추가하세요. 먼저 읽고, 제안하고, 그다음 적용하는 순서로 Claude가 시나리오를 안전하게 다루는 법을 모델에게 알려 줍니다.

Claude (claude.ai, 데스크톱, 모바일)

1. claude.ai에서 Customize를 열고 Connectors로 들어갑니다.
2. Add, Add custom connector 순으로 고릅니다. 이름은 Scenaloom으로 하고 URL에 https://scenaloom.com/mcp를 붙여 넣습니다.
3. Continue를 누른 뒤 Scenaloom에 로그인하고, 동의 화면에서 권한을 승인합니다.
4. 채팅에서 + 메뉴를 열고 Connectors를 골라 Scenaloom을 켭니다. 이 커넥터는 Claude 데스크톱 앱과 모바일 앱에서도 작동합니다.

Team과 Enterprise 요금제에서는 소유자가 Organization settings의 Connectors에서 커넥터를 한 번만 추가하고, 구성원은 각자의 Scenaloom 계정으로 연결합니다. 무료 Claude 요금제에서는 맞춤 커넥터를 하나만 쓸 수 있습니다. 이 문서의 메뉴 이름은 각 앱의 영어 화면을 기준으로 적었습니다.

Claude Code

터미널에서 서버를 추가한 다음, Claude Code 안에서 로그인합니다.

claude mcp add --transport http scenaloom https://scenaloom.com/mcp

세션에서 /mcp를 실행하고 scenaloom을 고른 뒤 Authenticate를 선택하면 브라우저에 Scenaloom 동의 화면이 열립니다. 모든 프로젝트에서 Scenaloom을 쓰려면 명령 끝에 --scope user를 덧붙이세요. Agent Skill 플러그인을 쓰면 서버와 스킬이 함께 설치됩니다.

ChatGPT

1. ChatGPT에서 Settings, Apps, Advanced settings 순으로 열고 Developer mode를 켭니다.
2. Create app을 고르고 이름을 Scenaloom으로 정한 뒤, MCP 서버 URL에 https://scenaloom.com/mcp를 붙여 넣고 인증 방식으로 OAuth를 고릅니다.
3. Scenaloom에 로그인해 권한을 승인합니다. 채팅에서 + 메뉴를 열고 Developer mode를 고른 다음 Scenaloom을 선택합니다.

Developer mode는 ChatGPT 유료 요금제에서 쓸 수 있고 메뉴 위치가 바뀔 수 있습니다. 최신 경로는 ChatGPT 도움말 페이지에서 확인하세요.

Cursor

~/.cursor/mcp.json(모든 프로젝트) 또는 .cursor/mcp.json(한 프로젝트)에 Scenaloom을 추가한 다음, Cursor Settings의 MCP를 열고 scenaloom 옆의 Connect를 눌러 로그인합니다.

{
  "mcpServers": {
    "scenaloom": {
      "url": "https://scenaloom.com/mcp"
    }
  }
}

VS Code

명령 팔레트에서 MCP: Add Server를 실행해 HTTP를 고르고 URL을 붙여 넣거나, .vscode/mcp.json에 아래 내용을 추가합니다. Copilot이 Scenaloom 도구를 처음 쓸 때 VS Code가 브라우저를 열어 로그인하게 합니다.

{
  "servers": {
    "scenaloom": {
      "type": "http",
      "url": "https://scenaloom.com/mcp"
    }
  }
}

OAuth 방식의 원격 MCP 서버를 지원하는 다른 앱도 똑같이 연결합니다. URL을 입력하고, 앱이 요청할 때 로그인하면 됩니다.

승인하는 권한

앱이 시나리오 MCP 서버에 연결될 때 Scenaloom은 앱의 이름과 웹 주소, 요청하는 권한을 보여 주는 동의 화면을 띄웁니다. 원하지 않는 권한은 체크를 해제하세요.

앱은 내가 열 수 있는 모든 프로젝트에 연결되지만, 프로젝트에서 내 역할보다 큰 권한을 갖지는 않습니다. 내가 뷰어인 프로젝트에서는 편집 권한을 줬더라도 읽기만 할 수 있습니다. 읽기와 편집은 무료를 포함한 모든 요금제에서 쓸 수 있습니다. Scenaloom AI를 쓰는 도구는 앱 안에서 쓸 때와 똑같이 요금제의 어시스턴트 대화와 글쓰기 한도에서 차감됩니다.

수정은 작가가 결정합니다

• 모든 변경은 먼저 제안으로 나옵니다. 앱이 변경 전과 후를 보여 주며, 작가가 수락한 제안을 앱이 적용하기 전까지는 아무것도 바뀌지 않습니다.
• 제안은 에디터의 AI 패널에도 나타나므로, 작가가 직접 클릭 한 번으로 적용할 수도 있습니다.
• 적용한 수정은 같은 장면에서 입력 중인 공동 작업자의 내용과 병합되고, 버전 기록에 저장되며, 되돌릴 수 있습니다.
• 제안 뒤에 대본이 바뀌었다면 Scenaloom은 적용을 거부하고, 앱은 다시 읽고 다시 제안해야 합니다.
• 앱이 쓴 댓글에는 앱 이름이 표시되고, @멘션한 공동 작업자에게는 작가가 확인한 뒤에만 알림이 갑니다.

크레딧과 비용

연결된 앱은 작가가 허용하지 않으면 크레딧을 쓸 수 없습니다. 생성 전에 앱은 Scenaloom에 견적을 요청하고, 정확한 비용과 잔액을 알려 준 뒤, 작가가 승인해야 시작합니다. 확인 화면을 띄울 수 없는 앱은 동의 화면이나 연결된 앱에서 정한 일일 한도 안에서만 쓸 수 있습니다. 한도는 0(기본값, 지출 불가)부터 24시간당 500 크레딧까지 정할 수 있습니다. 환불은 크레딧 정책을 따릅니다.

활동 기록 확인과 연결 해제

계정 설정에서 연결된 앱을 찾으세요. 앱마다 연결한 시각, 마지막 사용 시각, 권한, 일일 크레딧 한도, 앱이 한 일의 기록이 표시됩니다. 연결 해제를 누르면 바로 차단되어 다음 요청부터 실패합니다. 모든 앱 연결 해제는 모든 앱에 같은 조치를 합니다. 계정을 복구하거나, 이메일 주소를 바꾸거나, 모든 기기에서 로그아웃해도 모든 앱의 연결이 해제됩니다. 앱의 로그인은 최대 90일 동안 유지되며, 그 뒤에는 다시 승인해야 합니다.

문제 해결

• 앱이 권한이 없다고 할 때: 앱에서 다시 로그인하세요(예: Claude Code의 /mcp). 연결을 해제한 앱과 90일이 지난 로그인은 새로 승인해야 합니다.
• 대본이 바뀌어 수정이 거부될 때: 앱이 읽은 뒤 누군가 대본을 고친 것입니다. 장면을 다시 읽고 수정을 다시 제안해 달라고 앱에 요청하세요.
• 읽기는 되는데 편집이 안 될 때: 대본과 소설 편집 권한을 주지 않았거나, 그 프로젝트에서 내 역할이 뷰어 또는 댓글 작성자입니다. 권한을 바꾸려면 연결된 앱에서 앱의 연결을 해제한 뒤 다시 연결하세요.
• 생성이 거부될 때: 앱에 크레딧 사용 권한이 없거나, 잔액이 부족하거나, 일일 한도를 다 썼습니다.
• 요청이 너무 많다고 할 때: 앱이 알려 주는 몇 초를 기다렸다가 다시 시도하세요.