Blender MCP · トラブルシューティング
トラブルシューティングと制限事項
よくある問題とその解決策、および製品の制限事項について説明します。お困りの内容がここにない場合は、サポートチケットを作成してください。
ツールがBlenderに接続されていないと表示される
症状： クライアントがサーバーをロードしていますが、ツール側でBlenderが応答していないというエラーが返されます。
対処法： Blender を開き、Synthetic Blender MCP アドオンが有効になっているか確認してください（編集 → プリファレンス → アドオン）。リストにない場合は、インストールガイド の手順に従ってインストールしてください。
Blenderが一時的に応答しなくなる
症状： レンダリングやシミュレーションなどのツール実行中に、Blenderのウィンドウがフリーズする。
対処法： これは想定内の動作です。ツールはBlenderのメインスレッドで動作するため、長いレンダリング中は完了するまでウィンドウがビジー状態になります。完了までお待ちください。その間にツールのタイムアウトが発生した場合は、AIクライアントにシーンの状態を確認させてから、再度試行してください。
ライセンス無効エラー
症状： ツールがライセンスが見つからないか無効であると回答するか、クライアントのログに BLENDER_MCP_LICENSE が設定されていないと表示されます。
対処法： 設定ファイルのライセンスが /dashboard/licenses のものと一致していません。ライセンスをコピーし直してください（JSONに貼り付ける際、前後に不要なスペースが入っていないか確認してください）。その後、MCPクライアントを再起動してください。
アップデート後にツールが動作しなくなった
症状： サーバーが自動更新された後、ツールがBlenderと通信できずエラーが発生する。
対処法： アップデートによりアドオンの新しいバージョンが提供されることがあります。Blenderの設定（インストールガイドを参照）から再度インストールし、Blenderを再起動してください。
クライアントが Node.js を検出できない
症状： MCP クライアントがサーバーを起動できず、ログに node に関する記述があります。
対処法： Synthetic Setup を再度実行してください（Node.js が不足している場合、MCP クライアント向けに自動的に追加されます）。または、nodejs.org から Node.js (LTS) をインストールし、クライアントを再起動してください。
制限事項
Blender MCP ができないこと、または動作確認が済んでいないこと。インストール前にご確認いただけるよう、ここに記載しています。
- Windows上のBlender 5.1.2および5.2.2 LTSで動作確認済みです。macOS はベータ版です。十分にテストされておらず、エラーが発生する場合があります。Linux およびその他のバージョンの Blender はまだ確認されていません。
- AIクライアントがツールを実行する際は、常にBlenderが起動しており、アドオンが有効である必要があります。Blenderのウィンドウは一度に1つだけ開いて使用してください。
- ツールはBlenderのメインスレッドで動作します。そのため、長いレンダリングやシミュレーションの実行中は、それが完了するまでBlenderは応答しません。ツールがタイムアウトした場合でも、Blender側ですでに開始された処理はそのまま完了することがあります。
- Poly Havenのダウンロードサービスは、無料の商用ライセンスをお持ちでない限り、非商用利用に限られます。ambientCGのアセット（CC0）およびご自身のディスクから読み込んだファイルには、このような制限はありません。
- Blender内部でPythonやオペレーターを実行するツールは、データの削除を含む、Blenderで可能なあらゆる操作を行うことができます。常に作業内容を保存し、取り消し不可能な操作を行う前にはAIクライアントに確認させるようにしてください。
- アドオンはフリーソフトウェア（GNU GPL バージョン 3）です。これは Blender がアドオンに求めているものです。MCP サーバーは Synthetic 独自のソフトウェアで、無料のライセンスキーが必要です。
これらで解決しない場合は
サポートダッシュボード でチケットを作成してください。その際、(1) Blenderのバージョン、(2) 使用しているMCPクライアントとそのバージョン、(3) サーバー起動試行時のクライアントログ、(4) 貼り付けた設定スニペット（ライセンスキーは除いてください）を添えてください。また、Discord で質問することも可能です。