32 人が閲覧(直近 30 日) AIエージェント・MCP

Fusion 360 MCPの使い方|公式MCPサーバーとfusion360-mcp-bridge等OSSの接続手順

Fusion 360 MCPの使い方|公式MCPサーバーとfusion360-mcp-bridge等OSSの接続手順

Fusion 360 MCPは、ClaudeやCursorなどのAIクライアントから、起動中のAutodesk Fusionにスケッチ・押し出し・書き出しといった操作を実行させる仕組みです。2026年4月以降、Fusion本体に公式のMCPサーバーが組み込まれ、[基本設定]の[一般]>[API]でチェックを入れるだけで http://127.0.0.1:27182/mcp が立ち上がるようになりました。それまで主流だった fusion360-mcp-bridge や fusion360-mcp-server といったコミュニティ製サーバーは、いまは「公式で足りない用途に使う選択肢」です。この記事では、公式サーバーの接続手順をクライアント別に示し、主要なOSSの違いと、READMEどおりに入れると動かない箇所を整理します。動かない箇所は、2026年9月30日にClaude Code 2.1.284とPython 3.9.6/3.12で設定と起動を再現し、配布物の中身を数えて確かめたものです(Fusion本体を使ったモデリングの実測ではありません)。

まとめ:Fusion 360 MCPの選び方と接続の要点

  • 最初に試すのはFusion本体の公式MCPサーバー。[基本設定]>[一般]>[API]で有効にすると、ローカルに http://127.0.0.1:27182/mcp(Streamable HTTP)が立つ。追加のインストールは不要。
  • Claude Desktopは[設定]>[コネクタ]のディレクトリから「Autodesk Fusion」を入れる。Claude Code・Cursor・VS Codeは上記URLを設定ファイルに書く。VS Codeだけはキー名が servers で、mcpServers のまま書くとエラーも出ずに無視される。
  • 公式サーバーは認証なし・ローカル専用・デスクトップ版のみ。ブラウザ版Fusionでは使えず、同じPC上の他のプロセスからも到達できる前提で運用する。
  • OSSは、任意のPythonを実行させたい場合や、ツールの中身を自分で読んで直したい場合に使う。ndoo製 fusion360-mcp-bridge はツールが2つだけの薄い橋渡しで、Fusion APIの知識はCLAUDE.mdに寄せた設計。
  • fusion360-mcp-bridge はREADMEどおりに入れると、2026年9月時点ではどの版のPythonでも起動しない。3.9では依存が入らず、3.10以上では2026年7月公開のMCP SDK 2系が入って mcp.server.fastmcp の読み込みで落ちる。mcp<2 に固定し、~/.claude/settings.json ではなく claude mcp add で登録する。
  • uvx fusion360-mcp-server で入るのはPyPIの0.1.0(2026年2月2日公開・80ツール)で、GitHubのREADMEにある93ツール版ではない。

Fusion 360 MCPの接続経路と公式・OSSの構成比較

MCP(Model Context Protocol)はAIクライアントと外部ツールをつなぐ共通規格で、仕組みの全体像はMCP(Model Context Protocol)の仕組みの解説にまとめています。ここでは、2026年9月時点の公式サーバーと主要なOSSサーバー、計4種類を比較します。

経路 提供元 接続先 認証 ツール
Fusion MCP Server Autodesk(Fusion内蔵) 127.0.0.1:27182(Streamable HTTP) なし 接続時に動的に決まる
fusion360-mcp-bridge ndoo(MIT) 127.0.0.1:7654(HTTP) Bearerトークン 2
fusion360-mcp-server faust-machines(MIT) localhost:9876(TCP) なし 93(PyPI版は80)
autodesk-fusion-mcp frankhommers(MIT) 127.0.0.1:8765(Streamable HTTP) 記載なし 14

