Codex用Fusion MCP

このプロジェクトには、Codex用のローカルプラグインとFusion 360用のアドインが含まれています。目的は、CodexがMCPを通じてAutodesk Fusion 360を検査・自動化できるようにすることです。

アーキテクチャ

• server/main.py: Codexがstdioで起動するローカルMCPサーバー

• fusion_addin/FusionCodexBridge/: 127.0.0.1:19851でローカルHTTPブリッジを公開するFusion 360アドイン

• .mcp.json: CodexにローカルMCPサーバーの起動方法を指示する

MCPサーバーは、認証付きHTTPでFusionアドインと通信します。インストーラーがローカルプライベートトークンを生成し、両プロセスが%LOCALAPPDATA%\FusionMCP\credentials.jsonからそれを読み取ります。アドインはトークンを提示しないリクエストを拒否します。アドインは、カスタムイベントを使用して、承認された作業をFusionのメインスレッドで実行します。マニフェストはrunOnStartup=trueでFusionCodexBridgeをインストールし、Fusion起動時にブリッジが自動的に起動するようにします。POSTリクエストのJSONボディにはデフォルトで1 MiBの制限があり、fusion_run_scriptは明示的なオプトインがない限り無効のままです。

/healthエンドポイントは、ブリッジのバージョンとprotocolVersionを返します。MCPクライアントは通常のツールを実行する前に互換性チェックを行い、Fusionが古いアドインを実行し続けている場合はガイド付きエラーを返します。fusion_pingとfusion_reload_bridgeは診断と再読み込みに利用できます。

Related MCP server: fusion360-mcp-server

MCPが公開するツール

• fusion_ping

• fusion_status

• fusion_reload_bridge

• fusion_list_documents

• fusion_active_design_summary

• fusion_list_user_parameters

• fusion_list_all_parameters

• fusion_find_entities

• fusion_resolve_entity_token

• fusion_list_bodies

• fusion_list_surface_bodies

• fusion_list_mesh_bodies

• fusion_printability_report

• fusion_list_sketches

• fusion_list_sketch_curves

• fusion_list_sketch_profiles

• fusion_inspect_sketch

• fusion_list_components

• fusion_list_construction_planes

• fusion_list_construction_geometry

• fusion_list_available_appearances

• fusion_list_available_materials

• fusion_list_body_topology

• fusion_inspect_body_physical_properties

• fusion_upsert_user_parameter

• fusion_delete_user_parameter

• fusion_create_rectangle_sketch

• fusion_create_circle_sketch

• fusion_create_line_sketch

• fusion_create_arc_sketch

• fusion_create_ellipse_sketch

• fusion_create_fitted_spline_sketch

• fusion_create_text_sketch

• fusion_create_conic_sketch

• fusion_create_polyline_sketch

• fusion_create_polygon_sketch

• fusion_create_slot_sketch

• fusion_offset_sketch_curves

• fusion_trim_sketch_curve

• fusion_extend_sketch_curve

• fusion_fillet_sketch_curves

• fusion_chamfer_sketch_lines

• fusion_project_entities_to_sketch

• fusion_intersect_entities_with_sketch_plane

• fusion_project_curves_to_surface

• fusion_move_sketch_entities

• fusion_copy_sketch_entities

• fusion_mirror_sketch_entities

• fusion_rectangular_pattern_sketch_entities

• fusion_circular_pattern_sketch_entities

• fusion_add_sketch_constraint

• fusion_add_sketch_dimension

• fusion_set_sketch_dimension_expression

• fusion_delete_sketch_constraint

• fusion_delete_sketch_dimension

• fusion_create_offset_construction_plane

• fusion_create_midplane

• fusion_create_angled_construction_plane

• fusion_create_construction_point_from_sketch_point

• fusion_create_construction_axis_by_two_points

• fusion_create_construction_plane_by_three_points

• fusion_rename_construction_entity

• fusion_delete_construction_entity

• fusion_revolve_profile

• fusion_sweep_profile

• fusion_loft_profiles

• fusion_scale_bodies

• fusion_split_body

• fusion_preview_boundary_fill_cells

• fusion_create_boundary_fill

• fusion_create_silhouette_split

• fusion_merge_faces

• fusion_create_emboss

• fusion_create_derive

• fusion_split_faces

• fusion_delete_faces

• fusion_draft_faces

• fusion_thread_faces

• fusion_thicken_faces

• fusion_replace_faces

