ユーザーガイド
ダウンロード
ユーザーガイドを開く

ほかのAIエージェントを接続する

Cursor、VS Code、Gemini CLI、Zed、Cline、Gooseなど、ほかのMCPクライアントにも同じnpxコマンドでShotomaticを追加します。

更新日 2026年11月15日

このページの内容
  1. Amp
  2. Cline
  3. Continue
  4. GitHub Copilot CLI
  5. Cursor
  6. Devin (Windsurf)
  7. Gemini CLI
  8. Goose
  9. JetBrains AI AssistantとJunie
  10. Kiro
  11. LM Studio
  12. OpenCode
  13. Qwen Code
  14. Roo Code
  15. VS CodeとGitHub Copilot
  16. Warp
  17. Zed
  18. 知っておきたい制限
  19. トラブルシューティング

動作を確認したのは、Claude CodeとCodexです。以下のクライアントも同じMCP標準を使っています。手順は各クライアントの公式ドキュメントに沿ったもので、これらのクライアントでShotomaticの動作確認は行っていません。クライアントのメニューやファイル形式は変わることがあるため、手順が合わなくなっていたら、クライアントのドキュメントを確認してください。

どのクライアントでも、必要な値は同じ3つです。

  • コマンド： npx
  • 引数： -y、shotomatic、mcp
  • 環境変数： なし。APIキーは不要です。

追加する前に、設定 > AIエージェントでAIエージェントにShotomaticの使用を許可をオンにし、Node 18.3以降をインストールします。クライアントが初めて接続すると、Shotomaticに許可カードが表示されます。許可を選んでください。Claude Code、Claude Desktop、Codexを含む全体の流れは、AIエージェントを接続するをご覧ください。

Windowsでは、以下のパスの~はユーザーフォルダー（%USERPROFILE%）を指します。Windowsでクライアントがnpxを起動できない場合は、コマンドにcmd、引数に/c、npx、-y、shotomatic、mcpを指定します。

MCPの設定はクライアントごとに異なり、多くのクライアントはツールを呼び出すたびに確認します。Shotomaticは、リモートURLではなく、ローカル（stdio）サーバーを入力する場所に追加します。

Amp

Docs：Amp MCP。次を実行します。

amp mcp add shotomatic -- npx -y shotomatic mcp

サーバーの確認にはamp mcp doctorを実行します。Ampのマニュアルでは、すべてのスレッドでMCPサーバーが必要なわけではない場合は、スキルにまとめるよう案内しています。

Cline

Docs：Configuring MCP servers。ClineのパネルでMCP Serversのアイコンを選び、Configureを開いて、Configure MCP Serversを選びます。開いたJSONファイルに次を追加します（Cline CLIでは~/.cline/data/settings/cline_mcp_settings.jsonを使います）。

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

ClineのautoApproveリストは初期状態で空なので、ツールを呼び出すたびに確認されます。

Continue

Docs：Set up MCP in Continue。MCPはAgentモードでのみ動作します。ワークスペースに.continue/mcpServers/shotomatic.yamlを作成します。

name: Shotomatic
version: 0.0.1
schema: v1
mcpServers:
  - name: Shotomatic
    type: stdio
    command: npx
    args:
      - "-y"
      - "shotomatic"
      - "mcp"

GitHub Copilot CLI

Docs：Adding MCP servers to Copilot CLI。次を実行します。

copilot mcp add shotomatic -- npx -y shotomatic mcp

設定は~/.copilot/mcp-config.jsonに書き込まれます。セッション中に/mcpと入力すると、MCPサーバーのダッシュボードが開きます。

Cursor

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

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

Customizeでサーバーが有効になっていることを確認します。起動時のエラーは、CursorのOutput（Cmd + Shift + U、WindowsではCtrl + Shift + U）にあるMCP Logsに表示されます。Cursorは初期状態で、MCPツールを使う前に承認を求めます。

Devin (Windsurf)

