Frequently Asked Questions

Everything you need to know about SOAR MCP connectors. Can't find your answer? Contact us.

常見問題解答

📦 Installation 安裝

SOAR MCP connectors are built as Python packages distributed via pip. Python provides cross-platform compatibility and a rich ecosystem for automation. We use Python 3.10+ for modern async features. The MCP protocol itself is language-agnostic, but our connectors leverage Python's COM automation (via pywin32) and subprocess capabilities for desktop app control.
SOAR only needs outbound HTTPS (port 443) access to soar-license.soarmcp.workers.dev for license verification. Add this domain to your firewall allowlist. All MCP operations run locally and don't require internet access after initial license verification. If you're behind a corporate proxy, set the HTTPS_PROXY environment variable.
We recommend the official Python installer from python.org instead of the Windows Store version. The Store version has sandboxing restrictions that can interfere with COM automation and file system access needed by SOAR connectors. During installation, make sure to check "Add Python to PATH".
SOAR requires Python 3.10 or higher. We recommend Python 3.11 or 3.12 for best performance. You can check your version by running python --version in your terminal. If you have multiple Python versions installed, ensure the correct one is in your PATH or use py -3.12 on Windows.

🔑 License 授權

Yes. Each license supports up to 2 device bindings. If you've reached the limit, contact us at soardesignjimmy@gmail.com to reset your device binding. We'll process the request within 24 hours. Please include your license key and the reason for the transfer.
Each SOAR license allows activation on up to 2 devices simultaneously. This covers typical scenarios like a desktop workstation and a laptop. If you need more devices, consider our team licensing options or contact us for a custom arrangement.
Yes, we offer volume licensing for teams of 5 or more. Team licenses come with centralized management, volume discounts, and priority support. Contact soardesignjimmy@gmail.com for a custom quote based on your team size and product needs.
Email us at soardesignjimmy@gmail.com with the email address you used to purchase. We'll verify your identity and resend your license key. For Gumroad purchases, you can also check your Gumroad library at app.gumroad.com/library.

🛠️ Usage 使用

SOAR requires internet connectivity for the initial license verification when you start a session. After that, all MCP operations run locally on your machine. License re-verification occurs periodically (approximately every 24 hours). If you lose internet mid-session, existing operations will continue working.
SOAR supports Microsoft Office 2016, 2019, 2021, and Microsoft 365 (desktop versions). The connectors use COM automation, so the desktop application must be installed — Office Online/web versions are not supported. Both 32-bit and 64-bit Office installations work.
Yes! SOAR connectors implement the standard MCP (Model Context Protocol) specification. Any AI platform that supports MCP can use SOAR connectors. This includes Claude Desktop, Cursor, Windsurf, and other MCP-compatible clients. The connector doesn't care which AI is sending the commands.
Custom skills are AI-side prompt templates that chain multiple MCP tool calls together. You can define them in your AI client's configuration. For example, in Claude Desktop, you can create a skill that combines AutoCAD drawing commands with Excel data reading. Check our documentation on GitHub for skill template examples and best practices.

🔧 Troubleshooting 故障排除

Connection timeouts usually indicate a network issue reaching our license server. Check: (1) Your internet connection is active. (2) Your firewall allows outbound HTTPS to soar-license.soarmcp.workers.dev. (3) If behind a proxy, set HTTPS_PROXY. (4) Try running curl https://soar-license.soarmcp.workers.dev/health to test connectivity. If the issue persists, it may be a temporary Cloudflare edge issue — wait a few minutes and retry.
Verify: (1) The package is installed: pip show soar-autocad-mcp. (2) Your MCP client config points to the correct Python path. (3) The target application (e.g., AutoCAD) is running and accessible. (4) On Windows, run your AI client as the same user that has the application installed. Check the connector logs in %APPDATA%\soar\logs\ for detailed error messages.
SOAR licenses are perpetual for the major version purchased. If your license shows as expired: (1) Check that your system clock is accurate. (2) Try restarting the connector. (3) If you recently renewed, clear the local license cache by deleting %APPDATA%\soar\license_cache.json. (4) Contact soardesignjimmy@gmail.com if the issue persists.
Error codes are documented in each product's GitHub repository README. Common codes: E001 — License invalid. E002 — Device limit exceeded. E003 — Application not running. E004 — COM connection failed. E005 — Network timeout. For unlisted error codes, open a GitHub issue with the full error message and we'll help diagnose.

💳 Billing 帳單

We offer a limited free tier for select products so you can test the MCP integration with your workflow. Check each product's page on Gumroad for current trial availability. Some connectors like Blender MCP have community editions with basic features available for free.
We sell through Gumroad, which accepts: Credit/debit cards (Visa, Mastercard, American Express), PayPal, and Apple Pay. For enterprise or bulk purchases, we can arrange direct invoicing and bank transfer. Contact us for alternative payment arrangements.
SOAR uses one-time purchase licensing, not subscriptions. Once you buy a license, it's yours for the major version purchased. There's nothing to cancel. Future major version upgrades may require a new purchase at a discounted upgrade price. Minor version updates and patches are always free.