• fusion_patch_profile

• fusion_stitch_surface_bodies

• fusion_unstitch_faces

• fusion_extend_surface_edges

• fusion_create_ruled_surface

• fusion_untrim_surface_faces

• fusion_trim_surfaces

• fusion_rename_mesh_body

• fusion_set_mesh_body_visibility

• fusion_set_mesh_body_appearance

• fusion_delete_mesh_body

• fusion_import_mesh

• fusion_convert_mesh_to_brep

• fusion_reduce_mesh

• fusion_repair_mesh

• fusion_combine_mesh_bodies

• fusion_list_sheet_metal_rules

• fusion_create_sheet_metal_rule

• fusion_activate_sheet_metal_rule

• fusion_create_open_hem

• fusion_create_sheet_metal_rip

• fusion_create_box

• fusion_create_plate_with_holes

• fusion_create_printable_svg_plate

• fusion_create_cylinder

• fusion_extrude_profile

• fusion_create_hole

• fusion_fillet_edges

• fusion_chamfer_edges

• fusion_combine_bodies

• fusion_shell_body

• fusion_mirror_bodies

• fusion_rectangular_pattern_bodies

• fusion_circular_pattern_bodies

• fusion_translate_bodies

• fusion_rotate_bodies

• fusion_rename_sketch

• fusion_set_sketch_visibility

• fusion_delete_sketch

• fusion_delete_body

• fusion_set_body_appearance

• fusion_set_face_appearance

• fusion_set_body_material

• fusion_rename_body

• fusion_set_body_visibility

• fusion_rename_construction_plane

• fusion_delete_construction_plane

• fusion_create_component

• fusion_list_component_entities

• fusion_rename_component

• fusion_set_component_visibility

• fusion_activate_component

• fusion_delete_component

• fusion_translate_component

• fusion_create_box_in_component

• fusion_create_cylinder_in_component

• fusion_extrude_component_profile

• fusion_list_assembly_tree

• fusion_list_occurrence_entities

• fusion_list_occurrence_topology

• fusion_create_nested_component

• fusion_move_occurrence_to_component

• fusion_copy_paste_bodies

• fusion_cut_paste_bodies

• fusion_translate_occurrence

• fusion_set_occurrence_grounded

• fusion_create_rigid_group

• fusion_analyze_assembly_interference

• fusion_create_joint

• fusion_create_joint_origin

• fusion_list_joint_origins

• fusion_activate_manufacture_workspace

• fusion_manufacture_status

• fusion_list_cam_setups

• fusion_create_milling_setup

• fusion_list_cam_strategies

• fusion_generate_toolpaths

• fusion_list_cam_parameters

• fusion_set_cam_parameter

• fusion_rename_cam_setup

• fusion_delete_cam_setup

• fusion_rename_cam_operation

• fusion_set_cam_operation_suppression

• fusion_delete_cam_operation

• fusion_list_document_cam_tools

• fusion_list_cam_tool_library

• fusion_create_cam_operation

• fusion_list_cam_post_processors

• fusion_list_nc_programs

• fusion_create_nc_program

• fusion_postprocess_nc_program

• fusion_list_cam_machines

• fusion_assign_cam_machine

• fusion_drawing_status

• fusion_export_drawing_pdf

• fusion_list_workspaces

• fusion_activate_workspace

• fusion_viewport_status

• fusion_set_camera

• fusion_set_viewport_visual_style

• fusion_toggle_mesh_face_groups

• fusion_capture_viewport

• fusion_start_local_render

• fusion_list_render_jobs

• fusion_capture_parameter_animation

• fusion_create_document

• fusion_list_cloud_projects

• fusion_save_document_as

• fusion_activate_document

• fusion_save_document

• fusion_close_document

• fusion_list_timeline

• fusion_rename_timeline_object

• fusion_set_timeline_suppression

• fusion_delete_timeline_object

• fusion_inspect_timeline_dependencies

• fusion_export_step

• fusion_export_stl

• fusion_export_printable_stl

• fusion_import_step

• fusion_export_sketch_dxf

• fusion_import_dxf

• fusion_import_svg

• fusion_export_cad

• fusion_import_cad

• fusion_run_script

スケッチ作成ツールは、基準平面（xy、xz、yz）またはconstruction_plane_indexを使用したカスタム構築平面のいずれかで作業できます。

