# VS CodeとGitHub Copilot | ユーザーガイド | Shotomatic

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

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

ユーザーガイドを開く

このページの内容

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

VS CodeとGitHub Copilotでは、ShotomaticのローカルMCPサーバー経由でShotomaticを使えます。以下の手順はVS CodeとGitHub Copilotの公式ドキュメント（[MCP configuration reference](https://code.visualstudio.com/docs/agents/reference/mcp-configuration)と[Manage MCP servers](https://code.visualstudio.com/docs/agents/run/manage-mcp-servers)）に沿っています。ShotomaticはClaude CodeとCodexで動作を確認しており、VS CodeとGitHub Copilotでは確認していません。メニューやファイルが合わない場合は、VS CodeとGitHub Copilotのドキュメントを確認してください。

## 始める前に

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

## VS CodeとGitHub CopilotにShotomaticを追加する

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

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

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

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

VS Codeは、サーバーの初回起動時に信頼するかどうかを尋ねることがあります。

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

## 一度だけ許可する

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

## 動作を確認する

Command Paletteから**MCP: List Servers**を実行すると、サーバーを確認して、起動または再起動できます。そのうえで、次のように依頼します。

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

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

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

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

-   **サーバーが無視される。** 項目が`servers`の下にあり、`"type": "stdio"`があるかを確認します。
-   **"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.  [VS CodeとGitHub CopilotにShotomaticを追加する](#vs-codeとgithub-copilotにshotomaticを追加する)
3.  [一度だけ許可する](#一度だけ許可する)
4.  [動作を確認する](#動作を確認する)
5.  [ツールが表示されないとき](#ツールが表示されないとき)

## この版について

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