OpenCode MCP 設定ガイド：ローカル・リモートサーバーを接続する7手順

このページは MCP の追加、認証、検証、制限、トラブル対策という独立した検索意図を扱います。一般的なインストール、Ollama、セッション保存先は既存ページに分け、キーワードの競合を避けます。

例は現行の公式 schema と CLI に基づきます。ただし提供者は URL、パッケージ、scope、認証方式を変更できます。チームへ導入する前に必ず所有者の公式資料で確認し、出所不明のコマンドを機密リポジトリで実行しないでください。

ローカルサーバーは OpenCode が起動する子プロセスです。信頼できる CLI パッケージやローカルファイルが必要なツールに向きます。安定性は runtime、package manager、作業ディレクトリ、環境変数、OS 権限に左右されます。

リモートサーバーは HTTP エンドポイントです。ドキュメント検索、監視、共有データベースには便利ですが、ネットワークと認証が障害点になります。好みではなく提供者が正式に対応する方式を選びます。

OpenCode は設定元をマージします。複数プロジェクト共通のツールはグローバル設定、リポジトリ固有のツールは opencode.json に置きます。秘密値は環境変数か OAuth に置き、Git へ入れません。

サーバー名は安定した説明的なものにします。その名前は prompt、tool prefix、Agent ごとのルールで使われます。任意サーバーは enabled: false にすると、説明を残しつつ常時読み込みを避けられます。

ローカル項目には type: "local" と command 配列が必要です。公開者とソースを確認し、安定性が必要ならバージョンを固定し、機密情報のない場所で先に試します。

token は environment と環境変数置換で渡します。最初は読み取り専用の開発アカウントに限定します。モデルが慎重でも、ツールは token が持つ権限を実行できます。

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "docs_search": {
      "type": "local",
      "command": ["npx", "-y", "trusted-mcp-package"],
      "enabled": true,
      "environment": { "MCP_TOKEN": "{env:MCP_TOKEN}" }
    }
  }
}

プレースホルダーはサーバー所有者の公式コマンドだけに置き換えてください。

リモート項目には type: "remote" と HTTPS URL が必要です。headers は提供者の指示がある場合だけ使います。OAuth は自動開始でき、opencode mcp auth <server-name> で明示的にも開始できます。

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "monitoring": {
      "type": "remote",
      "url": "https://provider.example/mcp",
      "oauth": {}
    }
  }
}

まず opencode mcp list で状態を確認し、接続や OAuth は opencode mcp debug <server-name> で診断します。その後、読み取り専用の問い合わせを実行し、元システムと結果を比較します。

サーバー名、パッケージまたは URL、runtime、認証、prefix、テスト prompt、timeout、rollback を記録します。これで個人の実験が他の開発者にも再現可能になります。

1. 提供者を確認公式 package、endpoint、認証を使う。
2. 範囲を選択global、project、専門 Agent。
3. 1件だけ追加新しい server は一度に1つ。
4. 秘密値を保護環境変数か OAuth。Git には入れない。
5. 一覧と debug状態、接続、OAuth を確認。
6. 読み取りテスト結果を元システムと比較。
7. 書き込みを許可log、diff、rollback 確認後。

opencode mcp list
opencode mcp auth <server-name>
opencode mcp debug <server-name>
opencode mcp logout <server-name>

ツール説明はコンテキストを消費します。広すぎるサーバーは無効にし、専門 Agent だけで有効にします。導入前後の回答品質と token 使用量を比較してください。

ログや認証情報を共有する前に OpenCode セッション保存とプライバシーガイド を確認し、MCP を小さなコンテキストのローカルモデルと使う場合は OpenCode Ollama ガイド も参照してください。

障害はプロセスまたは endpoint、認証、OpenCode の discovery、最後に prompt や policy の順で分けます。複数層を同時に変えると原因と rollback が不明になります。

Figma や Supabase は、まず提供者の公式導入手順に従い、その後この共通チェックを適用します。汎用 JSON はプロジェクト、region、権限の違いを見落としがちです。

インストールの基本は OpenCode 導入ガイド. へ戻り、公式の優先順位と MCP オプションは下記資料で確認してください。