fusion_find_entitiesは、ボディ、スケッチ、コンポーネント、カスタム平面を名前で検索します。exact、contains、fuzzyをサポートし、他のツールが期待するインデックス付きのセレクターを返します。

検査レスポンスには、Fusionがサポートする場合にentityTokenが含まれます。fusion_resolve_entity_tokenを使用すると、タイムラインの変更後にエンティティとその現在のインデックスを取得できます。

拘束や寸法を追加するには、最初にfusion_list_sketch_curvesとfusion_inspect_sketchを使用します。これらのインデックスは編集後に変更される可能性があります。fusion_list_sketch_profilesは、面積、重心、バウンディングボックス、ループを持つ押し出し可能なプロファイルを一覧表示します。複雑なSVGやロゴが多数の領域を生成する場合は、これを使用してprofile_indicesを選択します。fusion_add_sketch_constraintは、水平、垂直、平行、垂直、等しい、接線、同心、共線、一致、中点、対称、滑らか、固定、固定解除をカバーします。fusion_add_sketch_dimensionは、Fusionの式を使用して、長さ、水平、垂直、整列、角度、直径、半径をカバーします。線形寸法は1本の線または2点を受け入れ、角度寸法は2本の線を必要とします。fusion_set_sketch_dimension_expressionを使用して寸法を編集し、fusion_delete_sketch_*ツールを使用して選択した寸法または拘束を削除します。

fusion_save_documentは、以前に保存されたドキュメントの新しいバージョンを保存します。最初の保存またはコピーの作成には、fusion_list_cloud_projectsを使用してから、fusion_save_document_asをFusion Teamの既存フォルダーのproject_idとパスとともに使用します。

タイムラインのツールは、フィーチャーや依存するジオメトリに影響を与える可能性があります。要素を抑制または削除する前に、fusion_list_timelineを実行することをお勧めします。

fusion_inspect_body_physical_propertiesは、ルートボディの質量、密度、重心、慣性モーメントを返します。精度はlow（±1%）、medium（±0.5%）、high（±0.1%）、very_high（±0.01%）に設定できます。精度が高いほど時間がかかります。 fusion_inspect_timeline_dependenciesは、リンクされたフィーチャーと、要素に関連付けられたパラメーター間の関係を返します。

HTTPエラーは、Fusion内で生成された詳細なメッセージを保持するようになりました。ブリッジがアクティブでない場合、CodexはFusionCodexBridgeの起動方法を直接示します。アドインの変更を再インストールした後、fusion_reload_bridgeはインストールされたバージョンを読み込むためにFusion内でブリッジの再起動をスケジュールします。Codexに新しいツールがまだ表示されない場合は、Codexを再起動するか、プラグインセレクターを再度開いてMCPカタログを更新します。

fusion_thread_faces、fusion_thicken_faces、fusion_replace_facesは、fusion_list_body_topologyから取得したインデックスで動作します。Fusionは現在、Rib/Webを作成するための公開APIを提供していません。RibFeaturesは既存のフィーチャーの検査のみを許可します。

fusion_export_cadとfusion_import_cadはiges、sat、smtをサポートします。DXFはスケッチと2D平面に適用される形式であるため、別のツールが使用されます。fusion_export_printable_stlは、ルートコンポーネントまたは特定のボディのSTLをエクスポートする前に基本的な印刷可能性チェックを実行し、生成されたファイルとともにレポートを返します。fusion_import_svgは、オフセットとスケールを使用して、基準平面または構築平面上の新しいスケッチにSVGをインポートします。直接印刷可能なプレートについては、fusion_create_printable_svg_plateが長方形のソリッドベースを作成し、上面にSVGをインポートし、そのプロファイルを結合レリーフ、分離レリーフ、またはカットとして押し出します。複雑なSVGでは、profile_selection（all、largest、area_desc、outer_only）とmin_profile_area_cm2を使用してノイズを除外できます。profile_indicesは正確な手動選択のために引き続き利用できます。