どの経路でも、実際に形状を作るのはFusionに組み込まれたPython API(adsk.core・adsk.fusion)です。このAPIはメインスレッドからしか呼べないため、OSSのアドインは外部から届いた要求をFusionの CustomEvent に載せてメインスレッドへ渡し、結果が戻るまで待つ作りになっています。ndoo版もfaust-machines版もこの方式を採っています。Fusion APIのリファレンスによると、ワーカースレッドから発火したCustomEventはキューに入り、Fusionがアイドルになった時点でメインスレッドで処理されます。重いスクリプトが走っている間は、後続の要求が待たされるということです。

なお製品名は2024年1月29日の更新で「Autodesk Fusion 360」から「Autodesk Fusion」に変わりました。OSSのREADMEはアドインの置き場所を Autodesk Fusion 360/API/AddIns と書き、Autodeskの現行のAPI資料は Autodesk Fusion/API/AddIns と書いていて、表記が揃っていません。フォルダをコピーする前に、Fusionの[スクリプトとアドイン]画面(Shift+S)で自分の環境の保存先を確かめてください。

もう1つ、名前が似ていて取り違えやすいのがAutodesk Fusion Data MCP Serverです。Autodeskのヘルプは、これを「Fusionのデータを扱うクラウド上の別サーバー」と説明しており、ハブ・プロジェクト・フォルダ・アイテムといったクラウド上のデータ管理を受け持ちます。Claude Desktopでは、URLを指定してカスタムコネクタとして自分で追加します。起動中のFusionを操作するのはローカルのFusion MCP Serverのほうで、こちらはAutodeskアカウントでのサインインを伴いません。

公式Fusion MCP Serverの有効化とクライアント別の接続手順

Fusion側の設定とポート27182

Fusionを起動し、[基本設定]>[一般]>[API]の「Fusion MCP サーバ(このデバイス上でローカルに実行されます)」にチェックを入れます。既定のポートは27182で、同じ画面で変更できます。変更した場合は、クライアント側のURLも同じ番号に書き換えます。手順の原文はAutodesk公式のConnecting to the Autodesk Fusion MCP Serverにあります。

API設定にこのチェックボックスとポート欄が無ければ、Fusionが古い版です。Autodeskのトラブルシューティングも、この症状には「Fusionを最新版に更新する」ことを対処として挙げています。Autodeskの開発者ブログ(日本語版・2026年5月4日)は、2026年4月の製品更新で、Fusion内のAIエージェントであるAutodesk AssistantからもこのMCPサーバーを使えるようになったと紹介しています。

Claude Desktopのコネクタ追加と接続確認

Claude Desktopでは設定のConnectors(コネクタ)画面を開き、右上のAddからBrowse connectorsを選んでディレクトリで「Fusion」を検索し、「Create, modify, and inspect CAD geometry in Fusion」と説明の付いたAutodesk Fusionをインストールします。公式ディレクトリに掲載されているので、カスタムコネクタとしてURLを入力する必要はありません。インストール後、コネクタ一覧に種別「Desktop」として表示されます。

つながったかどうかは、同じ画面でAutodesk Fusionコネクタを開き、「Tool permissions」にツールが並んでいるかで判断します。一覧が空なら未接続です。Autodeskの開発者ブログ(日本語版)によると、Claude Desktopの起動時にFusionが起動していないと接続が確立せずエラーになるため、Fusionを先に起動してからClaude Desktopを起動します。接続後に「10mmの立方体を作って」と頼むと、Fusion上に立方体が作られます。

Claude Code・Cursor・VS Codeの設定ファイル

Claude Codeは、公式サーバーをHTTPのMCPサーバーとして1行で登録できます。Claude Code 2.1.284で実行すると .claude.json の user 設定に書き込まれ、Fusionが起動していない状態の claude mcp list では接続拒否(ECONNREFUSED)と表示されました。この表示は、登録自体は済んでいてFusion側が待ち受けていないことを意味します。Claude Code自体の導入と権限設定はClaude Codeの導入から権限とCLAUDE.md設定までの手順を参照してください。

