내 AI를 Scene24에 연결하기

Scene24 커넥터를 쓰면 이미 쓰고 있는 AI가 Scene24로 영상을 만듭니다. 제품 사이트와 브랜드를 읽고, 레퍼런스 광고의 문법으로 영상을 빌드하고, 미리보기 스틸을 보며 어색한 부분을 고친 뒤, Scene24 에디터에서 영상을 건네줍니다.

생각은 내 AI가 그쪽 요금제로 하고, Scene24는 캡처, 빌드, 검사, 렌더링을 맡습니다. Claude Code, Codex CLI, ChatGPT, claude.ai와 Claude Desktop에서 쓸 수 있습니다.

설정

모든 앱이 같은 주소로 연결합니다:

https://api.scene24.so/mcp

Claude Code

내 AI에서 Claude Code를 고르고 연결을 만드세요. 표시되는 명령을 터미널에 붙여 넣으면 모든 프로젝트에 Scene24가 추가됩니다. Claude Code에서 /mcp를 실행하면 연결된 것을 볼 수 있습니다. Claude Code는 키 없이 로그인할 수도 있습니다. 주소만 추가하고 /mcp를 실행해 인증하세요.

Codex CLI

내 AI에서 Codex CLI를 고르고 연결을 만드세요. 표시되는 키를 셸 프로필에 SCENE24_TOKEN으로 저장한 뒤, ~/.codex/config.toml에 Scene24를 추가하세요:

[mcp_servers.scene24]
url = "https://api.scene24.so/mcp"
bearer_token_env_var = "SCENE24_TOKEN"
tool_timeout_sec = 300

Codex는 도구 하나에 기본 60초를 줍니다. 빌드는 1분 가까이 걸릴 수 있어서 설정에서 tool_timeout_sec를 300으로 올립니다. Codex를 시작하고 /mcp를 실행하면 Scene24가 연결된 것을 볼 수 있습니다.

ChatGPT

ChatGPT에서 Plugins를 열고 +를 누른 뒤 Add custom MCP server를 선택하세요. 이름을 Scene24로 하고 주소를 URL로 붙여 넣은 뒤 OAuth를 선택하세요. 안내를 확인하고 Create as a plugin을 누르세요. ChatGPT가 허용 화면이 있는 Scene24로 보내 주고, 허용하면 알아서 로그인합니다.

커스텀 MCP 서버는 모든 ChatGPT 요금제에 있지는 않으며, 회사나 학교 워크스페이스에서는 관리자가 먼저 허용해야 할 수 있습니다.

claude.ai와 Claude Desktop

Customize, Connectors 순으로 여세요. +를 누르고 Add custom connector를 선택한 뒤 이름을 Scene24로 하고 주소를 붙여 넣으세요. Claude가 제안하는 로그인 방식을 그대로 두고 Add를 누르세요. Claude가 허용 화면이 있는 Scene24로 보내 줍니다.

커스텀 커넥터는 모든 Claude 요금제에서 쓸 수 있고, 무료 요금제는 하나까지입니다. Team이나 Enterprise 요금제에서는 소유자가 먼저 조직에 커넥터를 추가하고, 그다음 각 멤버가 자기 계정을 연결합니다.

연결 확인

내 AI에게 Scene24 연결을 확인해 달라고 하세요. AI가 check_connection을 호출하면, 대신 작업하는 Scene24 계정(일부 가림), 연결 이름, 이번 달 남은 영상 수, 그리고 테스트 카드(단어 하나가 적힌 그림)를 받습니다.

내 AI에도 같은 단어가 나타납니다. AI가 그 단어를 말해 주면 그림이 전달된다는 뜻이고, 영상의 미리보기 스틸도 볼 수 있다는 뜻입니다. ChatGPT나 Claude를 연결하는 동안 이 페이지는 단계마다 따라갑니다: 앱이 Scene24를 찾고, 허용하고, 로그인하고, 첫 호출을 하고, 카드를 읽습니다.

도구

각 도구는 읽기만 하는지 무언가를 바꾸는지 밝히므로, 앱이 언제 먼저 물어봐야 할지 압니다.

읽기

보기만 합니다. 앱이 매번 묻지 않고 실행할 수 있습니다.

