MCP 接続のトラブルシューティング

症状	確認事項
AI (MCP) パネルがない	実行中のアプリケーションに MCP Module が含まれ、System > License で AI (MCP) のライセンスが有効になっていることを確認します。
「Unable to start MCP」と表示される	ポートが使用中の場合があります。未使用のポートを選び、新しいアドレスをコピーして再接続します。
クライアントが接続できない	Model Vista を起動したまま AI connection enabled を有効にし、同じコンピューター上で表示された /mcp URL と Streamable HTTP を使用します。
Web Remote は動くが MCP は動かない	独立した AI (MCP) の有効化設定とポートを確認します。Control Page の URL は MCP の URL ではありません。
読み込み済みモデルの一覧が空である	list_library_models でアセットを検出し、選んだ結果を読み込みます。
モデルやステート名が曖昧	再検出し、重複した名前ではなく返された ID を使用します。
ツールやフィールドがない	再接続してツールを更新し、アプリケーションツール、フィールド、関数、インスタンスを確認します。読み込み済みモデルや別の利用権限が必要な操作もあります。
XR でデスクトップカメラ操作が失敗する	XR を維持したまま、利用可能なモデル・ステート操作を使うか、意図的に XR を終了し、読み戻し結果を待ってからカメラ操作を行います。
変更が拒否される、または applied が false	処理中の状態、トランスフォームのロック、表示ルール、グラフィックスの利用可否、ライセンスを確認します。再試行前に実際の状態を読み取ります。
Turntable の割り当てが受け付けられたが確認されない	get_turntable を読み取ります。ネットワークでの受け付けは実際の割り当てより先になる場合があります。
ステートが選択されたがアニメーションが見えない	get_model_animation と描画された表示を確認します。選択結果と進む再生クロックだけでは、見た目の動きは確認できません。
スクリーンショットがタイムアウトする	アプリケーションまたは Game view を表示し、フレームが描画されてから再試行します。
ジョブ ID が見つからない	リスナーの再起動や完了済みジョブの失効が考えられます。操作を繰り返す前にアプリケーション状態を確認します。

再起動やライセンス変更後

ポート変更、Model Vista の再起動、MCP の利用権限の復帰後は AI クライアントを再接続します。以前のインスタンス ID を使用する前に検出を更新してください。

長時間の操作がクライアントでタイムアウトした場合は、Model Vista でまだ処理中か、完了したかを確認します。クライアントのタイムアウトは、操作がキャンセルされたことを意味しません。

問題報告

Model Vista のバージョン、AI クライアントとバージョン、選択した MCP ポート、デスクトップ/XR モード、正確なツール名と引数、返されたエラーや状態、期待した結果を含めます。モデルの読み込み、リスナーの再起動、ライセンス変更、XR 切り替え後の問題かどうかも説明してください。共有するログやスクリーンショットから認証情報と非公開のモデル情報を除いてください。