OpenCode
OpenCodeにShotomaticをローカルのMCPサーバーとして追加し、動作を確認して、よくある設定の問題を解決します。
更新日 2026年11月16日
OpenCodeでは、ShotomaticのローカルMCPサーバー経由でShotomaticを使えます。以下の手順はOpenCodeの公式ドキュメント(OpenCode MCP servers)に沿っています。ShotomaticはClaude CodeとCodexで動作を確認しており、OpenCodeでは確認していません。メニューやファイルが合わない場合は、OpenCodeのドキュメントを確認してください。
始める前に
- Shotomaticで設定 > AIエージェントを開き、AIエージェントにShotomaticの使用を許可をオンにします。
- Node 18.3以降をインストールします。クライアントは
shotomaticという小さなブリッジパッケージをnpxで起動します。APIキーはありません。 - Macでは画面収録と、キー入力を使う場合はアクセシビリティを許可します。macOSの権限をご覧ください。
OpenCodeにShotomaticを追加する
使いたいプロジェクトで次を実行します。どこでも使えるようにするには、--globalを付けます。
opencode mcp add shotomatic -- npx -y shotomatic mcp
現行(V2)のドキュメントに従って設定を手で編集するには、次をopencode.jsoncに追加します。V1は形式が異なるため、どちらのバージョンか分からない場合は、CLIのコマンドを使ってください。
{
"mcp": {
"servers": {
"shotomatic": {
"type": "local",
"command": ["npx", "-y", "shotomatic", "mcp"]
}
}
}
}
Windowsでクライアントがnpxを起動できない場合は、コマンドにcmd、引数に/c、npx、-y、shotomatic、mcpを指定します。
一度だけ許可する
OpenCodeが初めて接続すると、Shotomaticはクライアントが名乗った名前で許可カードを表示します。許可を選びます。許可するまでの間、エージェントはShotomaticの状態を読むことしかできません。許可と確認をご覧ください。
動作を確認する
opencode mcp listを実行します。そのうえで、次のように依頼します。
「Shotomaticの状態を確認して、Shotomaticで何ができるか教えて。」
正しく設定できていれば、Shotomaticのバージョン、Macでの画面収録とアクセシビリティの権限の有無、プランと今日の無料スクリーンショットの残り、Webサイト用ブラウザがインストール済みか、すでに実行中の撮影が返ってきます。
Shotomaticはプレビューをツールの結果の中の画像として返します。OpenCodeのドキュメントにはその画像がモデルに届くかどうかの記載がないため、エージェントにはテキストしか届かない可能性があります。
ツールが表示されないとき
- 別のプロジェクトでサーバーが表示されない。
--globalを付けて追加し直します。 - "MCP access is turned off." 設定 > AIエージェントでAIエージェントにShotomaticの使用を許可をオンにして、クライアントを再起動します。
- 許可カードが表示されない。 Shotomaticを開いて、カードを探します。Macでは、カードが表示されるとDockのアイコンが跳ねます。
- クライアントが
npxまたはNodeを見つけられない。 すべてのクライアントのトラブルシューティング一覧をご覧ください。
次は、エージェントにできることの依頼を試すか、ツールリファレンスですべてのツールを確認してください。