MCP セットアップガイド

このページでは MakeBuilding Pro v5.5.0 にバンドルされた MCP サーバーを Claude Desktop / Cursor / Cline と連携させる手順を説明します。

✅ 推奨経路: MakeBuilding Pro を Rhino Package Manager (Yak) からインストール済の場合、mbp-mcp-server.exe は 既に配置済 です。Node.js のインストール作業は不要です。

---

1. クイックスタート (バンドル版 .exe)

ステップ 1: Grasshopper メニューから設定スニペットを取得

1. Rhino + Grasshopper を起動
2. メインメニュー → MakeBuildingPro → MCP Setup...
3. ダイアログに mbp-mcp-server.exe のパスが表示されることを確認 (✓ 緑)
4. Copy claude_desktop_config Snippet ボタンをクリック → クリップボードにスニペットがコピーされる

ステップ 2: Claude Desktop に設定をペースト

claude_desktop_config.json を開きます:

OS	パス
Windows	%APPDATA%\Claude\claude_desktop_config.json
macOS	~/Library/Application Support/Claude/claude_desktop_config.json

ファイルが存在しない場合は新規作成して以下の内容を入れます:

{
  "mcpServers": {
    "make-building-pro": {
      "command": "C:/Users/<you>/AppData/Roaming/Grasshopper/Libraries/mcp-server/mbp-mcp-server.exe",
      "args": [],
      "env": {
        "MBP_WRITE_ENABLED": "false"
      }
    }
  }
}

ペーストするのは "make-building-pro": { ... } の部分です。既存の mcpServers ブロックがあれば、その中に追加してください。他社製 MCP サーバーの設定は壊さないように。

ステップ 3: Claude Desktop を再起動

完全終了して再起動。チャット画面右下のハンマーアイコンに make-building-pro (緑) が表示されれば接続成功です。

ステップ 4: 動作確認

Grasshopper メニュー → MCP Setup... → Run Self-Test ボタンをクリックすると、サーバーバイナリの健全性チェック (Node ランタイム / MCP SDK / 一時ディレクトリ書込) が走り、exit code が表示されます。Exit code 0 で成功です。

または Claude Desktop で次のプロンプトを試してください:

「make-building-pro の tools 一覧を表示して」

get_server_info, list_buildings, read_building などが列挙されれば接続成功です。

2. 書込み機能を有効化する

デフォルトは read-only です (安全のため)。AI に編集させたい場合のみ、明示的に有効化します。

claude_desktop_config.json を以下のように更新:

{
  "mcpServers": {
    "make-building-pro": {
      "command": "C:/.../mbp-mcp-server.exe",
      "args": [],
      "env": {
        "MBP_ROOT": "D:/projects/mbp",
        "MBP_WRITE_ENABLED": "true",
        "MBP_MAX_FILE_SIZE_MB": "100",
        "MBP_LOCK_TIMEOUT_MS": "5000",
        "MBP_UNDO_STACK_SIZE": "10",
        "MBP_BACKUP_GENERATIONS": "3"
      }
    }
  }
}

環境変数	意味	推奨値
MBP_ROOT	サンドボックスルート (これ配下のみ read / write 可)	プロジェクトフォルダ
MBP_WRITE_ENABLED	書込み tools (23 個) の有効化	true で有効
MBP_MAX_FILE_SIZE_MB	読込最大サイズ	100
MBP_LOCK_TIMEOUT_MS	ファイルロック取得タイムアウト	5000
MBP_UNDO_STACK_SIZE	プロセス内 Undo 履歴の段数	10
MBP_BACKUP_GENERATIONS	.bak 保持世代数	3

完全なリストは mbp-mcp-server.exe --help で表示できます。

3. 安全機構

Layer	内容
Layer 1: opt-in ガード	MBP_WRITE_ENABLED=false がデフォルト
Layer 2: サンドボックス	MBP_ROOT 配下のみ操作可
Layer 3: ファイルロック	proper-lockfile で同時編集防止
Layer 4: GH 編集ロック	Grasshopper 側が編集中なら待機
Layer 5: Undo	undo ツールで直近操作を巻き戻し
Layer 6: バックアップ	書込み前に .bak 保持

詳細は AI 機能利用規約 も参照してください。

4. Cursor / Cline での利用

Cursor の場合は .cursor/mcp.json に同じ形式で設定:

{
  "mcpServers": {
    "make-building-pro": {
      "command": "C:/.../mbp-mcp-server.exe",
      "args": [],
      "env": {
        "MBP_ROOT": "D:/projects/mbp",
        "MBP_WRITE_ENABLED": "true"
      }
    }
  }
}

Cline は VS Code の MCP 設定 UI から、上記同等の項目を入力します。

5. トラブルシューティング

5.1 「executable not yet bundled」と表示される

• Yak から MakeBuilding Pro をインストールしていない可能性
• %APPDATA%\Grasshopper\Libraries\mcp-server\ に mbp-mcp-server.exe があるか確認

5.2 Claude Desktop が接続しない

• claude_desktop_config.json の JSON 構文を https://jsonlint.com で検証
• Windows のパス区切りはバックスラッシュ 2 個 (\\) でエスケープ済か確認
• Claude Desktop を完全終了 → 再起動

5.3 Self-Test が exit code 0 にならない

• mbp-mcp-server.exe --selftest を PowerShell で直接実行し、出力されるエラー行を確認
• Windows Defender が .exe をブロックしている可能性 → 除外設定追加

5.4 Windows Defender が .exe を削除する

mbp-mcp-server.exe はコード署名されていません (将来対応予定)。誤検知が出る場合:

• Windows Defender の除外設定に %APPDATA%\Grasshopper\Libraries\mcp-server\ を追加
• 企業環境では IT 管理者にご相談ください

5.5 「Write tools are disabled」

MBP_WRITE_ENABLED を "true" に設定し、Claude Desktop を再起動してください。

6. 関連ページ

• MCP 連携について — アーキテクチャ概要
• AI 機能利用規約
• EULA