AI 앱에 부탁하면, 이 도구가 움직입니다.
Claude · ChatGPT 같은 AI 앱은 SSHOW가 내준 도구로 열어 둔 프로젝트를 읽고, 고치고, 프레젠테이션합니다. 도구마다 하는 일과 부탁하는 말을 모았고, 대화에 보이는 도구 이름도 함께 적었습니다.
도구가 움직이는 방식
도구 이름은 몰라도 됩니다. AI 앱은 대화를 읽고 필요한 도구를 스스로 골라 부르고, 한 번의 부탁에 여러 도구를 차례로 쓰기도 합니다.
SSHOW는 AI 앱에 열린 프로젝트부터 확인하고, 처음 고치기 전에 편집 규칙을 읽으라고 알려 줍니다. 그래서 '첫 씬 제목을 키워 줘'라고 하면 보통 프로젝트를 확인하고(list_projects), 규칙을 읽고(get_guide), 씬을 읽고(get_scene), 고치고(apply_actions), 화면을 찍어 결과를 봅니다(get_screenshot).
AI 앱의 편집과 화면 찍기는 내 에디터 안에서 일어나고, 고친 것은 에디터에 바로 반영됩니다. 그래서 프로젝트를 에디터에 열어 두어야 합니다. 클라우드 커넥터로 연결했다면 열린 에디터가 없을 때도 get_project_overview · get_scene · get_object · find_objects 넷은 마지막으로 저장된 내용으로 답합니다. 연결하는 법은 AI 앱 연결에 있습니다.
연결한 방법에 따라 도구가 조금 다릅니다. create_project는 클라우드 커넥터에만 있고, 데스크톱 앱의 MCP 서버에는 없습니다. ChatGPT와 Codex는 편집과 프레젠테이션을 동작마다 나눈 도구로도 받습니다. 그 이름은 편집의 종류와 프레젠테이션과 인터랙션 시험 표에 함께 적었습니다.
프로젝트 찾기와 살펴보기
| 도구 | 하는 일 | 이렇게 부탁하면 |
|---|---|---|
| list_projects | 지금 에디터에 열려 있는 프로젝트를 봅니다. AI 앱은 보통 이 도구부터 부릅니다. 여러 개가 열려 있으면 가장 최근에 작업한 프로젝트가 대상이고, 다른 프로젝트는 이름을 대면 그쪽에서 작업합니다. 열린 것이 없으면 최근에 고친 내 프로젝트 5개와 여는 주소를 알려 줍니다(클라우드 커넥터). | '지금 열려 있는 SSHOW 프로젝트가 뭐야?' |
| create_project | 내 계정에 빈 프로젝트를 만들고 여는 주소를 알려 줍니다. 그 주소를 열어야 AI 앱이 고칠 수 있고, 계정의 프로젝트 수에 들어갑니다. 클라우드 커넥터에만 있습니다. | '신제품 소개라는 새 프로젝트를 만들어 줘' |
| get_project_overview | 프로젝트를 한눈에 봅니다. 캔버스 크기, 씬 목록과 씬마다의 오브젝트 수, 지금 씬, 선택한 오브젝트, 내 화면에 보이는 영역, 변수, 폰트, 들어 있는 미디어, 지금 편집 모드, 프로젝트 노트입니다. | '이 프로젝트 구성을 요약해 줘' |
| get_scene | 씬 하나를 읽습니다. 씬의 이름 · 발표자 노트 · 배경 · 트랜지션 · 타임라인 · 인터랙션과, 씬에 있는 오브젝트의 구조가 나옵니다. 씬을 말하지 않으면 지금 씬을 읽습니다. | '세 번째 씬에 뭐가 있는지 알려 줘' |
| get_object | 오브젝트 하나의 모든 설정과, 캔버스 위의 자리 · 크기를 읽습니다. | '로고의 위치와 크기를 알려 줘' |
| find_objects | 모든 씬에서 이름이나 글자로 오브젝트를 찾습니다. 그룹 · 프레임 안까지 찾고, 한 번에 50개까지 알려 줍니다. | '가격이 적힌 텍스트를 모두 찾아 줘' |
| get_fonts | 텍스트에 쓸 수 있는 폰트를 봅니다. 고를 수 있는 폰트 목록과, 이 프로젝트에 이미 등록된 폰트입니다. 둘 다에 없는 폰트를 쓰면 시스템 폰트로 보이고, AI 앱도 그 사실을 전달받습니다. | '제목에 어울리는 한글 폰트를 골라 줘' |
| get_guide | SSHOW의 편집 규칙 안내서를 읽습니다. SSHOW가 처음 고치기 전에 읽으라고 알려 두어서, 보통 AI 앱이 알아서 부릅니다. | 따로 부탁하지 않아도 됩니다. |
만들고 고치기
| 도구 | 하는 일 | 이렇게 부탁하면 |
|---|---|---|
| apply_actions | 오브젝트 · 씬 · 변수 · 표를 만들고, 고치고, 지웁니다. 한 번에 보낸 편집은 실행 취소 한 번으로 되돌아갑니다. 새 씬을 만들면 에디터가 그 씬으로 넘어가고, 새 오브젝트가 화면 밖에 생기면 화면이 그쪽으로 움직입니다. 애니메이션 모드에서 자동 키프레임이 켜져 있으면, 위치 · 크기 · 불투명도 같은 값을 바꾼 편집은 플레이헤드에 키프레임으로 남고, 오브젝트 만들기 · 지우기 같은 나머지 편집은 그대로 적용됩니다. 할 수 있는 편집은 편집의 종류에 있습니다. | '첫 씬에 제목과 부제를 넣어 줘' · '모든 씬에 트랜지션을 켜 줘' |
| import_asset | 링크로 이미지 · 영상 · 오디오 파일을 프로젝트에 가져옵니다. AI 앱은 가져온 파일을 다음 편집에서 오브젝트로 놓습니다. 링크는 다른 사이트에서 불러가기를 허용한 https 주소여야 합니다. | '이 주소의 사진을 두 번째 씬 배경에 깔아 줘' |
| undo | AI 앱이 마지막으로 한 편집을 되돌립니다. 그 뒤에 내가 고친 것이 있으면 되돌리지 않습니다. 내 편집은 에디터에서 ⌘Z로 되돌리세요. | '방금 바꾼 거 되돌려 줘' |
| redo | AI 앱이 되돌린 편집을 다시 적용합니다. 다시 할 차례가 내 편집이면 하지 않습니다. | '아까 되돌린 거 다시 해 줘' |
편집의 종류
| 편집 | 하는 일 | 대화에 보이는 이름 |
|---|---|---|
| 오브젝트 만들기 | 사각형 · 타원 · 패스 · 텍스트 · 이미지 · 영상 · 오디오 · 그룹 · 프레임 · 표를 새로 만듭니다. | create_object |
| 오브젝트 고치기 | 이름 · 위치 · 크기 · 불투명도 · 글자 · 숨기기 · 잠그기처럼 오브젝트의 설정을 바꿉니다. | update_object |
| 스타일 바꾸기 | 오브젝트의 채우기 · 선 · 효과를 바꿉니다. 씬에 하면 배경이 바뀝니다. | update_object · update_scene (ChatGPT · Codex: set_style) |
| 움직임 넣기 | 씬이나 오브젝트에 트랜지션을 켜고, 타임라인에 키프레임과 정지점을 넣습니다. 트랜지션 다듬기 · 키프레임 다루기 · 정지점과 작업 영역을 보세요. | update_object · update_scene (ChatGPT · Codex: set_motion) |
| 인터랙션 적기 | 씬이나 오브젝트에 인터랙션 문장을 적습니다. 요청 보내기는 새로 만들거나 고치지 않습니다. 인터랙션의 원리 · 요청과 변수를 보세요. | update_object · update_scene (ChatGPT · Codex: set_rules) |
| 지우기 · 복제하기 | 오브젝트를 지우거나 복제합니다. 그룹 · 프레임을 지우면 안에 든 것도 함께 지워집니다. | delete_object · duplicate_object |
| 순서 바꾸기 | 오브젝트를 맨 앞 · 맨 뒤 · 한 칸 앞 · 한 칸 뒤로 보내거나, 그룹 · 프레임 안팎으로 옮깁니다. 캔버스 위의 자리는 그대로입니다. | move_object (ChatGPT · Codex: arrange_object) |
| 그룹 만들기 · 풀기 | 오브젝트 여럿을 그룹으로 묶거나, 그룹을 풉니다. | group_objects · ungroup |
| 패스로 바꾸기 | 사각형이나 타원을 같은 모양의 패스로 바꿉니다. 텍스트 · 이미지 · 안쪽 반지름을 준 타원 같은 다른 것은 바꾸지 못하고, 섞여 있으면 그때 보낸 편집이 하나도 적용되지 않습니다. 텍스트는 우클릭해 패스로 변환을 누르세요. | convert_to_path |
| 표 행 · 열 | 표에 행이나 열을 더하거나 지웁니다. | insert_table_rows · insert_table_columns · delete_table_rows · delete_table_columns |
| 표 칸 합치기 · 나누기 | 표의 칸 여럿을 하나로 합치거나, 합친 칸을 다시 나눕니다. | merge_table_cells · unmerge_table_cells |
| 씬 다루기 | 씬을 더하고, 이름 · 발표자 노트 · 숨기기를 바꾸고, 지우고, 복제합니다. | create_scene · update_scene · delete_scene · duplicate_scene |
| 씬 순서 바꾸기 | 씬을 다른 자리로 옮깁니다. | move_scene (ChatGPT · Codex: reorder_scene) |
| 캔버스 크기 | 모든 씬이 함께 쓰는 캔버스 크기를 바꿉니다. | set_scene_size (ChatGPT · Codex: set_canvas_size) |
| 변수 다루기 | 변수를 더하고, 이름 · 종류 · 값을 바꾸고, 지웁니다. | create_variable · update_variable · delete_variable |
| 변수 순서 바꾸기 | 변수 목록에서 변수를 다른 자리로 옮깁니다. | move_variable (ChatGPT · Codex: reorder_variable) |
| 프로젝트 정보 | 프로젝트 이름 · 설명 · 노트를 바꿉니다. 바꾼 이름은 Studio의 프로젝트 이름에도 반영됩니다. | set_document (ChatGPT · Codex: update_document) |
화면으로 확인하고 보여 주기
| 도구 | 하는 일 | 이렇게 부탁하면 |
|---|---|---|
| get_screenshot | 씬이나 오브젝트 하나를 지금 모습 그대로 찍어 AI 앱이 봅니다. 고친 결과를 확인할 때 씁니다. 씬은 어느 씬이든 찍지만, 오브젝트 하나와 타임라인의 한 시점은 지금 씬에서만 찍습니다. 시점을 맞춰 찍은 뒤에는 원래대로 돌려 놓고, 찍은 그림은 프로젝트에 저장되지 않습니다. | '두 번째 씬이 어떻게 보이는지 확인해 줘' · '1초 지점 모습을 보여 줘' |
| set_active_scene | 내 에디터를 다른 씬으로 옮깁니다. 고친 곳을 보여 주거나, 그 씬의 오브젝트를 찍고 선택하기 전에 씁니다. 문서는 바뀌지 않아 실행 취소에 남지 않습니다. | '네 번째 씬 열어 줘' |
| select_objects | 지금 씬의 오브젝트를 선택해 어디인지 보여 줍니다. 아무것도 고르지 않으면 선택을 풉니다. | '방금 고친 버튼을 선택해서 보여 줘' |
프레젠테이션과 인터랙션 시험
AI 앱은 내 에디터 창 안에서 프레젠테이션을 시작하고 진행합니다. 프레젠테이션 중이나 인터랙션 미리보기 중에는 클릭 같은 입력을 보내 인터랙션을 시험합니다. 미리보기는 미리보기로 확인하기에, 입력마다 반응하는 트리거는 트리거·액션·조건에 있습니다.
이 도구들은 문서를 바꾸지 않아 실행 취소할 것이 없습니다.
프레젠테이션은 재생 링크를 연 사람에게도 보입니다
관객과 라이브로 공유는 처음에 켜져 있어서, AI 앱이 넘긴 씬이 재생 링크를 열어 둔 사람의 화면에도 나옵니다. 혼자 시험하려면 재생 설정에서 이 설정을 끄세요. 이 설정과 상관없이, 프레젠테이션이나 시험 중에 실행된 요청 보내기와 URL 열기는 실제로 일어나고 되돌릴 수 없습니다.
| 도구 | 하는 일 | 이렇게 부탁하면 |
|---|---|---|
| get_show_state | 프레젠테이션이 어디까지 왔는지 읽습니다. 지금 씬과 다음 씬, 발표자 노트, 정지점, 다음에 넘기면 일어날 일, 화면 가림, 지난 시간처럼 발표자 보기가 보여 주는 것과 같습니다. | '지금 몇 번째 씬이야?' · '이 씬 노트 읽어 줘' |
| control_show | 프레젠테이션을 시작하고, 넘기고, 건너뛰고, 멈추고, 화면을 가리고, 끝냅니다. 프레젠테이션은 에디터 창 안에서 열립니다. 전체 화면으로 부탁하면 화면 크기로 열리고, 내가 프레젠테이션 화면을 처음 클릭할 때 전체 화면이 됩니다. 동작은 아래 표에 있습니다. | '지금 씬부터 프레젠테이션해 줘' |
| simulate_event | 입력 하나를 보내고, 어떤 인터랙션이 실행됐는지와 어떤 것이 왜 건너뛰어졌는지를 화면과 함께 봅니다. 보낼 수 있는 입력은 누르기 · 더블클릭 · 길게 누르기 · 누르는 순간 · 떼는 순간 · 포인터가 들어오기 · 나가기 · 스와이프 · 키 누르기 · 메시지입니다. AI 앱이 보낸 클릭은 받는 인터랙션이 없으면, 실제 프레젠테이션의 클릭과 달리 씬을 넘기지 않습니다. 씬을 넘길 때는 control_show의 다음을 씁니다. | '시작 버튼을 누르면 다음 씬으로 가는지 시험해 줘' |
| 프레젠테이션 동작 | 하는 일 | control_show · ChatGPT · Codex |
|---|---|---|
| 시작 | 지금 씬부터, 또는 처음부터 프레젠테이션을 시작합니다. | start · show_start |
| 다음 | 클리커처럼 넘깁니다. 씬에 정지점이 있으면 하나씩 재생하고, 그다음 다음 씬으로 갑니다. | next · show_next |
| 이전 | 클리커의 뒤로 버튼처럼 한 단계 돌아갑니다. | previous · show_previous |
| 씬으로 건너뛰기 | 고른 씬으로 바로 갑니다. 숨긴 씬으로는 가지 않습니다. | goTo · show_go_to |
| 멈춤 · 다시 재생 | 씬의 타임라인을 그 자리에 멈추거나, 멈춘 타임라인을 다시 움직입니다. | togglePlayback · show_toggle_playback |
| 화면 가리기 | 화면을 검게 또는 하얗게 가립니다. 같은 색으로 한 번 더 하면 씬이 다시 보입니다. | toggleCover · show_toggle_cover |
| 프레젠테이션 끝내기 | '재생 끝' 카드를 띄워 프레젠테이션을 끝냅니다. | endShow · show_end |
| 편집으로 돌아가기 | 프레젠테이션을 닫고 편집 화면으로 돌아옵니다. | exit · show_exit |
AI 앱이 하지 않는 일
| 일 | 설명 |
|---|---|
| 파일로 내보내기 | 영상 · PDF 같은 파일을 만드는 도구는 없습니다. 내보내기에서 직접 내보내세요. |
| 공유와 초대 | 재생 링크 설정과 함께 편집할 사람 초대는 AI 앱이 하지 않습니다. 링크로 공유 · 함께 편집을 보세요. |
| 프로젝트 지우기 | 프로젝트를 지우는 도구는 없습니다. 씬과 오브젝트는 지울 수 있고, 지운 것은 실행 취소로 되돌아갑니다. |
| 내 편집 되돌리기 | AI 앱은 자기 편집만 되돌립니다. 내 편집은 에디터에서 ⌘Z로 되돌리세요. |
| 요청 보내기 만들기 | 웹 요청을 보내는 인터랙션은 새로 만들거나 내용을 고치지 않습니다. 다만 AI 앱이 인터랙션을 다시 적으면서 요청 보내기가 든 문장을 빼면 그 요청도 지워집니다. 사라졌다면 실행 취소로 되돌리세요. 새 요청은 요청과 변수를 보고 직접 적으세요. |
| 요청의 비밀 값 읽기 | AI 앱이 읽는 요청 보내기에서 헤더 값과 주소의 쿼리 값은 별표로 가려집니다. 그 자리에 넣은 API 키는 AI 앱에 보이지 않습니다. 요청의 본문에 넣은 값은 가려지지 않으니, 비밀 값은 헤더에 넣으세요. |
| 다른 계정의 프로젝트 | AI 앱은 연결할 때 허용한 계정의 프로젝트만 봅니다. 다른 계정으로 로그인한 에디터는 AI 앱에 보이지 않습니다. |
대화에서 자주 생기는 일
-
열린 프로젝트가 없다고 하나요?
AI 앱의 편집과 화면 찍기는 열려 있는 에디터에서 일어납니다. AI 앱에 허용한 계정으로 로그인한 에디터에서 프로젝트를 열고 다시 부탁하세요. -
도구를 쓸 때마다 왜 허락을 묻나요?
SSHOW는 도구마다 읽기만 하는지, 되돌리기 어려운 일을 하는지, 프로젝트 밖에 닿는지 표시해 두고, AI 앱은 이 표시를 보고 고치는 도구 앞에서 허락을 묻기도 합니다. 허락하는 방식은 AI 앱마다 다르니, 그 앱의 안내를 따르세요. -
고쳤다는데 왜 화면은 그대로인가요?
AI 앱이 내가 보고 있지 않은 다른 씬을 고쳤을 수 있습니다. 그 씬으로 옮겨 달라고 부탁하거나, 씬 목록에서 그 씬을 고르세요. -
부탁한 것 중 일부만 바뀌었나요?
apply_actions는 잘못된 편집만 건너뛰고 나머지는 적용합니다. 건너뛴 이유를 AI 앱에 물어 다시 부탁하거나, 그 부분은 직접 고치세요. -
되돌려 달라고 했는데 왜 못 한다고 하나요?
그 뒤에 내가 고친 것이 있으면 AI 앱은 되돌리지 않습니다. 에디터에서 ⌘Z를 눌러 직접 되돌리세요. -
사진을 가져오지 못한다고 하나요?
그 사이트가 다른 사이트에서 파일을 불러가지 못하게 막아 둔 경우입니다. 사진을 내려받아 에디터에 직접 넣으세요. -
폰트가 부탁한 것과 다르게 보이나요?
고를 수 있는 폰트 목록에도, 이 프로젝트에 등록된 폰트에도 없는 폰트는 시스템 폰트로 보입니다. get_fonts에 나오는 폰트 가운데서 골라 달라고 부탁하세요. -
새 프로젝트를 만들 수 없다고 하나요?
데스크톱 앱의 MCP 서버에는 프로젝트를 만드는 도구가 없고, 계정의 프로젝트 수가 다 찼을 때도 만들지 못합니다. 직접 새 프로젝트를 만들어 열거나, 쓰지 않는 프로젝트를 정리한 뒤 다시 부탁하세요. -
편집 권한이 없다고 하나요?
그 AI 앱이 연결할 때 읽기 권한만 받았습니다. 설정에서 연결을 끊고, AI 앱에서 다시 연결하세요.
2026년 10월 11일에 고침 · 이 페이지의 영상은 현재 에디터로 녹화했습니다.