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