---
title: "Fusion 360 MCPの使い方｜公式MCPサーバーとfusion360-mcp-bridge等OSSの接続手順"
url: "https://www.issoh.co.jp/tech/details/12533/"
published: 2026-06-15
updated: 2026-09-30
categories: ["AIエージェント・MCP"]
publisher: "株式会社一創"
---

# 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）の仕組みの解説](/tech/details/5736/)にまとめています。ここでは、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](https://help.autodesk.com/view/ADSKMCP/ENU/?guid=ADSKMCP%5FFusionDesktopMcp%5Fconnecting%5Fto%5Fthe%5Ffusion%5Fmcp%5Fserver%5Fhtml)にあります。

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設定までの手順](/tech/details/17375/)を参照してください。

```
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](https://help.autodesk.com/view/ADSKMCP/ENU/?guid=ADSKMCP%5FFusionDesktopMcp%5Ftroubleshooting%5Fhtml)にある症状を、確認する順に並べると次のとおりです。

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

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

検索で「fusion360-mcp-bridge」と指名されることの多い[ndoo版](https://github.com/ndoo/fusion360-mcp-bridge)は、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](https://github.com/faust-machines/fusion360-mcp-server) は、スケッチ・フィーチャー・書き出し・CAMの設定までを個別のツールとして持つ多機能型で、GitHubのスター数は108（2026年9月30日時点）です。[FastMCPによるPythonのMCPサーバー構築](/tech/details/6507/)と同じく、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の限界）](/tech/details/8616/)で比較しています。

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

## 関連記事

- [CADのAIで何ができるか｜AutoCAD 2027・Fusionの搭載機能と生成AIの限界【2026年7月】](/tech/details/8616/)
- [Photoshop MCPとは｜Claude公式AdobeコネクタとOSSサーバーでAIからPhotoshopを操作する方法](/tech/details/11969/)
- [Ableton MCPの導入と使い方｜ClaudeでAbleton Liveを操作する手順](/tech/details/10266/)
- [MCP（Model Context Protocol）とは？AIと外部ツールをつなぐ標準規格の仕組みをわかりやすく解説](/tech/details/5736/)

---

出典: [Fusion 360 MCPの使い方｜公式MCPサーバーとfusion360-mcp-bridge等OSSの接続手順](<https://www.issoh.co.jp/tech/details/12533/>)（株式会社一創）