非ルートコンポーネント内の操作は、ボックス、シリンダー、プロファイル押し出しに対応しています。ネストされたアセンブリには fusion_list_assembly_tree を使用します。これは fullPathName、つまりネストされたオカレンスの検査、作成、移動、平行移動のツールが使用する安定したセレクターを返します。fusion_copy_paste_bodies と fusion_cut_paste_bodies は、コピー元コンポーネントのローカルインデックスを使用します。ルートコンポーネントの場合はパスを空のままにします。Cut/Paste はボディを移動し、allow_move_bodies=true が必要です。オカレンスはコンポーネント定義を表します。その定義に複数のインスタンスがある場合、ボディのコピーまたは移動はすべてのインスタンスに影響を与える可能性があります。そのため、ツールは実行前に追加の確認を要求します。ジョイントを作成する前に、fusion_list_occurrence_topology を使用して、各オカレンスのコンテキスト内のフェースインデックスを取得します。fusion_create_joint の MVP は平面フェースと rigid または revolute ジョイントをサポートしています。2 番目のオカレンスはジョイント作成時に再配置できます。fusion_set_occurrence_grounded、fusion_create_rigid_group、fusion_analyze_assembly_interference はオカレンスパスを操作し、最後のものは設計を変更しません。

Surface ワークスペースでは、サーフェスの一覧表示、パッチ、ステッチ、アンステッチ、延長、ルールドサーフェス、トリム、アントリムが可能で、fusion_thicken_faces も再利用できます。fusion_trim_surfaces では、最初に selected_cell_indices=[] を使用してインデックスのプレビューを取得し、その後、削除するセルを指定して同じ呼び出しを繰り返します。

Mesh ワークスペースでは、STL/OBJ/3MF のインポート、ボディの検査と管理、アピアランスの割り当てに加え、変換、削減、修復、結合が可能です。fusion_printability_report は、表示されているルートボディの 3D プリント用の基本的な幾何学的条件を確認します。つまり、正のボリュームを持つ閉じた/向きが正しい B-Rep ソリッドまたはメッシュです。これは、volumeCm3 がゼロの開いたメッシュなどの視覚的なケースを検出するのに役立ちますが、最終的な検証は依然としてスライサーが行います。fusion_create_printable_svg_plate は、プレートを作成した後にこのレポートを返し、視覚的なジオメトリだけで終わらないようにします。4 つの修正操作は Autodesk のプレビュー API を使用しており、すべてのインストール環境で利用できるとは限りません。その場合、ツールはガイド付きの指示を返します。

Sheet Metal の初期マッピングは、既存の板金ボディに対するルール、ルールのアクティブ化、オープンヘム、リップをカバーしています。Autodesk は現在、パブリック API でベースフランジ/フランジの作成を公開していません。

Manufacture ワークスペースでは、ワークスペースのアクティブ化、セットアップ/オペレーション/パラメータの検査、フライス加工セットアップの作成、CAM 式の編集、要素の名前変更/抑制/削除、互換性のあるストラテジの検出、ツールパスの生成が可能です。また、ドキュメント内または URL で指定したライブラリ内のツールの照会、ツールと式に互換性のある任意の strategy の作成、マシンの照会/割り当て、ポストの検索、NCProgram の作成、ポスト処理も可能です。

推奨される CAM フロー: セットアップを作成または検査し、fusion_list_cam_strategies を照会し、fusion_list_document_cam_tools または fusion_list_cam_tool_library でツールを選択し、fusion_create_cam_operation でオペレーションを作成してツールパスを生成します。NC コードの場合、マシン/ポストを検出し、プログラムを作成してインデックスを確認してから、confirm_postprocess=true を指定して fusion_postprocess_nc_program を実行します。出力ディレクトリは存在している必要があり、マシン、ツール、原点、衝突の最終検証は引き続きオペレータの責任です。

図面ワークスペースでは、アクティブなドキュメント/シートを検査し、すべてのシートまたは範囲を PDF にエクスポートできます。図面のパブリック API は、すべてのシート、ビュー、注釈をプログラムで作成および編集するための完全なコレクションをまだ公開していません。

Render/Animation ワークスペースには、カメラの読み取りと制御、ビューポートのビジュアルスタイルの制御、ビューポートのキャプチャ、非同期ローカルレンダリング、ジョブの追跡が含まれます。output_path を指定しない fusion_capture_viewport は、最大 20 MiB のインライン PNG を返し、終了前に一時ファイルを削除します。これは視覚的な検査に推奨されるモードです。キャプチャを保持するか、より大きな画像を生成するには、明示的な output_path と persist=true を渡します。互換性のため、既にパスを返す古い呼び出しは引き続き永続化されます。非同期レンダリングとアニメーションは、ユーザーが指定した明示的なパスに引き続き書き込まれます。fusion_toggle_mesh_face_groups は、Fusion がマテリアルを非表示にしてフェイスグループの色を表示する場合に、メッシュフェイスグループの表示をオフ/オンにできます。fusion_capture_parameter_animation はパラメータの式を補間し、カメラを周回させることができ、PNG シーケンスを書き込んで元のパラメータ/カメラを復元します。最終的なビデオの組み立ては Fusion の外部で行われます。

