エージェントのアクセスの仕組み
Claude、CodexなどのAIエージェントがローカルのMCPサーバーでShotomaticアプリを使う仕組み、ユーザーが決められること、最初に読むページを案内します。
更新日 2026年11月16日
Claude Code、Claudeアプリ、CodexなどのAIエージェントは、MacやWindows PCのShotomaticを使えます。エージェントが使うのは、自動キャプチャ、操作キャプチャ、Webサイトキャプチャ、キャプチャ履歴、ドキュメント、書き出しといった、ユーザーと同じ機能です。欲しい結果を伝えれば、手順はエージェントが決めます。
依頼がShotomaticに届くまで
エージェントはModel Context Protocol、つまりMCPで接続します。ShotomaticのMCPサーバーはローカルで動きます。
- エージェントがパソコン上で小さなブリッジを起動します。設定の接続はShotomaticに同梱されたブリッジを登録し、ほかのクライアントは
npx -y shotomatic mcpでshotomaticパッケージを起動します。 - ブリッジは、Macではソケット、Windowsでは名前付きパイプという非公開のローカル接続で、エージェントの依頼をShotomaticアプリに渡します。Shotomaticが起動していなければ、ブリッジがバックグラウンドで開きます。
- Shotomaticが撮影や書き出しなどの依頼を実行し、結果をエージェントに返します。
ホストされたShotomaticのサーバーも、サインインするアカウントも、APIキーもありません。Shotomaticはネットワークポートを開かず、接続できるのは自分のユーザーアカウントだけです。エージェントが見た画像はそのエージェントの会話に含まれ、エージェントの提供元の規約に沿って扱われます。
ユーザーが決められること
- アクセスのスイッチ: 設定 > AIエージェントのAIエージェントにShotomaticの使用を許可は、初期状態でオフです。オフにすると、すべてのエージェントの接続が切れます。
- エージェントごとに一度だけの許可: 設定から接続していないエージェントは、許可カードで一度許可する必要があります。
- 確認: エージェントが何かを削除するとき、セッションが消えるほどキャプチャ履歴の上限を下げるとき、ワークフローのスケジュールを設定するときは、事前にShotomaticが確認します。
- いつでも止められる: エージェントが始めた撮影にも通常の撮影ツールバーが表示され、ステータス行の切断ですべてのエージェントの接続を切れます。
エージェントは、ユーザーのプランとmacOSの権限をそのまま使います。制限と安全性をご覧ください。
接続方法を選ぶ
| 使っているエージェント | 接続方法 |
|---|---|
| Claude Code、Claudeアプリ、Codex | 設定の接続、Node不要 |
| Cursor、VS Code、Gemini CLI、Zedなど | クライアントごとのコマンドまたは設定項目 |
次に読むページ
- AIエージェントを接続する:アクセスをオンにして、ワンクリックで接続します。
- すべてのAIエージェントクライアント:20のクライアントそれぞれに設定ページがあります。
- エージェントにできること:そのまま使える依頼の例です。
- ツールリファレンス:Shotomaticが提供するすべてのMCPツールです。
- エージェントのエラーと対処法:エラーコードごとに、ユーザーがすることをまとめています。
- 制限と安全性:エージェントにできないことです。