Windows上でOpenCode + MCP連携環境構築 - 実際のハマりポイントと解決法のバックアップ(No.1)

バックアップ一覧
差分を表示
現在との差分を表示
ソースを表示
Windows上でOpenCode + MCP連携環境構築 - 実際のハマりポイントと解決法へ行く。
- 1 (2025-06-15 (日) 10:49:43)

はじめに †

WindowsでOpenCode?を使ってMCP（Model Context Protocol）連携環境を構築しようとした際、いくつかの設定エラーで躓きました。本記事では、実際に遭遇したトラブルシューティングを中心に、Windows環境でのOpenCode? + MCP設定手順を解説します。

↑

なぜOpenCode?が良いのか †

↑

Claude Codeとの比較 †

WSL不要: Windows上で直接動作 MCP設定の再利用: 既存のMCP設定をほぼそのまま利用可能環境変数共有: Windows環境変数をそのまま参照 tmux不要: Windows CMD/PowerShell?で直接利用可能

↑

従来の課題 †

Claude CodeはWSL環境が必要 WSL上でMCPサーバーを再設定する必要環境変数の設定が複雑ファイルパスの変換が必要

↑

環境構築手順 †

↑

前提条件の確認 †

↑

* Go言語のインストール確認 †

OpenCode?はGo言語で作成されているため、まずGo環境を確認します。 Go言語がインストール済みかチェック go version インストールされていない場合 winget install GoLang?.Go パス確認（重要） echo $GOPATH echo $GOROOT

↑

* 環境変数の事前設定 †

MINGW64環境で設定 export ANTHROPIC_API_KEY_MULTI_AGENT="sk-ant-api03-xxxxx" 設定確認 echo $ANTHROPIC_API_KEY_MULTI_AGENT

↑

OpenCode?インストール †

↑

* インストール手順 †

OpenCode?をインストール go install github.com/opencode-ai/opencode@latest インストール確認 opencode -v パスが通っていない場合 export PATH=$PATH:$(go env GOPATH)/bin

↑

設定ファイルでの失敗パターン集 †

↑

* パターン1: JSON構文エラー †

失敗例: Windowsパスのエスケープエラー { "mcpServers": { "filesystem": { "args": ["C:\Users\kh\Desktop"] // エラー！ } } } エラーメッセージ: invalid character 'o' in string escape code 修正方法: スラッシュ記法を使用 { "mcpServers": { "filesystem": { "args": ["C:/Users/kh/Desktop"] // 正解 } } }

↑

* パターン2: 環境変数展開エラー †

失敗例: シングルクォートHereDocument?の使用 cat > ~/.opencode.json << 'EOF' # シングルクォートでは展開されない { "apiKey": "$(echo $ANTHROPIC_API_KEY_MULTI_AGENT)" # 文字列として扱われる } EOF 修正方法: シングルクォートを除去 cat > ~/.opencode.json << EOF # 環境変数が実際に展開される { "apiKey": "$(echo $ANTHROPIC_API_KEY_MULTI_AGENT)" } EOF

↑

* パターン3: MCP環境変数設定エラー †

失敗例: オブジェクト形式での設定 "env": { "QDRANT_URL": "http://localhost:6333" } エラーメッセージ: expected type 'string', got unconvertible type 'map[string]interface' 修正方法: 配列形式を使用 "env": [ "QDRANT_URL=http://localhost:6333" ]

↑

動作確認済み設定ファイル †

以下は実際にWindows環境で動作確認できた設定例です： cat > ~/.opencode.json << EOF { "data": { "directory": ".opencode" }, "providers": { "anthropic": { "apiKey": "$(echo $ANTHROPIC_API_KEY_MULTI_AGENT)", "disabled": false } }, "agents": { "coder": { "model": "claude-3.7-sonnet", "maxTokens": 5000 } }, "mcpServers": { "filesystem": { "command": "npx", "args": [ "-y", "@modelcontextprotocol/server-filesystem", "C:/Users/kh/Desktop", "C:/Users/kh/prj/multiagent" ] }, "qdrant": { "command": "uvx", "args": [ "mcp-server-qdrant" ], "env": [ "QDRANT_URL=http://localhost:6333", "COLLECTION_NAME=khayashi_knowledge", "EMBEDDING_MODEL=sentence-transformers/all-MiniLM-L6-v2" ] } }, "shell": { "path": "bash", "args": ["-l"] }, "autoCompact": true } EOF

↑

起動とトラブルシューティング †

↑

正常起動の確認 †

↑

* 起動コマンド †

opencode

↑

* 正常な起動メッセージ †

2025/06/15 10:06:24 WARN Ripgrep (rg) not found in $PATH. Some features might be limited or slower. 2025/06/15 10:06:24 WARN FZF not found in $PATH. Some features might be limited or slower. この警告は正常で、基本機能には影響ありません。

↑

* MCP接続確認 †

起動後、以下のようなPermission Requiredダイアログが表示されれば、MCP連携が正常に動作しています： Permission Required Tool: qdrant qdrant-find Allow (a) Allow for session (s) Deny (d)

↑

よくあるエラーと解決方法 †

↑

エラー1: opencode: command not found †

原因: Goのbinディレクトリがパスに含まれていない解決方法: Go環境確認 go env GOPATH パス追加 export PATH=$PATH:$(go env GOPATH)/bin 永続化（.bashrcに追記） echo 'export PATH=$PATH:$(go env GOPATH)/bin' >> ~/.bashrc

↑