claude mcp add --transport http --scope user autodesk-fusion http://127.0.0.1:27182/mcp
claude mcp list

CursorとVS Codeは、同じURLを設定ファイルに書きます。キー名が製品ごとに違う点に注意します。Cursorは mcpServers に url を書き、VS Codeは servers に type と url を書きます。Autodeskのヘルプは、CursorやClaude Desktopの設定をVS Codeにそのまま貼ると、JSONとしては正しいためエラーが出ないまま、サーバーだけが無視されると明記しています。

Cursorの設定は、全プロジェクト共通なら ~/.cursor/mcp.json、プロジェクト単位なら .cursor/mcp.json に書きます。

{
  "mcpServers": {
    "autodesk-fusion": { "url": "http://127.0.0.1:27182/mcp" }
  }
}

VS Codeはワークスペースの .vscode/mcp.json に書きます。

{
  "servers": {
    "autodesk-fusion": { "type": "http", "url": "http://127.0.0.1:27182/mcp" }
  }
}

CursorはAgentモード、VS CodeはCopilot ChatのAgentモードでないとFusionのツールを呼びません。設定が正しいのに何も起きないときは、まずチャットのモードを確認します。

接続できないときの確認順

Autodesk公式のFusion MCP ServerのTroubleshootingにある症状を、確認する順に並べると次のとおりです。

  • ツール一覧が空、または接続できない:Fusionが起動していない、API設定のチェックが外れている、URLのポートが違う、のいずれか。
  • ツールは見えるがコマンドが実行されない:Fusionでドキュメント(デザイン)を開いていない。
  • 以前は動いていたのに止まった:Fusionを閉じたか再起動した。Fusionを開き直してチェックが残っているか確認する。
  • Claude Desktop以外で接続できない:ファイアウォールがポート27182を塞いでいないか確認する。

fusion360-mcp-bridge(ndoo)の設計とREADMEどおりに動かない3点

検索で「fusion360-mcp-bridge」と指名されることの多いndoo版は、2026年3月27日に1コミットで公開されたMITライセンスのリポジトリです。公式サーバーより前に作られたもので、README自体に「AutodeskがネイティブのMCPを出荷したら、自分のツールを置き換える」手順が書かれています。

2ツールとCLAUDE.mdに知識を寄せた設計

提供するツールは、任意のPythonスクリプトをFusion内で実行する fusion_execute と、ビューポートをPNGで返す fusion_screenshot の2つだけです。スケッチや押し出しのような個別ツールは持たず、Fusion APIの書き方はリポジトリ直下のCLAUDE.mdにまとめられています。CLAUDE.mdには、Fusionの内部単位がセンチメートルであることや、「最も多いエラーは、回転(revolve)のプロファイルが回転軸をまたぐこと」といった注意が書かれています。

この設計には前提があります。CLAUDE.mdを自動で読むのはClaude Codeで、クローンしたリポジトリのディレクトリで起動すれば、セッションの最初から読み込まれます。Claude Desktopから使うとCLAUDE.mdは読まれないため、同じ fusion_execute でも、回転軸まわりのエラーを避ける知識なしでスクリプトを書くことになります。ndoo版はClaude Codeから、クローンしたディレクトリで起動して使う前提で選びます。

Python 3.9・MCP SDK 2系・settings.jsonの落とし穴

1つ目はPythonの版です。READMEは要件を「Python 3.9+(macOS 12以降に付属)」としていますが、手元のmacOS付属Python 3.9.6では起動できません。依存する mcp パッケージはPyPI上で3.10以上を要求しており(1.0.0も最新の2.2.0も同じ)、さらに server.py がモジュールの最上位で httpx.AsyncClient | None という型注釈を使っているため、3.9ではファイルを読み込んだ時点で TypeError: unsupported operand type(s) for | になります。クイックスタートの確認処理は構文解析しかしないので、3.9でも「server.py OK」と表示されてしまいます。