Docs：Devin CLI MCP configurationとDevin Desktop customizations。Windsurf自身のドキュメントのアドレスは、現在Devin Desktopのドキュメントにリダイレクトされます。次を実行します。

devin mcp add -s user shotomatic -- npx -y shotomatic mcp

または、上と同じJSON（typeなし）を~/.config/devin/mcp_config.jsonに追加します。devin mcp listを実行するか、Devin DesktopでCustomize > MCPsを開き、This computerの下を確認します。エージェントは初期状態で、MCPツールを呼び出す前に承認を求めます。

Gemini CLI

Docs：MCP servers with Gemini CLI。次を~/.gemini/settings.json（プロジェクトでは.gemini/settings.json）に追加します。

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

シェルでgemini mcp listを実行するか、セッション中に/mcpを実行します。stdioサーバーは、現在のフォルダが信頼されている場合にだけ接続済みと表示されます。trustは初期値（false）のままにしておくと、Gemini CLIはツールを呼び出すたびに確認します。

Goose

Docs：Using extensions。Goose DesktopでExtensionsを開き、Add custom extensionを選んで、次を入力します。

  • Type: Standard IO
  • ID: shotomatic
  • Name: Shotomatic
  • Command: npx -y shotomatic mcp

CLIではgoose configureを実行し、Add ExtensionとCommand-line Extensionを選んで、同じコマンドを入力します。1回のセッションだけで使うには、goose session --with-extension "npx -y shotomatic mcp"を実行します。

JetBrains AI AssistantとJunie

Docs：AI Assistant MCPとJunie CLI MCP configuration。

AI Assistant：**Settings | Tools | AI Assistant | Model Context Protocol (MCP)を開き、Addを選んで、下のJSONを貼り付け、Applyを選びます。接続状況はStatus**列で確認できます。

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

**Junie：**同じJSONを~/.junie/mcp/mcp.json（プロジェクトでは.junie/mcp/mcp.json）に追加し、/mcpを実行してサーバーが有効になっていることを確認します。

Kiro

Docs：Kiro MCP configuration。Command Paletteから**Kiro: Open user MCP config (JSON)**を実行するか、~/.kiro/settings/mcp.json（1つのワークスペースだけなら.kiro/settings/mcp.json）を編集します。MCPサポートの設定がオンになっていることを確認して、次を追加します。

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

ファイルを保存すると、サーバーが再接続されます。

LM Studio

Docs：Use MCP servers in LM Studio。LM StudioはローカルのMCPサーバーに対応しており、Cursorのmcp.jsonの記法に従います。右サイドバーのProgramタブを開き、Install > Edit mcp.jsonを選びます。次を追加します。

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

LM Studioのドキュメントでは、信頼できない提供元のMCPサーバーをインストールしないよう勧めています。また、サーバーによってはトークンを大量に使い、ローカルモデルのコンテキストがあふれることがあると警告しています。

OpenCode

Docs：OpenCode MCP servers。使いたいプロジェクトで次を実行します。どこでも使えるようにするには、--globalを付けます。

opencode mcp add shotomatic -- npx -y shotomatic mcp
opencode mcp list

現行（V2）のドキュメントに従って設定を手で編集するには、次をopencode.jsoncに追加します。V1は形式が異なるため、どちらのバージョンか分からない場合は、CLIのコマンドを使ってください。

{
  "mcp": {
    "servers": {
      "shotomatic": {
        "type": "local",
        "command": ["npx", "-y", "shotomatic", "mcp"]
      }
    }
  }
}

Qwen Code

Docs：Connect Qwen Code to tools via MCP。次を~/.qwen/settings.json（ユーザー）または.qwen/settings.json（プロジェクト）に追加します。

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

同じプロジェクトでQwen Codeを再起動し、/mcpと入力するとサーバーを確認できます。

Roo Code

