1. 系統要求
| 項目 | 最低 | 建議 |
|---|---|---|
| 作業系統 | Windows 10 64-bit (Build 19041+) | Windows 11 64-bit |
| 記憶體 | 8 GB | 16 GB+ |
| 硬碟空間 | 500 MB | 2 GB+ |
| 網絡 | 需要互聯網（HTTPS）作授權驗證與模組下載 | |
| AI 客戶端 | Claude Desktop 或 Claude Code（最新版） | |
| 目標軟件 | 所訂閱的軟件須安裝喺同一部機（AutoCAD 2026 / Revit / Navisworks 2027 / SAP2000 V27 / ETABS V23 / SAFE V23 / Office） | |
唔需要安裝 Python — SOAR 連接器係獨立編譯執行檔，冇任何依賴。
2. 一鍵安裝
- 下載產品安裝包並解壓到任意資料夾
- 右鍵
install.bat→「以系統管理員身份執行」 - 依提示輸入授權碼（購買後由 SOAR 電郵發送）
- 見到「Installation complete」— Claude 配置已自動寫入
- 開啟目標軟件（例如 AutoCAD、ETABS、Excel）
- 完全重啟 Claude Desktop / Claude Code
- 測試指令：「列出當前圖檔所有圖層」
⚠️ 如 Windows SmartScreen 彈出提示，按「其他資訊 → 仍要執行」。防毒軟件誤攔截時，請將 SOAR 安裝資料夾加入白名單。
3. 架構：Shell + Soul
輕量 Shell（launcher 執行檔）安裝喺你部機，負責授權驗證同載入模組；Soul（功能模組）每次啟動時經 TLS 由 *.soarmcpsoftware.com 雲端並行下載到記憶體 — 首次啟動約 15 秒，更新即時生效，唔使重裝。你嘅圖檔、模型、文件永遠留喺本機。
4. 防火牆與網絡
| 方向 | 連接埠 | 目的地 | 用途 |
|---|---|---|---|
| 出站 | 443 (HTTPS) | api.anthropic.com | Claude AI API |
| 出站 | 443 (HTTPS) | *.soarmcpsoftware.com | 授權驗證與模組下載 |
| 本機 | 動態 | localhost | MCP stdio 傳輸 |
企業代理伺服器：設定 HTTPS_PROXY 環境變數即可。
5. 授權啟用
- 購買後（Stripe 結帳），授權碼會由 SOAR 電郵送達
- install.bat 安裝時輸入授權碼，安全儲存喺本機
- 每個授權最多綁定 2 部裝置；換機請聯絡我們重設
- 7 日免費試用碼於下載時發出，升級付費訂閱無需重裝
- 更換授權碼：重新執行
install.bat輸入新碼即可，設定會保留
6. 故障排除
❌ MCP server failed to start
以系統管理員身份重新執行 install.bat；檢查防毒隔離區並將 SOAR 資料夾加入白名單。
❌ 連接唔到軟件 / COM 錯誤
確保目標軟件（AutoCAD、ETABS、Excel 等）已開啟並完全載入；用同一個 Windows 用戶執行 Claude 同目標軟件。
❌ 授權驗證失敗
檢查防火牆是否允許 HTTPS 連出至 *.soarmcpsoftware.com；企業代理請設定 HTTPS_PROXY。
❌ 首次啟動模組下載慢
首次啟動並行下載模組（寬頻約 15 秒），之後會快好多。重試一次並確認網絡可達 *.soarmcpsoftware.com。
仍然有問題？聯絡 soardesignjimmy@gmail.com 或致電 (+852) 9833 1166。