2つ目は、Pythonを3.10以上にしても解決しない依存の問題です。requirements.txt は mcp>=1.0.0 と上限を切っていないため、いま入れるとPyPIの最新である2系(2.0.0は2026年7月28日公開)が入ります。MCP公式のPython SDKは2系で FastMCP を MCPServer に改名し、mcp.server.fastmcp を読み込むと ModuleNotFoundError を出すようにしました。ndoo版の server.py はこのモジュールを使うので、Python 3.12にmcp 2.2.0を入れて起動すると、その場で落ちます。mcp<2 に固定すると1系の最終版(1.30.0)が入り、server.py が読み込まれて2つのツールが登録されました。

3つ目は登録先です。クイックスタートとREADMEの手順4は、Claude Code用の設定を ~/.claude/settings.json の mcpServers に書き込みます。Claude Code 2.1.284で、このファイルだけを置いた状態で claude mcp list を実行すると「No MCP servers configured」と表示され、サーバーは認識されませんでした。claude mcp add で登録すると .claude.json に書き込まれ、一覧に表示されます。

以上を踏まえた導入手順は次のとおりです。Python 3.10以上(例ではpython3.12)が入っている前提で、リポジトリを取得したディレクトリで実行します。

git clone https://github.com/ndoo/fusion360-mcp-bridge.git
cd fusion360-mcp-bridge

# Python 3.10以上の仮想環境に、MCP SDKを1系に固定して依存を入れる
python3.12 -m venv ~/venv
~/venv/bin/pip install "mcp>=1.0.0,<2" "httpx>=0.27.0"

# アドインとサーバーが共有するトークンを作る
python3 -c "import secrets; print(secrets.token_hex(32))" > ~/.fusion-mcp-secret
chmod 600 ~/.fusion-mcp-secret

# settings.json ではなく claude mcp add で登録する($PWD はクローン先の絶対パス)
claude mcp add fusion360 -- ~/venv/bin/python3 "$PWD/mcp-server/server.py"

このあと fusion-addin/FusionMCPBridge フォルダをFusionのアドインフォルダへコピーし、Fusionの[スクリプトとアドイン](Shift+S)からFusionMCPBridgeを選んで実行します。起動ダイアログにトークン認証が有効と出れば準備完了で、Claude Codeを再起動してリポジトリのディレクトリで立ち上げます。Fusionのアドイン側はFusion同梱のPythonで動くため、手元のPythonの版には影響されません。問題が出るのはMCPサーバー側だけです。

30秒タイムアウト後もスクリプトが実行される設計

アドインは要求を受けると、CustomEventでメインスレッドへ処理を依頼して最大30秒待ち、間に合わなければ504を返します。ところが、すでに投入した処理を取り消す仕組みは無く、Fusionが空いた時点でスクリプトはそのまま実行されます。AIが「タイムアウトした」と受け取って同じ指示を出し直すと、同じボディが2つできることがあります。重い処理のあとに504が返ってきたら、再実行の前に fusion_screenshot やボディ一覧で現状を確かめるよう、指示に書き添えておくと防げます。

fusion360-mcp-server(faust-machines)とOSSサーバーの違い

fusion360-mcp-server は、スケッチ・フィーチャー・書き出し・CAMの設定までを個別のツールとして持つ多機能型で、GitHubのスター数は108(2026年9月30日時点)です。FastMCPによるPythonのMCPサーバー構築と同じく、Pythonで書かれたMCPサーバーがFusionのアドインへ命令を中継します。READMEは「Beta」と明記しています。

PyPI 0.1.0の80ツールとGitHub版との差

