常见问题

关于 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 使用一次性购买授权,而非订阅制。购买授权后,该主要版本的使用权即为您所有,无需取消任何项目。未来的主要版本升级可能需要以优惠升级价格重新购买。次要版本更新和修补程序永远免费。