MCP セットアップガイド

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

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

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

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

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

💡 .exe の実体は Yak パッケージフォルダ %APPDATA%\McNeel\Rhinoceros\packages\8.0\MakeBuildingPro\<version>\mcp-server\mbp-mcp-server.exe に配置されます。パスにはバージョン番号が含まれるため、必ず MCP Setup ダイアログが表示する実パスをコピーしてください (ダイアログは自動検出します)。

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

claude_desktop_config.json を開きます:

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

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

jsonc

{
  "mcpServers": {
    "make-building-pro": {
      "command": "C:/Users/<you>/AppData/Roaming/McNeel/Rhinoceros/packages/8.0/MakeBuildingPro/<version>/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 で成功です。PowerShell から直接実行した場合の出力例:

mbp-mcp-server self-test
  Server:    mbp-mcp-server v0.5.1
  Node:      v20.x.x
  Platform:  win32 x64
[OK]   MCP SDK loaded (static import resolved)
[OK]   File system writable: C:\Users\<you>\AppData\Local\Temp

All checks passed.

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

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

read_building, get_summary, get_grids など 26 個の Read tools が列挙されれば接続成功です (Write tools はデフォルト無効のため表示されません)。

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

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

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

jsonc

{
  "mcpServers": {
    "make-building-pro": {
      "command": "C:/Users/<you>/AppData/Roaming/McNeel/Rhinoceros/packages/8.0/MakeBuildingPro/<version>/mcp-server/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 可)。write 有効時は設定推奨	未設定 (サンドボックス無効)
`MBP_WRITE_ENABLED`	書込み tools (25 個) の有効化	`false`
`MBP_MAX_FILE_SIZE_MB`	読込最大サイズ (MB)	100
`MBP_CACHE_SIZE`	メモリ内に保持する建物数	5
`MBP_LOG_LEVEL`	ログレベル (`debug` / `info` / `warn` / `error`)	`info`
`MBP_LOCK_TIMEOUT_MS`	ファイルロック取得タイムアウト (ms)	5000
`MBP_UNDO_STACK_SIZE`	プロセス内 Undo 履歴の段数	10
`MBP_BACKUP_GENERATIONS`	`.bak` 保持世代数	3
`MBP_GH_EDIT_LOCK_EXT`	GH 編集ロックファイルの拡張子 (契約)	`.gh-editing`

環境変数は起動時に 1 回だけ読み込まれます。変更後は Claude Desktop を再起動してください。主要な一覧は 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 側が編集中なら拒否 (AI が案内)
Layer 5: Undo	`undo` ツールで直近操作を巻き戻し
Layer 6: バックアップ	書込み前に `.bak` 保持

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

4. Cursor / Cline での利用

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

jsonc

{
  "mcpServers": {
    "make-building-pro": {
      "command": "C:/Users/<you>/AppData/Roaming/McNeel/Rhinoceros/packages/8.0/MakeBuildingPro/<version>/mcp-server/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%\McNeel\Rhinoceros\packages\8.0\MakeBuildingPro\<version>\mcp-server\ に mbp-mcp-server.exe があるか確認 (実パスは MCP Setup ダイアログに表示されます)

5.2 Claude Desktop が接続しない

claude_desktop_config.json の JSON 構文を https://jsonlint.com で検証
Windows のパス区切りはバックスラッシュ 2 個 (\\) でエスケープ済か確認 (スラッシュ / 区切りでも可)
MakeBuilding Pro を Yak で更新した場合、パス中の <version> が変わるため設定パスの更新が必要
Claude Desktop を完全終了 → 再起動

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

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

5.4 Windows Defender が .exe を削除する

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

Windows Defender の除外設定に %APPDATA%\McNeel\Rhinoceros\packages\8.0\MakeBuildingPro\ を追加
企業環境では IT 管理者にご相談ください

5.5 「Write tools are disabled」

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

6. 関連ページ

MCP 連携について — アーキテクチャ概要
MCP API 仕様 — 51 ツールの一覧と共通挙動
GH 編集モード協調ロック契約
AI 機能利用規約
EULA

更新履歴

日付	内容
2026-07-16	v0.5.1 対応 — 現行サーバー版表記と Self-Test 出力例を更新 (手順の変更なし)
2026-07-14	v0.5.0 対応 — バンドル `.exe` の実パスを Yak パッケージフォルダ (`%APPDATA%\McNeel\Rhinoceros\packages\8.0\...`) に修正、Write tools 数 23 → 25、環境変数表に `MBP_CACHE_SIZE` / `MBP_LOG_LEVEL` / `MBP_GH_EDIT_LOCK_EXT` を追加、Self-Test 出力例と動作確認のツール名を実装に合わせて更新
2026-05-31	初版 (v5.5.0 / v0.3.0)

MCP セットアップガイド ​

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

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

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

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

ステップ 4: 動作確認 ​

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

3. 安全機構 ​

4. Cursor / Cline での利用 ​

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

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

5.2 Claude Desktop が接続しない ​

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

5.4 Windows Defender が .exe を削除する ​

5.5 「Write tools are disabled」 ​

6. 関連ページ ​

更新履歴 ​

MCP セットアップガイド

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

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

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

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

ステップ 4: 動作確認

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

3. 安全機構

4. Cursor / Cline での利用

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

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

5.2 Claude Desktop が接続しない

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

5.4 Windows Defender が .exe を削除する

5.5 「Write tools are disabled」

6. 関連ページ

更新履歴