READMEは claude mcp add fusion360 -- uvx fusion360-mcp-server --mode socket での登録を案内し、ツール一覧を「93」としています。しかし、このコマンドが取得するPyPIの fusion360-mcp-server は0.1.0(2026年2月2日公開)しかありません。その配布物を展開して数えると、ツール定義は80件でした。ビューポートを画像で返す render_view やSTL・OBJ・3MFを読み込む import_mesh は入っておらず、LANの別マシンへ接続する --host オプションもありません。

93ツール版を使うには、MCPサーバーもGitHubから取得します。Fusion側のアドインは別に入れる必要があり、READMEの手順どおりリポジトリの addon フォルダをFusionのアドインフォルダへコピーして実行します。このときコピーするのはリポジトリの最新版なので、サーバーだけPyPI版にすると、アドインにある機能をサーバーが呼べない組み合わせになります。登録後は ping ツールを呼び、{"ok": true, "status": "pong"} が返れば接続できています。

claude mcp add fusion360 -- uvx --from git+https://github.com/faust-machines/fusion360-mcp-server fusion360-mcp-server --mode socket

OSSサーバーの採用条件と見送り条件

公式サーバーで必要な操作を実行でき、接続方式にも支障がなければ、まず公式サーバーを選びます。OSSが必要になるのは、次の条件のどれかに当てはまる場合です。

  • MCPサーバーを持たない古い版のFusionを使い続ける必要がある。
  • ツールの実装を読み、社内の定型作業に合わせて書き換えたい(faust-machines版の execute_code、ndoo版の fusion_execute は任意のPythonを実行できる)。
  • Streamable HTTPに対応しないクライアントからstdioで使いたい(ndoo版・faust-machines版はstdioのMCPサーバー)。

逆に、機密設計を開いたFusionにOSSを常駐させる運用は勧めません。faust-machines版のREADMEは、アドインのTCPソケットに認証が無いことを明記しています。frankhommers版(autodesk-fusion-mcp)は依存ライブラリなしでアドインだけで動く軽量型ですが、READMEに認証の記載がありません。

ローカル無認証と任意コード実行のセキュリティ上の注意

AutodeskはFusion MCP Serverを「ローカル専用で、リモート接続も認証も不要」と説明しています。PCの外からは届かない一方で、同じPC上で動く他のプロセスは、27182番ポートへ要求を送れる前提になります。ブラウザ拡張や不明なツールを常用している端末では、使わないときにAPI設定のチェックを外しておくのが確実です。

OSSの認証はまちまちです。ndoo版はアドインとサーバーが ~/.fusion-mcp-secret(パーミッション600)のトークンを共有し、一致しない要求には401を返します。ただしソースを読むと、このファイルが無い場合は全要求を通す作りです。起動時に「WARNING: no secret file」と出たら、トークンを作り直してから使います。faust-machines版は認証を持たず、FUSION_MCP_HOST=0.0.0.0 でLANに開く設定もあるため、READMEはインターネットから届くホストでの使用を禁じています。

任意のPythonを実行するツール(fusion_execute、execute_code)は、AIが書いたコードをそのままFusionのプロセス内で走らせます。形状だけでなく、ローカルのファイルにも手が届く権限です。作業は複製したデザインで行い、クライアント側のツール承認を「毎回確認」にしておくと、意図しない実行を止められます。

AIに任せられるモデリングと人が確認すべき工程

MCP経由のモデリングが安定するのは、寸法を数値で言い切れる単純な形状です。Autodeskの開発者ブログ(日本語版)では、「10mmの立方体」の作成、既存ボディへの外観の適用、表示中のアセンブリのパーツ一覧をPowerPointにまとめる作業が例として示されています。一方で、図面の画像から3Dモデルを起こす使い方は「完全ではないものの」可能で、数回の試行錯誤を経て形状ができたと書かれています。

回転体では、断面と軸の位置関係に注意が必要です。ndoo版のCLAUDE.mdが最も多いエラーとして挙げるのは、回転のプロファイルが軸をまたぐケースでした。テルえもん氏の試用報告にも、コップの底に穴が開き、回転軸と断面スケッチの不一致が原因と推測された例があります。コップ・ボトル・シャフトのような回転体を頼むときは、CLAUDE.mdと同じ規則(断面は軸の片側だけに描き、軸に接するのはよいが横切らない)を指示に含めておきます。