Docs：Using MCP in Roo Code。Roo Codeペイン上部のアイコンからMCPの設定画面を開き、下へスクロールして、Edit Global MCP（mcp_settings.json）またはEdit Project MCP（.roo/mcp.json）を選びます。次を追加します。

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

VS CodeとGitHub Copilot

Docs：MCP configuration referenceとManage MCP servers。VS CodeはmcpServersではなくserversを使い、typeが必須です。ワークスペースの.vscode/mcp.jsonに次を追加します。

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

代わりにユーザープロファイルへ追加するには、次を実行します。

code --add-mcp '{"name":"shotomatic","type":"stdio","command":"npx","args":["-y","shotomatic","mcp"]}'

Command PaletteからMCP: List Serversを実行すると、サーバーを確認して、起動または再起動できます。VS Codeは、サーバーの初回起動時に信頼するかどうかを尋ねることがあります。

Warp

Docs：Model Context Protocol in Warp。Settings > Agents > MCP serversを開き、+ Addを選んで、次を貼り付けます。

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

MCP serversのページには、各サーバーと実行中かどうかが表示されます。Warpのエージェントは、エージェントプロファイルでサーバーを許可しない限り、MCPサーバーを呼び出す前に確認します。

Zed

Docs：Model Context Protocol in Zed。Zedでは、MCPサーバーをコンテキストサーバーと呼び、context_serversを使います。Command Paletteからzed: open settings fileを実行して、次を追加します。

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

Settings > AI > MCP Serversを開きます。ツールチップに"Server is active"と表示された緑の点は、接続済みを表します。Zedは初期状態で、ツールを呼び出す前に確認します。

知っておきたい制限

  • Shotomaticは、スクリーンショットをツール結果の中の画像として返します。CursorとGemini CLIは、MCPツールの結果に含まれる画像に対応していると記載しています。上のほかのクライアントについてはドキュメントに記載がないため、エージェントにはテキストしか届かない可能性があります。
  • 多くのクライアントは、初期状態でツールを呼び出すたびに承認を求めます。長い撮影では、確認が何度も表示されることがあります。サーバーのツールを許可する方法は、各クライアントのドキュメントに記載されています。Shotomatic自体がエージェントに許可する内容は、制限と安全性をご覧ください。

トラブルシューティング

  • クライアントにサーバーが表示されない。 設定ファイルを保存し、クライアントを再起動するか、MCPの一覧を読み込み直します。エントリが、そのクライアントが想定するキー（mcpServers、servers、context_servers）の下にあるか、JSONまたはYAMLが正しいかを確認します。
  • "MCP access is turned off." Shotomaticを開き、設定 > AIエージェントでAIエージェントにShotomaticの使用を許可をオンにして、クライアントを再起動します。
  • 許可カードが表示されない。 Shotomaticを開いて、カードを探します。Macでは、カードが表示されるとDockのアイコンが跳ねます。許可するまでの間、エージェントは状態を読むことしかできません。設定 > AIエージェントでエージェントの許可を取り消すと、次の接続時にカードが再び表示されます。
  • クライアントがnpxまたはNodeを見つけられない。 Macでは、DockやFinderから開いたアプリはターミナルより短いPATHで起動することがよくあります。Cursorのドキュメントには、コマンドはシステムのパス上にあるか、フルパスで指定する必要があると書かれています。Qwen Codeのドキュメントも、サーバーが起動しない場合はコマンドの絶対パスを勧めています。ターミナルでwhich npxを実行し、そのフルパス（例：/opt/homebrew/bin/npx）をコマンドとして使います。npxは、自身のPATHにnodeがあることも必要とします。それでも動かない場合は、which nodeで表示されたフォルダを、サーバーのenvにあるPATHのエントリに追加します（クライアントがenvに対応している場合）。miseやasdfなどのバージョン管理ツールでも、同じ対応が必要なことがあります。

AIエージェントを接続するに戻ります。

ほかのAIエージェントを接続する | ユーザーガイド | Shotomatic