ユーザーガイドを開く

Cursor

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

更新日 2026年11月16日

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

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

始める前に

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

CursorにShotomaticを追加する

すべてのプロジェクトで使うには~/.cursor/mcp.jsonに、1つのプロジェクトだけで使うにはそのプロジェクト内の.cursor/mcp.jsonに、次を追加します。

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

Cursorは初期状態で、MCPツールを使う前に承認を求めます。

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

一度だけ許可する

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

動作を確認する

Customizeでサーバーが有効になっていることを確認します。そのうえで、次のように依頼します。

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

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

CursorのドキュメントにはMCPツールの結果に含まれる画像に対応すると書かれているため、エージェントは依頼したプレビューやフレームを見られます。

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

  • サーバーにエラーが表示される。 起動時のエラーは、CursorのOutput(Cmd + Shift + U、WindowsではCtrl + Shift + U)にあるMCP Logsに表示されます。
  • "MCP access is turned off." 設定 > AIエージェントでAIエージェントにShotomaticの使用を許可をオンにして、クライアントを再起動します。
  • 許可カードが表示されない。 Shotomaticを開いて、カードを探します。Macでは、カードが表示されるとDockのアイコンが跳ねます。
  • クライアントがnpxまたはNodeを見つけられない。 すべてのクライアントのトラブルシューティング一覧をご覧ください。

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

Cursor | ユーザーガイド | Shotomatic