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から接続します。