ユーザーガイドを開く

GitHub Copilot CLI

GitHub Copilot CLIにShotomaticをローカルのMCPサーバーとして追加し、動作を確認して、よくある設定の問題を解決します。

更新日 2026年11月16日

Markdownを表示
このページの内容

GitHub Copilot CLIでは、ShotomaticのローカルMCPサーバー経由でShotomaticを使えます。以下の手順はGitHub Copilot CLIの公式ドキュメント(Adding MCP servers to Copilot CLI)に沿っています。ShotomaticはClaude CodeとCodexで動作を確認しており、GitHub Copilot CLIでは確認していません。メニューやファイルが合わない場合は、GitHub Copilot CLIのドキュメントを確認してください。

始める前に

  • Shotomaticで設定 > AIエージェントを開き、AIエージェントにShotomaticの使用を許可をオンにします。
  • Node 18.3以降をインストールします。クライアントはshotomaticという小さなブリッジパッケージをnpxで起動します。APIキーはありません。
  • Macでは画面収録と、キー入力を使う場合はアクセシビリティを許可します。macOSの権限をご覧ください。

GitHub Copilot CLIにShotomaticを追加する

次を実行します。

copilot mcp add shotomatic -- npx -y shotomatic mcp

設定は~/.copilot/mcp-config.jsonに書き込まれます。

Windowsでクライアントがnpxを起動できない場合は、コマンドにcmd、引数に/c、npx、-y、shotomatic、mcpを指定します。

一度だけ許可する

GitHub Copilot CLIが初めて接続すると、Shotomaticはクライアントが名乗った名前で許可カードを表示します。許可を選びます。許可するまでの間、エージェントはShotomaticの状態を読むことしかできません。許可と確認をご覧ください。

動作を確認する

セッション中に/mcpと入力して、MCPサーバーのダッシュボードを開きます。そのうえで、次のように依頼します。

「Shotomaticの状態を確認して、Shotomaticで何ができるか教えて。」

正しく設定できていれば、Shotomaticのバージョン、Macでの画面収録とアクセシビリティの権限の有無、プランと今日の無料スクリーンショットの残り、Webサイト用ブラウザがインストール済みか、すでに実行中の撮影が返ってきます。

Shotomaticはプレビューをツールの結果の中の画像として返します。GitHub Copilot CLIのドキュメントにはその画像がモデルに届くかどうかの記載がないため、エージェントにはテキストしか届かない可能性があります。

ツールが表示されないとき

  • /mcpにサーバーがない。 ~/.copilot/mcp-config.jsonにshotomaticの項目があるかを確認し、新しいセッションを始めます。
  • "MCP access is turned off." 設定 > AIエージェントでAIエージェントにShotomaticの使用を許可をオンにして、クライアントを再起動します。
  • 許可カードが表示されない。 Shotomaticを開いて、カードを探します。Macでは、カードが表示されるとDockのアイコンが跳ねます。
  • クライアントがnpxまたはNodeを見つけられない。 すべてのクライアントのトラブルシューティング一覧をご覧ください。

次は、エージェントにできることの依頼を試すか、ツールリファレンスですべてのツールを確認してください。

GitHub Copilot CLI | ユーザーガイド | Shotomatic