# Qwen Code | ユーザーガイド | Shotomatic

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

- 種類: 公開Webページ
- 正規ページ: [https://www.shotomatic.com/ja/guide/ai-agents/clients/qwen-code](https://www.shotomatic.com/ja/guide/ai-agents/clients/qwen-code)
- Markdownページ: [https://www.shotomatic.com/ja/guide/ai-agents/clients/qwen-code.md](https://www.shotomatic.com/ja/guide/ai-agents/clients/qwen-code.md)

ユーザーガイドを開く

このページの内容

1.  [始める前に](#始める前に)
2.  [Qwen CodeにShotomaticを追加する](#qwen-codeにshotomaticを追加する)
3.  [一度だけ許可する](#一度だけ許可する)
4.  [動作を確認する](#動作を確認する)
5.  [ツールが表示されないとき](#ツールが表示されないとき)

Qwen Codeでは、ShotomaticのローカルMCPサーバー経由でShotomaticを使えます。以下の手順はQwen Codeの公式ドキュメント（[Connect Qwen Code to tools via MCP](https://qwenlm.github.io/qwen-code-docs/en/users/features/mcp/)）に沿っています。ShotomaticはClaude CodeとCodexで動作を確認しており、Qwen Codeでは確認していません。メニューやファイルが合わない場合は、Qwen Codeのドキュメントを確認してください。

## 始める前に

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

## Qwen CodeにShotomaticを追加する

次を`~/.qwen/settings.json`（ユーザー）または`.qwen/settings.json`（プロジェクト）に追加します。

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

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

## 一度だけ許可する

Qwen Codeが初めて接続すると、Shotomaticはクライアントが名乗った名前で許可カードを表示します。**許可**を選びます。許可するまでの間、エージェントはShotomaticの状態を読むことしかできません。[許可と確認](https://www.shotomatic.com/ja/guide/ai-agents/approvals-and-confirmations)をご覧ください。

## 動作を確認する

同じプロジェクトで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を見つけられない。** [すべてのクライアントのトラブルシューティング一覧](https://www.shotomatic.com/ja/guide/ai-agents/other-agents#%E3%83%88%E3%83%A9%E3%83%96%E3%83%AB%E3%82%B7%E3%83%A5%E3%83%BC%E3%83%86%E3%82%A3%E3%83%B3%E3%82%B0)をご覧ください。

次は、[エージェントにできること](https://www.shotomatic.com/ja/guide/ai-agents/what-agents-can-do)の依頼を試すか、[ツールリファレンス](https://www.shotomatic.com/ja/guide/ai-agents/tools)ですべてのツールを確認してください。

## このページの内容

1.  [始める前に](#始める前に)
2.  [Qwen CodeにShotomaticを追加する](#qwen-codeにshotomaticを追加する)
3.  [一度だけ許可する](#一度だけ許可する)
4.  [動作を確認する](#動作を確認する)
5.  [ツールが表示されないとき](#ツールが表示されないとき)

## この版について

このMarkdownページは、サーバーでレンダリングされたShotomaticの公開ページから生成されています。操作部品とサイトナビゲーションは含まれません。引用や共有には正規ページを使用してください。