AutodeskもAutodesk Assistantの制限事項として、AIによる変更は保存や共有の前に確認すること、専門家の判断を置き換えるものではないことを挙げています。公差・干渉・加工方法との整合のように、間違いが製造コストに直結する判断は人が持ちます。CADに搭載されたAI機能全体の範囲はCADのAIで何ができるか(AutoCAD 2027・Fusionの搭載機能と生成AIの限界)で比較しています。

Fusion 360 MCPに関するよくある質問

Fusion 360 MCPは無料で使えますか?

この記事で比較したOSSのMCPサーバー3本はMITライセンスで無料です。Fusion側は、個人用のFusion Personal(自宅での非商用プロジェクト専用・年間収益1,000米ドル未満の個人が対象)でもスクリプト・アドイン・APIが使えるため、OSSのブリッジは動かせます。一方、Claudeの公式コネクタについてAnthropicの発表は「Fusionのサブスクリプションを持つ設計者・エンジニア向け」とだけ書いており、Personalで使えるかは明記していません。

fusion360-mcp-bridgeとfusion360-mcp-serverの違いは何ですか?

fusion360-mcp-bridge(ndoo)は任意のPython実行と画面キャプチャの2ツールだけを持ち、Fusion APIの知識をCLAUDE.mdに置く薄い橋渡しです。fusion360-mcp-server(faust-machines)はスケッチや書き出しを個別のツールとして持つ多機能型で、GitHub版は93ツール、PyPI版は80ツールです。

Claude以外のCursorやVS Codeからも使えますか?

使えます。公式のFusion MCP ServerはStreamable HTTPに対応したクライアントならつながり、AutodeskはClaude Desktop・Cursor・VS Codeの手順を公開しています。VS Codeは設定のキーが servers で、type の指定が必要です。

Fusion MCP ServerとFusion Data MCP Serverは何が違いますか?

Fusion MCP Serverは、PC上で起動中のFusionを操作するローカルのサーバーです。Fusion Data MCP Serverは、ハブ・プロジェクト・フォルダなどクラウド上のFusionデータを扱う別のサーバーで、Claude DesktopではURLを指定してカスタムコネクタとして追加します。Autodeskのヘルプはどちらも一般提供(GA)として掲載しています。

ブラウザ版のFusionでもMCPは使えますか?

使えません。Autodeskのヘルプは、Fusion MCP Serverはデスクトップ版専用で、Fusionのウェブクライアントでは動作しないと明記しています。Fusionをインストールして起動している同じPCから接続します。

関連記事

お気に入りに入れた記事の一覧

一創の公式 SNS

X では毎朝の新着記事と IT ニュースの速報を、YouTube・TikTok・Instagram・LinkedIn・Facebook では記事の解説動画を配信しています。

この記事は以下の記事からリンクされています

資料請求

今日のトレンド記事 直近 24 時間で、いつもより多く読まれている記事

  1. 2026.11.09 テックブログ エディオン不正アクセス第2報:カード番号の対象確認とログ・決済画面の改ざん対策
  2. 2026.11.10 テックブログ ニトリの情報漏洩:最大3,762万件の対象確認となりすまし連絡の見分け方
  3. 2026.11.10 テックブログ Claude Fable 5.2とは:料金・破壊的変更4点とFable 5.1からの移行手順【2026年11月】
  4. 2026.11.09 テックブログ LANSCOPE不正アクセス第2報:製品への影響と偽連絡の確認、停止中のライセンス認証の窓口
  5. 2025.04.30 テックブログ IMSIキャッチャー(偽基地局)とは?2Gフォールバックの手口と日本での対策

RELATED POSTS 関連記事

目次