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