fusion_list_workspaces と fusion_activate_workspace を使用すると、ID でワークスペースを検出してアクティブ化できます。Simulation ワークスペースでは、これはナビゲーションのみを対象としています。Autodesk は現在、adsk.cam に相当するスタディを作成および解決するための API モデルを公開していません。

fusion_split_body は現在、切断ツールとして原点平面または既存の構築平面を使用します。将来的には、スプリットツールとしてプロファイル、フェース、ボディに拡張される可能性があります。

Boundary Fill の場合、最初に body や construction_plane のセレクターを指定して fusion_preview_boundary_fill_cells を使用します。これにより、各一時セルのボリューム、面積、フェース、バウンディングボックスが返されます。次に、同じセレクターを同じ順序で、保持したい selected_cell_indices を指定して fusion_create_boundary_fill を直ちに繰り返します。これらのインデックスは一時的なものであり、モデルを編集した後に再利用しないでください。operation は new_body、join、cut、intersect をサポートしています。remove_tool_bodies は、ツールとして使用されたボディを削除するため、さらに allow_remove_tools=true が必要です。

fusion_create_silhouette_split は、ルートソリッドボディ上のシルエット分割線を計算します。方向は construction_axis、construction_plane、線形エッジ、平面フェースを受け入れます。faces_only はデフォルトの非破壊モードで、shelled_body と solid_body はボディを分割します。Fusion はこの機能を互換性のあるボディに制限しています。球はフローを確認するための簡単なケースです。

fusion_merge_faces は、同じソリッドボディまたはサーフェスボディの接続されたフェースを結合しますが、Direct Modeling デザインでのみ可能です。これは直接的な B-Rep 編集であり、フィーチャーやタイムラインエントリを作成しないため、allow_direct_modification=true が必要です。is_chain_selection=true を使用すると、互換性のある接続チェーンに沿ってシードフェースを拡張できます。

fusion_create_emboss は、スケッチプロファイルをルートボディのフェースにマッピングします。正の深さは浮き出し、負の深さは彫り込みに使用します。式は単位または Fusion のパラメータを受け入れます。MVP は呼び出しごとに 1 つのプロファイルと 1 つのフェースを公開し、オフセットと回転はオプションです。Fusion が 2025 年 9 月に導入した Emboss API が必要です。利用できない場合は、ガイド付きの指示が返されます。

fusion_create_derive は、Fusion で既に開かれて保存されている別のデザインドキュメントから派生リンクを作成します。source_document_index を特定するには fusion_list_documents を使用します。ソースエンティティとして、root_component、body、mesh_body、sketch、construction_plane、occurrence を受け入れます。アクティブなドキュメントは常に宛先であり、それ自体を派生させることはできません。このツールには、2026 年 1 月に導入された Derive API が必要です。

fusion_split_faces は、ツールとして body、face、sketch_curve、construction_plane のセレクターを受け入れます。モードは surface_intersection、closest_point、along_vector をサポートしています。fusion_delete_faces はデフォルトで heal を使用し、Fusion がボディの修復を試みます。surface モードは修復せずに削除し、開いたサーフェスボディが残る可能性があるため、allow_make_surface=true が必要です。すべての fusion_delete_* ツールは、現在、宛先セレクターと confirm_delete=true を必須としています。確認する直前にターゲットをリストまたは検査してください。保存せずに閉じるには、save_changes=false と confirm_discard_changes=true が必要です。

fusion_draft_faces は、ニュートラル平面を使用してボディのフェースにドラフトを適用します。通常は、最初に fusion_list_body_topology を使用して face_indices を取得します。

ローカルテスト

Fusion を開かずに利用可能なユニットテストとコントラクトテストを実行するには:

python -m unittest discover -s tests

このセットは、README のツールリスト、ROADMAP のカウント、ブリッジ/プラグイン/マニフェストのバージョン、MCP プロトコルが同期していることも検証します。

2 つの主要な Python エントリポイントの構文をすばやく確認するには:

python -m py_compile server/main.py fusion_addin/FusionCodexBridge/FusionCodexBridge.py

