よくある質問

SOAR MCPコネクタについて知っておくべきすべてのこと。回答が見つからない場合はお問合せください。

📦 インストール

SOAR MCPコネクタはpipで配布されるPythonパッケージとして構築されています。Pythonはクロスプラットフォーム互換性と豊富な自動化エコシステムを提供します。モダンなasync機能のためにPython 3.10+を使用しています。MCPプロトコル自体は言語に依存しませんが、コネクタはデスクトップアプリ制御のためにPythonのCOM自動化(pywin32経由)とサブプロセス機能を活用しています。
SOARはライセンス認証のためにsoar-license.soarmcp.workers.devへのアウトバウンドHTTPS(ポート443)アクセスのみが必要です。このドメインをファイアウォールの許可リストに追加してください。すべてのMCP操作はローカルで実行され、初回ライセンス認証後はインターネットアクセスは不要です。企業プロキシの背後にいる場合は、HTTPS_PROXY環境変数を設定してください。
Windows Store版ではなく、python.orgの公式Pythonインストーラーを推奨します。Store版にはサンドボックス制限があり、SOARコネクタに必要なCOM自動化やファイルシステムアクセスに干渉する可能性があります。インストール時に「Add Python to PATH」にチェックを入れてください。
SOARにはPython 3.10以上が必要です。最高のパフォーマンスにはPython 3.11または3.12を推奨します。ターミナルでpython --versionを実行してバージョンを確認できます。複数のPythonバージョンがインストールされている場合は、正しいバージョンがPATHに含まれていることを確認するか、Windowsでpy -3.12を使用してください。

🔑 ライセンス

はい。各ライセンスは最大2台のデバイスバインディングをサポートしています。上限に達した場合は、soardesignjimmy@gmail.comまでご連絡いただき、デバイスバインディングをリセットしてください。24時間以内に処理いたします。ライセンスキーと移行理由をお知らせください。
SOARライセンスは最大2台のデバイスで同時にアクティベーションできます。デスクトップワークステーションとノートパソコンなどの一般的なシナリオに対応しています。より多くのデバイスが必要な場合は、チームライセンスオプションをご検討いただくか、カスタムプランについてお問合せください。
はい、5名以上のチーム向けにボリュームライセンスを提供しています。チームライセンスには集中管理、ボリュームディスカウント、優先サポートが含まれます。チーム規模と製品ニーズに基づくカスタム見積もりはsoardesignjimmy@gmail.comまでお問合せください。
ご購入時に使用したメールアドレスを添えてsoardesignjimmy@gmail.comにメールしてください。本人確認後、ライセンスキーを再送いたします。Gumroadでのご購入の場合は、app.gumroad.com/libraryのGumroadライブラリでも確認できます。

🛠️ 使い方

SOARはセッション開始時の初回ライセンス認証にインターネット接続が必要です。その後、すべてのMCP操作はローカルマシンで実行されます。ライセンスの再認証は定期的に(約24時間ごとに)行われます。セッション中にインターネット接続が切れた場合、既存の操作は引き続き動作します。
SOARはMicrosoft Office 2016、2019、2021、Microsoft 365(デスクトップ版)に対応しています。コネクタはCOM自動化を使用するため、デスクトップアプリケーションがインストールされている必要があります。Office Online/Web版には対応していません。32ビットと64ビットの両方のOfficeインストールで動作します。
はい!SOARコネクタは標準のMCP(Model Context Protocol)仕様を実装しています。MCPをサポートするあらゆるAIプラットフォームでSOARコネクタを使用できます。Claude Desktop、Cursor、Windsurf、その他のMCP互換クライアントが含まれます。コネクタはどのAIがコマンドを送信しているかを問いません。
カスタムスキルは、複数のMCPツール呼び出しを連鎖させるAI側のプロンプトテンプレートです。AIクライアントの設定で定義できます。例えば、Claude DesktopでAutoCADの描画コマンドとExcelのデータ読み取りを組み合わせたスキルを作成できます。スキルテンプレートの例とベストプラクティスについては、GitHubのドキュメントをご確認ください。

🔧 トラブルシューティング

接続タイムアウトは通常、ライセンスサーバーへのネットワーク問題を示しています。確認事項:(1) インターネット接続がアクティブであること。(2) ファイアウォールがsoar-license.soarmcp.workers.devへのアウトバウンドHTTPSを許可していること。(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を開いてください。診断をお手伝いします。

💳 お支払い

一部の製品で限定的な無料ティアを提供しており、ワークフローとのMCP統合をテストできます。現在のトライアル利用可能状況は、Gumroadの各製品ページでご確認ください。Blender MCPなど一部のコネクタには、基本機能を無料で利用できるコミュニティエディションがあります。
購入日から14日間の返金ポリシーを設けています。製品が説明通りに動作しない場合やニーズに合わない場合は、注文詳細を添えてsoardesignjimmy@gmail.comにご連絡ください。返金は元の支払いプラットフォーム(Gumroad)を通じて処理されます。返金されたライセンスは無効化されますのでご了承ください。
Gumroadを通じて販売しており、以下の支払い方法に対応:クレジット/デビットカード(Visa、Mastercard、American Express)、PayPal、Apple Pay。企業向けまたは大量購入の場合は、直接請求書発行および銀行振込の手配が可能です。その他のお支払い方法についてはお問合せください。
SOARはサブスクリプションではなく、買い切りライセンスを採用しています。ライセンスを購入すると、購入したメジャーバージョンに対して永続的に有効です。キャンセルするものはありません。将来のメジャーバージョンアップグレードには、割引アップグレード価格での新規購入が必要になる場合があります。マイナーバージョンアップデートとパッチは常に無料です。