check_connection: Scene24가 어떤 계정으로 연결됐는지, 이번 달 남은 영상 수, 그리고 테스트 카드.
get_film_kit_guide: film_kit 설명서와 예제 빌더. AI가 영상을 쓰기 전에 읽습니다.
get_film_kit_api: film_kit의 모든 함수와 시그니처.
list_references: 레퍼런스 광고 목록. 내가 올린 것도 포함하며 이름이나 룩으로 찾을 수 있습니다.
get_reference: 레퍼런스 하나를 비트별로, 광고 전체의 컨택트 시트와 함께.
list_films: 내 영상 목록(최신순)과 이번 달 남은 영상 수.
get_film: 영상의 현재 상태와 브랜드, 화면, 마지막 빌더.
show_panels: 영상의 화면과 로고를 그림 한 장으로.
get_build: 마지막 빌드의 결과, 또는 진행 중인 단계.
wait_for_film: 캡처, 빌드, 미리보기가 끝날 때까지 기다립니다.
get_preview: 영상의 마지막 미리보기 스틸.
get_aspects: 영상을 보여 주고 내보낼 수 있는 화면비와 컷마다의 검사 결과.
get_export: 영상 MP4 내보내기의 진행 상황과, 끝나면 다운로드 링크.

영상 변경

워크스페이스의 영상을 만들거나 바꿉니다. 아무것도 지우지 않으며, 동의하지 않는 한 빌드가 에디터에서 바꾼 내용을 덮어쓰지 않습니다.

start_film: 제품 URL로 영상을 엽니다. 사이트를 캡처하고 브랜드를 읽습니다.
set_brand: Scene24가 읽은 브랜드를 고칩니다: 색, 글꼴, 워드마크, 로고.
request_screens: 로그인 뒤 화면을 요청합니다. 붙여넣거나 올리기만 하면 되는 페이지로 받습니다.
cancel_screens: 요청했지만 더는 필요 없는 화면 요청을 거둡니다.
request_upload: 영상에 쓸 제품 스크린샷을 올리는 링크.
add_panel: 올린 스크린샷을 영상의 화면에 추가합니다.
build_film: 영상의 빌더를 실행하고 결과를 검사한 뒤 영상으로 저장합니다.
edit_film: 빌더의 일부를 바꾸고 다시 빌드합니다.
render_preview: 저장된 영상의 미리보기 스틸을 렌더링합니다.
restore_pass: 영상을 이전 패스로 되돌립니다. 새 패스로 다시 빌드합니다.
export_film: 영상을 원래 화면비나 요청한 컷으로 MP4 렌더링합니다.
share_film: 링크를 가진 누구나 볼 수 있는 공개 링크와 임베드 코드를 만듭니다. 원할 때만 만듭니다.

삭제

영상이나 영상의 공개 공유 링크를 완전히 지웁니다. AI가 어떤 영상인지 말하고 먼저 물어본 뒤에 호출합니다.

delete_film: 확인한 뒤 영상과 그 버전, 내보낸 파일을 완전히 지웁니다.
unshare_film: 영상의 공개 공유 링크를 끝냅니다. 영상과 MP4는 남습니다.

사용하는 데이터

내가 지정한 사이트: Scene24가 방문자처럼 열어 보고, 영상에 쓸 화면, 로고, 색, 글꼴을 보관합니다.
영상을 위해 AI에게 준 스크린샷. 그 영상과 함께 보관됩니다.
내 영상과 그 버전, 미리보기 스틸. Home에서 만든 영상처럼 Scene24 워크스페이스에 있습니다.
대화는 절대 받지 않습니다. Scene24는 AI가 보내는 도구 호출만 받고, 내가 AI에게 한 말은 받지 않으며, 그 앱의 계정도 보지 않습니다.
연결 키는 키 자체가 아니라 지문으로만 저장합니다. 내 AI에 보여 주기 위해 연결마다 마지막 호출(어떤 도구인지, 성공했는지, 얼마나 걸렸는지)을 하루 동안 보관합니다.

한도

AI가 몇 번을 빌드하든 영상 하나는 이번 달에 한 번만 셉니다. 같은 영상을 다른 화면비(9:16, 1:1, 4:5)로 짠 것은 추가 영상이 아닙니다.
사이트를 읽을 수 없었거나 빌드를 한 번도 못 한 영상은 이번 달 한도로 돌려드립니다. 한 달에 세 편까지입니다.
모든 호출은 약 50초 안에 답합니다. 더 긴 작업은 계속 진행되고, 답에 다음에 무엇을 호출할지 나와 있어서 같은 작업이 두 번 돌지 않습니다.
영상 하나에 빌드 60회, 미리보기 렌더링 30회까지.
연결은 한 번에 열 개까지. 만료된 앱 연결은 세지 않습니다.

연결 해제

내 AI에서 연결을 해제하면 그 앱의 접근이 즉시 끊깁니다. 앱 안에서 Scene24를 제거해도 됩니다.

내 AI 열기