# OpenCode | ユーザーガイド | Shotomatic

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

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

ユーザーガイドを開く

このページの内容

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

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

## 始める前に

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

## OpenCodeにShotomaticを追加する

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

```sh
opencode mcp add shotomatic -- npx -y shotomatic mcp
```

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

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

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

## 一度だけ許可する

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

## 動作を確認する

`opencode mcp list`を実行します。そのうえで、次のように依頼します。

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

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

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

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

-   **別のプロジェクトでサーバーが表示されない。** `--global`を付けて追加し直します。
-   **"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.  [OpenCodeにShotomaticを追加する](#opencodeにshotomaticを追加する)
3.  [一度だけ許可する](#一度だけ許可する)
4.  [動作を確認する](#動作を確認する)
5.  [ツールが表示されないとき](#ツールが表示されないとき)

## この版について

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