ユーザーガイドを開く

Warp

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

更新日 2026年11月16日

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

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

始める前に

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

WarpにShotomaticを追加する

Settings > Agents > MCP serversを開き、+ Addを選んで、次を貼り付けます。

{
  "mcpServers": {
    "shotomatic": {
      "command": "npx",
      "args": ["-y", "shotomatic", "mcp"]
    }
  }
}

Warpのエージェントは、エージェントプロファイルでサーバーを許可しない限り、MCPサーバーを呼び出す前に確認します。

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

一度だけ許可する

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

動作を確認する

MCP serversのページには、各サーバーと実行中かどうかが表示されます。そのうえで、次のように依頼します。

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

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

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

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

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

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

Warp | ユーザーガイド | Shotomatic