ブリッジがアクティブな状態で Fusion を開いて、実際の 3D プリントスモークテストを実行するには:

python .\scripts\smoke_printable_svg.py

このスモークテストは、使い捨てドキュメントを作成し、SVG からプレートを生成し、fusion_export_printable_stl で STL をエクスポートし、ファイルが存在することを確認して、保存せずにドキュメントを閉じます。成果物は scratch/fusion-smoke に残ります。

ブリッジがアクティブな状態で Fusion を開いて、基本的なスケッチの実際のスモークテストを実行するには:

python .\scripts\smoke_sketch_basics.py

このスモークテストは、使い捨てドキュメントを作成し、長方形、円、線、円弧、ポリライン、ポリゴン、スロットのスケッチを生成し、オフセット、拘束、寸法、検査をテストして、保存せずにドキュメントを閉じます。

要件

• PATH に python として利用可能な Python 3.10 以降を搭載した Windows

• Autodesk Fusion 360

セキュリティ設定

• fusion_run_script はデフォルトで無効になっています。意図的に有効にするには、MCP プロセスと Fusion 360 の両方で FUSION_MCP_ENABLE_RUN_SCRIPT=1 を設定し、両方を再起動します。スクリプトはユーザーの完全な権限で実行されるため、専用ツールを優先する必要があります。

• FUSION_MCP_MAX_REQUEST_BODY_BYTES は、ブリッジの JSON ペイロードの制限を調整します。デフォルト値は 1 MiB で、受け入れられる最大値は 16 MiB です。

• 削除、変更の破棄、ポスト処理の操作には、明示的な確認フラグが必要です。これらのフラグは、事前のターゲット検査に代わるものではありません。

Windows での推奨インストール

このリポジトリをローカルに既に持っている場合、最も速いインストール方法は次のとおりです:

powershell -ExecutionPolicy Bypass -File .\scripts\install-fusion-mcp.ps1

このインストーラは次のことを行います:

• MCP と Fusion を認証するためのランダムな秘密資格情報を生成または保持します。

• 資格情報ファイルを保護し、専用フォルダを作成するときは、そのフォルダの権限も現在のユーザーに制限します。既存の親フォルダの ACL は変更しません。

• 許可されたファイルリストからプラグインを構築し、キャプチャ、バックアップ、CAD、その他のワークスペースの成果物を含めずに ~/plugins/fusion-mcp にコピーします。

• マニフェストによってプラグインとアドインの宛先を検証します。リポジトリとの重複、認識されないフォルダ、ジャンクション、管理対象の宛先内の状態ファイルを拒否します。

• 候補+バックアップ方式でランタイムを公開し、マーケットプレイスが失敗した場合は以前のバージョンを復元します。

• ランタイムの公開後、アトミックな置換によって ~/.agents/plugins/marketplace.json を更新します。

• requirements.txt の依存関係をインストールします。

• Fusion アドインを %APPDATA%\Autodesk\Autodesk Fusion 360\API\AddIns\FusionCodexBridge にコピーします（そのフォルダが存在する場合）。存在しない場合は %APPDATA%\Autodesk\Autodesk Fusion\API\AddIns\FusionCodexBridge を使用します。

• これらのインストールフォルダを同期し、以前のバージョンの古いファイルを削除します。

• Autodesk の代替パスに FusionCodexBridge の別のコピーが見つかった場合は警告します。Fusion が古いコピーを読み込んでいる可能性があるためです。

Codex 部分だけをインストールして、Fusion アドインをまだコピーしたくない場合は、次を使用できます:

powershell -ExecutionPolicy Bypass -File .\scripts\install-fusion-mcp.ps1 -SkipFusionAddIn

動作させるための手順

1. リポジトリのルートでターミナルを開いてください。

2. インストーラーを実行してください：

   powershell -ExecutionPolicy Bypass -File .\scripts\install-fusion-mcp.ps1

3. Fusion 360を開いてください。

4. Fusionで、Utilities > Add-Ins > Scripts and Add-Ins に移動してください。

5. Add-Ins タブに移動してください。

6. リストが空の場合は、アドインが不足していると判断する前に、フィルターをクリアしてください。

7. FusionCodexBridge を探して、Run で実行してください。

8. FusionCodexBridge がリストに表示されない場合は、+ ボタンを使用して、次のいずれかのフォルダーを手動で指定してください：

   • %APPDATA%\Autodesk\Autodesk Fusion 360\API\AddIns\FusionCodexBridge

   • %APPDATA%\Autodesk\Autodesk Fusion\API\AddIns\FusionCodexBridge

