도구 레퍼런스
Shotomatic이 AI 에이전트에 제공하는 MCP 도구 전체와 각 도구의 역할, 먼저 확인을 받는 도구, Pro가 필요한 기능을 정리했습니다.
업데이트 2026년 11월 16일
이 페이지는 Shotomatic 1.10.1이 허용된 에이전트에 제공하는 MCP 도구를 정리합니다. 에이전트는 연결할 때 같은 목록을 전체 입력 스키마와 함께 읽습니다. 사용자가 직접 호출하는 도구는 아니지만, 알아 두면 요청을 정확히 쓰고 에이전트의 보고를 이해하기 쉽습니다.
작업별 도구
| 에이전트에게 맡길 일 | 사용하는 도구 |
|---|---|
| 권한, 플랜, 실행 중인 작업 확인 | get_status |
| 화면에 무엇이 있는지 보기 | list_capture_sources, capture_snapshot, capture_window_snapshot |
| 키를 누르며 창을 반복 캡처 | start_auto_capture, get_job, control_job |
| 클릭 단계 가이드 기록 | start_action_capture, get_job, control_job |
| 웹 페이지 캡처 | preview_website, capture_websites, get_job, control_job |
| 웹사이트 설정 재사용·예약 | website_capture_options, website_workflows |
| 지난 캡처 찾아보기 | list_capture_sessions, get_capture_session, view_images |
| 문서 만들기와 편집 | list_documents, get_document, create_document, add_pages, edit_document |
| 파일로 꺼내기 | export, get_job |
| 정리하기 | delete_items, rename_capture_session |
| 캡처·내보내기 설정 바꾸기 | update_settings |
오래 걸리는 작업은 바로 작업 ID를 돌려줍니다. 에이전트는 get_job으로 작업을 따라가며, 한 번 호출에 최대 50초까지 기다립니다. 그래서 긴 캡처도 호출 사이에 Shotomatic에서 계속 실행됩니다.
상태와 캡처 대상
get_status
앱 버전, 화면 기록과 손쉬운 사용 권한 허용 여부, 플랜과 오늘 남은 무료 스크린샷 수, 기능 한도, 진행 중인 작업, 웹사이트 브라우저 설치 여부, 현재 설정을 알려 줍니다. 에이전트는 이 도구를 가장 먼저 호출하고, 사용자가 문제를 고친 뒤에도 다시 호출합니다.
list_capture_sources
Shotomatic이 캡처할 수 있는 창과 화면을 ID, 이름, 앱 이름과 함께 보여 줍니다.
capture_snapshot
창이나 화면을 미리 보고 원하는 페이지가 열려 있는지 확인합니다. 미리 보기는 작은 JPEG이며 캡처 기록에 저장되지 않고 무료 스크린샷도 쓰지 않습니다.
capture_window_snapshot
창 하나의 PNG 스냅숏을 찍어 에이전트에 돌려줍니다. capture_snapshot처럼 저장되지 않습니다.
캡처와 작업
start_auto_capture
창 하나를 일정한 간격으로 캡처하고, 스크린샷마다 페이지를 넘기는 오른쪽 화살표 같은 키를 누를 수 있습니다. Shotomatic은 창을 앞으로 가져오며, 다른 창이 앞에 있거나 화면이 잠겨 있으면 키를 누르지 않고 작업을 멈춥니다. 키를 누르는 캡처는 페이지가 더 이상 바뀌지 않으면 스스로 끝납니다. 중지 조건은 플랜에 따릅니다. 중지 조건, 간격, 키 입력을 참고하세요.
start_action_capture
Action Capture를 시작합니다. 선택한 창에서 클릭할 때마다 단계가 저장되고, 캡처를 멈추면 문서가 만들어집니다. Shotomatic이 대신 클릭하지는 않습니다. 사용자가 클릭하거나, 자체 컴퓨터 사용 기능이 있는 에이전트가 클릭합니다.
get_job
앞서 시작한 캡처, 웹사이트 배치, 내보내기를 확인하고 진행 상황을 기다릴 수 있습니다.
control_job
실행 중인 작업을 조정합니다. 자동 캡처는 일시 정지, 재개, 중지(이미 찍은 스크린샷은 유지)를 할 수 있습니다. Action Capture는 중지해서 문서를 만들거나, 클릭 없이 단계를 저장할 수 있습니다. 웹사이트 배치는 배치 전체를 취소하거나, 페이지 하나를 취소하거나 다시 시도할 수 있습니다.
웹사이트 캡처
preview_website
URL 하나를 지정한 옵션으로 Shotomatic의 브라우저에서 렌더링해 결과를 에이전트에 보여 줍니다. 배치 전에 옵션을 맞출 때 씁니다. 미리 보기는 저장되지 않습니다.
capture_websites
웹 페이지 목록을 전체 페이지나 화면 영역으로, 데스크톱·태블릿·모바일 크기로 캡처해 캡처 세션 하나에 담거나, 저장한 워크플로를 바로 실행합니다. 사용자의 화면은 쓰지 않습니다. 웹사이트 브라우저가 필요합니다. 웹사이트 캡처를 참고하세요.
website_capture_options
웹사이트 캡처에 저장한 옵션을 보거나, 읽거나, 저장합니다. 에이전트는 저장한 옵션을 삭제할 수 없습니다.
website_workflows
워크플로를 보거나, 읽거나, 저장하거나, 일시 정지하거나, 재개합니다. 일정은 5분 이상의 간격이나 매일 정한 시각으로 정할 수 있습니다. 일정이 있는 워크플로를 저장하거나 재개할 때는 사용자의 확인을 기다리며, 일시 정지는 확인 없이 됩니다. 예약 실행은 Shotomatic이 열려 있을 때만 이뤄지고, 앱이 닫혀 있는 동안 놓친 실행은 나중에 채우지 않습니다. 에이전트는 워크플로를 삭제할 수 없습니다.
캡처 기록
list_capture_sessions
캡처 세션을 최신순으로, 프레임 수와 그 세션으로 만든 문서가 있다면 그 문서와 함께 보여 줍니다.
get_capture_session
세션 하나를 읽습니다. 요약, 한 번에 최대 200개씩 나눈 프레임 파일 경로, 웹사이트 캡처라면 페이지별 상태를 돌려줍니다.
rename_capture_session
Shotomatic에 표시되는 세션 이름을 바꿉니다.
view_images
캡처 기록의 프레임이나 문서 페이지를 이미지로 에이전트에 보여 줍니다. 한 번에 최대 6장, 합계 8MB까지입니다. 문서 페이지는 자르기와 주석 없이 원본 이미지로 보입니다. 에이전트가 본 이미지는 그 에이전트의 대화에 포함됩니다.
문서
list_documents
문서를 최근에 바뀐 순서로 보여 줍니다.
get_document
문서의 제목, 리비전, 페이지별 텍스트·프레이밍·주석을 읽습니다.
create_document
캡처 세션의 프레임, 이미지 파일, 빈 페이지로 문서를 만듭니다. 이미 문서가 있는 세션 전체를 고르면 복사본 대신 그 문서를 돌려줍니다.
add_pages
캡처 세션의 프레임이나 이미지 파일로 페이지를 끝이나 지정한 페이지 뒤에 추가합니다.
edit_document
문서를 한 번에 바꿉니다. 제목, 페이지 제목과 설명, 프레이밍, 주석, 페이지 순서, 페이지 복제와 삭제, 워터마크를 다룹니다. 일부가 실패하면 아무것도 바뀌지 않습니다. 흐림, 마커, 클릭 마커, 워터마크에는 Pro가 필요합니다. 편집기에 열려 있는 문서라면 편집기가 다시 불러옵니다.
내보내기와 설정
export
문서는 PDF, PNG, JPG, WebP, ZIP으로, 캡처 세션의 프레임은 ZIP, PNG, JPG, 검색 가능한 PDF, MP4로 내보냅니다. 파일은 새 이름으로 내보내기 폴더에 저장되고, 기존 파일을 덮어쓰지 않으며, 화면에 아무것도 열리지 않습니다.
update_settings
자동 내보내기(켜기·끄기, PNG·JPG), JPG 품질, 캡처 기록에 남길 세션 수를 바꿉니다. 세션이 지워지는 낮은 한도는 먼저 사용자에게 묻습니다. 내보내기 폴더, 언어, 프리셋, 라이선스는 바꿀 수 없습니다.
삭제
delete_items
문서나 캡처 세션을 한 번에 최대 50개까지 삭제합니다. Shotomatic은 모든 항목을 나열한 확인 카드를 한 번 보여 주고 최대 1분 동안 답을 기다립니다. 캡처 세션을 삭제해도 그 세션으로 만든 문서는 지워지지 않습니다. 허용과 확인을 참고하세요.
도구가 오류를 돌려주면 에이전트 오류와 해결 방법을 참고하세요.