常見問題

關於 SOAR MCP 連接器您需要了解的一切。找不到答案?請聯絡我們。

常見問題解答

📦 Installation 安裝

SOAR MCP 連接器是以 Python 套件形式透過 pip 發佈。Python 提供跨平台相容性和豐富的自動化生態系統。我們使用 Python 3.10+ 以支援現代異步功能。MCP 協議本身不限程式語言,但我們的連接器利用 Python 的 COM 自動化(透過 pywin32)和子進程功能來控制桌面應用程式。
SOAR 僅需透過 HTTPS(連接埠 443)連出至 soar-license.soarmcp.workers.dev 進行授權驗證。請將此網域加入防火牆白名單。所有 MCP 操作都在本機執行,初次授權驗證後不需要網路連線。如果您在企業代理伺服器後方,請設定 HTTPS_PROXY 環境變數。
我們建議使用 python.org 的官方 Python 安裝程式,而非 Windows Store 版本。Store 版本有沙盒限制,可能會干擾 SOAR 連接器所需的 COM 自動化和檔案系統存取。安裝時請務必勾選「Add Python to PATH」。
SOAR 需要 Python 3.10 或更高版本。我們建議使用 Python 3.11 或 3.12 以獲得最佳效能。您可以在終端機執行 python --version 來檢查版本。如果安裝了多個 Python 版本,請確保正確的版本在 PATH 中,或在 Windows 上使用 py -3.12

🔑 License 授權

可以。每個授權支援最多 2 台裝置綁定。如果已達上限,請聯絡 soardesignjimmy@gmail.com 重設裝置綁定。我們將在 24 小時內處理請求。請附上您的授權金鑰和轉移原因。
每個 SOAR 授權允許同時在最多 2 台裝置上啟用。這涵蓋了桌上型工作站和筆記型電腦等典型使用場景。如果您需要更多裝置,請考慮我們的團隊授權方案或聯絡我們安排客製方案。
有的,我們為 5 人以上的團隊提供大量授權。團隊授權包含集中管理、批量折扣和優先支援。請聯絡 soardesignjimmy@gmail.com 根據您的團隊規模和產品需求取得客製報價。
請使用購買時的電子郵件地址寄信至 soardesignjimmy@gmail.com。我們將驗證您的身份並重新發送授權金鑰。如果是透過 Gumroad 購買,您也可以在 app.gumroad.com/library 查看您的 Gumroad 資料庫。

🛠️ Usage 使用

SOAR 在啟動工作階段時需要網路連線進行初次授權驗證。之後,所有 MCP 操作都在您的本機執行。授權重新驗證會定期進行(大約每 24 小時一次)。如果您在工作階段中途斷網,現有操作將繼續運作。
SOAR 支援 Microsoft Office 2016、2019、2021 和 Microsoft 365(桌面版)。連接器使用 COM 自動化,因此必須安裝桌面應用程式——不支援 Office Online/網頁版。32 位元和 64 位元 Office 安裝都可使用。
可以!SOAR 連接器實作標準 MCP(Model Context Protocol)規範。任何支援 MCP 的 AI 平台都可以使用 SOAR 連接器,包括 Claude Desktop、Cursor、Windsurf 和其他相容 MCP 的用戶端。連接器不在乎是哪個 AI 在發送指令。
自訂技能是 AI 端的提示範本,可將多個 MCP 工具呼叫串連在一起。您可以在 AI 用戶端的設定中定義它們。例如,在 Claude Desktop 中,您可以建立一個技能,將 AutoCAD 繪圖指令與 Excel 資料讀取結合。請查看我們在 GitHub 上的文件,了解技能範本範例和最佳實務。

🔧 Troubleshooting 故障排除

連線逾時通常表示連接授權伺服器時發生網路問題。請檢查:(1) 網路連線是否正常。(2) 防火牆是否允許 HTTPS 連出至 soar-license.soarmcp.workers.dev。(3) 如在代理伺服器後方,請設定 HTTPS_PROXY。(4) 嘗試執行 curl https://soar-license.soarmcp.workers.dev/health 測試連線。如果問題持續,可能是暫時的 Cloudflare 邊緣問題——請等待幾分鐘後重試。
請驗證:(1) 套件已安裝:pip show soar-autocad-mcp。(2) MCP 用戶端設定指向正確的 Python 路徑。(3) 目標應用程式(如 AutoCAD)正在執行且可存取。(4) 在 Windows 上,請以安裝該應用程式的相同使用者執行 AI 用戶端。查看 %APPDATA%\soar\logs\ 中的連接器日誌以獲取詳細錯誤訊息。
SOAR 授權為所購買主要版本的永久授權。如果您的授權顯示已過期:(1) 檢查系統時鐘是否準確。(2) 嘗試重新啟動連接器。(3) 如果最近續約,請刪除 %APPDATA%\soar\license_cache.json 清除本機授權快取。(4) 如問題持續,請聯絡 soardesignjimmy@gmail.com
錯誤代碼記錄在每個產品的 GitHub 儲存庫 README 中。常見代碼:E001 — 授權無效。E002 — 超過裝置限制。E003 — 應用程式未執行。E004 — COM 連線失敗。E005 — 網路逾時。對於未列出的錯誤代碼,請在 GitHub 上開啟 issue 並附上完整錯誤訊息,我們將協助診斷。

💳 Billing 帳單

我們為精選產品提供有限的免費方案,讓您可以測試 MCP 與您工作流程的整合。請查看 Gumroad 上各產品頁面了解目前的試用可用性。部分連接器如 Blender MCP 有社群版本,提供免費的基本功能。
我們透過 Gumroad 銷售,接受:信用卡/簽帳卡(Visa、Mastercard、American Express)、PayPal 和 Apple Pay。對於企業或大量採購,我們可安排直接開立發票和銀行轉帳。如需其他付款方式請聯絡我們。
SOAR 使用一次性購買授權,而非訂閱制。購買授權後,該主要版本的使用權即為您所有,無需取消任何項目。未來的主要版本升級可能需要以優惠升級價格重新購買。次要版本更新和修補程式永遠免費。