============================================================
  Soar Navisworks 2027 MCP — V1.0
  一鍵安裝包（客戶版，Claude / Cowork）
  For Autodesk Navisworks Manage 2027
  By Soar Design (Jimmy Kwok) © 2026
============================================================

【安裝前確認】

1. Windows 10 / 11 64-bit
2. Autodesk Navisworks Manage 2027 已裝
3. Claude 桌面版或 Cowork 已安裝
4. 已向 Soar Design 買咗 Navisworks 專用 license key
       格式：SOAR-NAVI-XXXX-XXXX-XXXX
       （Navisworks 同 Revit / Office 係獨立 license，唔共用）

* 唔需要裝 Python！安裝包已包含所有執行檔。

【架構簡介】

Soar Navisworks MCP 由兩部份組成：

  (a) C# Navisworks Plugin (NavisMCPBridge.dll)
      — 跑喺 Navisworks 入面，接 Named Pipe 命令，直接 call Navisworks API
      — 自動安裝到 ApplicationPlugins bundle

  (b) MCP Server (launcher.exe + in-memory server)
      — 跑喺 Claude / Cowork 啟動嘅 stdio subprocess
      — 每次啟動自動 check Cloudflare 有冇新版 server module
      — C# Plugin DLL 唔係自動更新（要 update 就重裝 installer）

【安裝步驟】

1. 解壓呢個 zip 去任何資料夾（建議 D:\Soar\Navis_MCP）
   * 唔好放喺 Program Files（會權限問題）
   * 路徑唔好有中文、空格、括號或特殊字元

2. 雙擊 install.bat
   等佢自動做晒 5 步：
   - 檢查 launcher.exe 存在
   - 問你攞 license key
   - 自動 copy NavisMCPBridge.dll + PackageContents.xml 去
     C:\ProgramData\Autodesk\ApplicationPlugins\NavisMCPBridge.bundle\
   - 試連 Cloudflare server，下載最新 server module
   - 寫 Cowork MCP config

3. 見到「Installation complete!」：
   a. 如果 Navisworks 正開緊，關咗再開 Navisworks Manage 2027
   b. 開任何 .nwd 或 .nwf 檔
   c. 退出 Cowork / Claude Desktop 再重開
   d. 試 prompt：「ping Navisworks」或「get doc info」

【日常使用】

* 開 Autodesk Navisworks Manage 2027 + 開一個 .nwd/.nwf 檔
* 開 Claude / Cowork
* 直接問，例如：
    「get doc info」
    「list all clash tests」
    「run clash test 'Arch vs Structure'」
    「list saved viewpoints」
    「create section plane」
    「play timeliner simulation」

MCP 會 route 到 Navisworks MCP Bridge，直接操控 Navisworks。

【自動更新】

Server 邏輯係自動更新：每次啟動時，launcher 會
check Cloudflare 有冇新版 server module，有就 download 到 RAM。
客戶完全被動。

C# Plugin DLL 唔係自動更新 — 要 update 就重新 install.bat
（因為 Navisworks 要關閉先換得 DLL）。

【卸載】

雙擊 uninstall.bat 會：
* 刪除本地鎖定檔案 + log
* 刪除 Cowork / Claude 入面 soar-navisworks2027 MCP entry
* 刪除 C:\ProgramData\Autodesk\ApplicationPlugins\NavisMCPBridge.bundle\
  （執行 uninstall.bat 前請先關 Navisworks，否則檔案會被鎖定）

【緊急解鎖】

如果 MCP 被鎖定（例如 anomaly 觸發），雙擊 unlock_mcp.bat
清除本地鎖定檔案，然後重啟 MCP。

【疑難解答】

Q: install.bat 話 "Install path contains special characters"？
A: 路徑有括號、!、& 等特殊字元。搬去簡單路徑如 D:\Soar\Navis_MCP

Q: install.bat 話搵唔到 launcher.exe？
A: 確認 launcher.dist 資料夾同 launcher.exe 完整存在。
   如有損毀，請重新下載安裝包。

Q: Navisworks 開咗但 Plugin 冇 load？
A: 確認 C:\ProgramData\Autodesk\ApplicationPlugins\NavisMCPBridge.bundle\
   入面有 PackageContents.xml 同 Contents\NavisMCPBridge.dll

Q: MCP 連到但命令報 "pipe not connected"？
A: Navisworks 要喺啟動狀態，而且要打開至少一個 model 檔案。

Q: License 話 invalid？
A: 核對 key 冇打錯；過期請聯絡 Soar。

Q: License 話 "bound to another machine"？
A: 每個 license 綁定一部機。如需轉機，聯絡 Soar 申請 transfer。

【技術支援】

Email   : info@soarmcpsoftware.com
Subject : 請包含 license key 前 8 位，例如 SOAR-NAVI Navisworks 問題

============================================================
