SyntheticSynthetic/ドキュメント
製品更新履歴
ダッシュボード →

Blender MCP · インストール

Blender MCPのインストール

Blender MCPは、お使いのコンピュータ上で動作し、MCPクライアント(Claude Desktop、Cursor、Claude Code、Codex)から起動されるサーバーです。Synthetic Setupを使用してインストールします。このサーバーは、Blender側で一度だけ有効にするSynthetic Blender MCPアドオンを通じてBlenderと通信します。Windowsで動作確認済みです。

動作環境

Blender5.1 または 5.2 LTS
Node.js18 以上
OSWindows 10/11 · macOS(ベータ版: エラーが出る場合があります)
MCPクライアントClaude Desktop, Cursor, Codex、または任意の MCP クライアント
ライセンスBlender MCP のライセンスキー(/dashboard/licenses を参照)

1. Synthetic Setupでインストールする

/dashboard/downloadsからSynthetic Setupをダウンロードして実行してください。これにより、お使いのMCPクライアント(Claude Desktop、Cursor、Claude Code、Codex)が自動的に検出され、ライセンスが適用された状態でBlender MCPがそれぞれに追加されます。

クライアントの設定を手動で編集したい場合は、MCPクライアント設定ガイドで正確なエントリを確認してください。

2. MCPクライアントを再起動してください

MCP クライアントを一度終了して再起動してください。サーバーは起動時に読み込まれます。初回起動時は、数秒でサーバーがダウンロードされ、ライセンス確認後に Blender アドオンがコンピューターの C:\Users\YOUR_USER\.synthetic\mcp\blender-mcp\<version>\blender-addon\ に保存されます。

Synthetic Setup は Node.js の管理も行います。コンピューターにインストールされていない場合は、MCP クライアント向けに自動的に追加されます。

3. Blenderでアドオンを有効にする

Blenderのバージョンごとに、一度だけ以下の操作を行ってください:

  1. Blenderで、編集 → プリファレンス → アドオン を開きます。
  2. リストの右上にあるメニューを開き、「ディスクからインストール…」を選択して、ステップ2のフォルダにあるファイル synthetic_blender_mcp.py を選択します。
  3. リストの中で「Synthetic Blender MCP」が有効になっていることを確認してください。

アドオンはBlenderの起動時に毎回自動的に読み込まれます。ステータスは3Dビューポートのサイドバー(Nキーを押す)→ Synthetic MCPタブで確認できます。

Blenderのアドオン要件に従い、本アドオンはGNU GPLバージョン3に基づくフリーソフトウェアです。一方、MCPサーバーはSynthetic独自のソフトウェアであり、利用にはライセンスが必要です。

4. 動作確認

Blenderを開いた状態で、MCPクライアントに簡単な質問をしてみてください:

開いているBlenderのバージョンは何ですか?また、シーンにはどのようなオブジェクトがありますか?

Blenderのバージョンとシーン内のオブジェクトについて回答があれば、正常に動作しています。次に、小さなシーンを構築し、ライティングしてレンダリングするなど、より複雑な操作を試してみてください。

重要:MCPクライアントがツールを実行する際は、必ずBlenderを起動し、アドオンを有効にしておいてください。そうでない場合、ツールはBlenderが接続されていないという回答を返します。