9. Fusionのローカルブリッジが実行されていることを確認してください：

   $credential = Get-Content "$env:LOCALAPPDATA\FusionMCP\credentials.json" -Raw | ConvertFrom-Json
   Invoke-RestMethod http://127.0.0.1:19851/health -Headers @{ Authorization = "Bearer $($credential.token)" }

   "ok": true を含むJSON応答が返されるはずです。

10. 必要に応じて、Codexを再起動するか、VS Codeのウィンドウをリロードしてください。

11. Codex CLIまたはCodexアプリを使用している場合は、MCPサーバーを一度だけ登録してください：

codex mcp add fusion-local -- python "$HOME\plugins\fusion-mcp\server\main.py"

12. サーバーが登録されたことを確認してください：

codex mcp list

13. Codexに戻って、簡単な指示でテストしてください。例：

• revisa el diseño activo en Fusion

• haz un fusion_status

• crea una caja de 10x6x3 cm

手動インストール

手動インストールでも、MCPとFusionがFUSION_MCP_TOKENまたはFUSION_MCP_CREDENTIALS_FILEで指定されたJSONファイルを介して、少なくとも32文字のトークンを共有する必要があります。権限や設定のエラーを避けるために、インストーラーを少なくとも一度は実行することをお勧めします。

インストーラーを使用したくない場合は、手動でプロセスを実行できます：

1. Pythonの依存関係をインストールしてください：

   pip install -r requirements.txt

2. fusion_addin/FusionCodexBridge/ をFusionのAdd-Insフォルダーにコピーしてください：

   • %APPDATA%\Autodesk\Autodesk Fusion 360\API\AddIns\

   • または %APPDATA%\Autodesk\Autodesk Fusion\API\AddIns\

3. CodexにMCPサーバーを登録してください：

   codex mcp add fusion-local -- python "$PWD\server\main.py"

4. Fusion 360を開き、Utilities > Add-Ins > Scripts and Add-Ins から FusionCodexBridge を実行してください。

トラブルシューティング

• Fusionにアドインのリストが空で表示される場合は、まずScripts and Add-Insウィンドウのフィルターをクリアしてください。

• VS CodeにNo MCP Servers foundと表示される場合は、Developer: Reload Windowを実行し、その後MCP: List Serversを再度使用してください。

• VS Codeの拡張機能マーケットプレイスでfusion-localを検索しないでください。これはローカルMCPサーバーであり、マーケットプレイスの拡張機能ではありません。

• Codexがサーバーを認識しているがFusionに対するアクションが失敗する場合は、上記の/health確認コマンドを使用するか、fusion_pingを実行してください。すべてのエンドポイントはローカルのBearerトークンを必要とします。

• Codexがブリッジが互換性がないかprotocolVersionが不足していると報告した場合は、powershell -ExecutionPolicy Bypass -File .\scripts\install-fusion-mcp.ps1を実行し、その後fusion_reload_bridgeを実行するかFusionを再起動してください。

• インストーラーがFusionCodexBridgeの別のコピーが存在すると警告した場合は、Scripts and Add-Insを開き、インストーラーが出力した更新されたフォルダーを実行していることを確認してください。

• Unauthorized Fusion MCP requestを受け取った場合は、インストーラーを再実行し、Codexとアドインの両方が同じ資格情報を使用するように再起動してください。

• インストーラーが既存の資格情報ファイルを拒否した場合は、CredentialPathが正しいことを確認してください。実際に破損した資格情報を再生成するには、そのファイルを明示的に移動または削除してからインストーラーを再実行してください。インストーラーは不明なファイルを上書きしません。

• %LOCALAPPDATA%\FusionMCP\credentials.jsonをコピーしたり公開したりしないでください。インストーラーはトークンを表示することはありません。

注意事項

• fusion_run_scriptは、Fusion内でPythonを実行し、APIへの完全なアクセスを持ちますが、デフォルトでは無効になっています。信頼できるコードでのみ、明示的なオプトインによって使用してください。

• /healthを含むすべてのエンドポイントは、インストール中に生成されたBearerトークンを必要とします。

• スクリプトツールは、result変数に割り当てられた値を返します。

• ブリッジが実行されていない場合は、アドインを起動した後、fusion_pingまたはfusion_statusでテストを開始してください。