ツールリファレンス
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 |
| Webページを撮影する | preview_website, capture_websites, get_job, control_job |
| Webサイトの設定を再利用・予約する | 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でジョブを追い、1回の呼び出しで最大50秒待ちます。そのため、長い撮影も呼び出しの合間にShotomatic側で進み続けます。
状態と撮影対象
get_status
アプリのバージョン、画面収録とアクセシビリティの権限の有無、プランと今日の無料スクリーンショットの残り、機能の上限、実行中のジョブ、Webサイト用ブラウザがインストール済みか、現在の設定を返します。エージェントは最初にこれを呼び出し、ユーザーが問題を直したあとにも呼び出します。
list_capture_sources
Shotomaticで撮影できるウインドウと画面を、ID、名前、アプリ名とともに一覧にします。
capture_snapshot
ウインドウや画面をプレビューして、目的のページが開いているかを確認します。プレビューは縮小したJPEGで、キャプチャ履歴には保存されず、無料のスクリーンショットも消費しません。
capture_window_snapshot
1つのウインドウのPNGスナップショットを撮ってエージェントに返します。capture_snapshotと同じく保存されません。
撮影とジョブ
start_auto_capture
1つのウインドウを一定の間隔で撮影し、1枚ごとにページ送りの右矢印キーなどを押せます。Shotomaticはウインドウを前面に出し、別のウインドウが前面にあるときや画面がロックされているときはキーを押さず、ジョブを一時停止します。キーを押す撮影は、ページが変わらなくなると自動で停止します。停止条件はプランによります。停止条件、撮影間隔、キー入力をご覧ください。
start_action_capture
操作キャプチャを開始します。選んだウインドウでクリックするたびに手順が保存され、撮影を止めるとドキュメントが作られます。Shotomaticが代わりにクリックすることはありません。クリックはユーザーが行うか、コンピュータ操作の機能を持つエージェントが行います。
get_job
先に始めた撮影、Webサイトのバッチ、書き出しを確認し、進み具合を待てます。
control_job
実行中のジョブを操作します。自動キャプチャでは一時停止、再開、停止(撮影済みのスクリーンショットは残す)ができます。操作キャプチャでは停止してドキュメントを作るか、クリックせずに手順を保存できます。Webサイトのバッチでは、バッチ全体の取り消し、または1ページの取り消しや再試行ができます。
Webサイトキャプチャ
preview_website
1つのURLを指定のオプションでShotomaticのブラウザに表示し、結果をエージェントに見せます。バッチの前にオプションを調整するときに使います。プレビューは保存されません。
capture_websites
Webページの一覧を、ページ全体または表示範囲で、デスクトップ・タブレット・モバイルのサイズで撮影し、1つのキャプチャセッションにまとめます。保存済みのワークフローをすぐに実行することもできます。ユーザーの画面は使いません。Webサイト用ブラウザが必要です。Webサイトキャプチャのクイックスタートをご覧ください。
website_capture_options
Webサイトキャプチャの保存済みオプションを一覧、読み込み、保存します。エージェントは保存済みオプションを削除できません。
website_workflows
ワークフローを一覧、読み込み、保存、一時停止、再開します。スケジュールは5分以上の間隔か、毎日の時刻で指定します。スケジュール付きのワークフローを保存または再開するときはユーザーの確認を待ちますが、一時停止に確認は不要です。予定の実行はShotomaticが開いているときだけ行われ、閉じている間に逃した実行は後から補われません。エージェントはワークフローを削除できません。
キャプチャ履歴
list_capture_sessions
キャプチャセッションを新しい順に、フレーム数と、そのセッションから作ったドキュメントがあればそのドキュメントとともに一覧にします。
get_capture_session
1つのセッションを読み込みます。概要、最大200件ずつに区切ったフレームのファイルパス、Webサイトキャプチャならページごとの状態を返します。
rename_capture_session
Shotomaticに表示されるセッション名を変更します。
view_images
キャプチャ履歴のフレームやドキュメントのページを画像としてエージェントに見せます。1回につき最大6枚、合計8MBまでです。ドキュメントのページは、切り抜きや注釈のない元画像で表示されます。エージェントが見た画像は、そのエージェントの会話に含まれます。
ドキュメント
list_documents
ドキュメントを、最近変更した順に一覧にします。
get_document
ドキュメントのタイトル、リビジョン、ページごとのテキスト、表示範囲、注釈を読み込みます。
create_document
キャプチャセッションのフレーム、画像ファイル、空白ページからドキュメントを作ります。すでにドキュメントがあるセッション全体を選ぶと、コピーを作らずにそのドキュメントを返します。
add_pages
キャプチャセッションのフレームや画像ファイルから、末尾または指定したページの後ろにページを追加します。
edit_document
ドキュメントを1回の操作で変更します。タイトル、ページのタイトルと説明、表示範囲、注釈、ページの順序、ページの複製と削除、透かしを扱います。一部でも失敗すると何も変わりません。ぼかし、マーカー、クリックマーカー、透かしにはProが必要です。エディタで開いているドキュメントなら、エディタが読み込み直します。
書き出しと設定
export
ドキュメントはPDF、PNG、JPG、WebP、ZIPで、キャプチャセッションのフレームはZIP、PNG、JPG、検索可能なPDF、MP4で書き出します。ファイルは新しい名前で書き出し先フォルダに保存され、既存のファイルを上書きせず、画面には何も開きません。
update_settings
自動書き出し(オン・オフ、PNG・JPG)、JPGの画質、キャプチャ履歴に残すセッション数を変更します。セッションが削除されるほど上限を下げる場合は、先にユーザーに確認します。書き出し先フォルダ、言語、プリセット、ライセンスは変更できません。
削除
delete_items
ドキュメントやキャプチャセッションを、1回で最大50件まで削除します。Shotomaticはすべての項目を並べた確認カードを1回表示し、最大1分間返事を待ちます。キャプチャセッションを削除しても、そこから作ったドキュメントは削除されません。許可と確認をご覧ください。
ツールがエラーを返したときは、エージェントのエラーと対処法をご覧ください。