자주 묻는 질문

SOAR MCP 커넥터는 pip을 통해 배포되는 Python 패키지로 구축됩니다. Python은 크로스 플랫폼 호환성과 풍부한 자동화 생태계를 제공합니다. 최신 비동기 기능을 위해 Python 3.10 이상을 사용합니다. MCP 프로토콜 자체는 언어에 구애받지 않지만, 커넥터는 데스크톱 앱 제어를 위해 Python의 COM 자동화(pywin32)와 서브프로세스 기능을 활용합니다.

SOAR는 라이선스 인증을 위해 soar-license.soarmcp.workers.dev에 대한 아웃바운드 HTTPS(포트 443) 접근만 필요합니다. 이 도메인을 방화벽 허용 목록에 추가하세요. 모든 MCP 작업은 로컬에서 실행되며 초기 라이선스 인증 후에는 인터넷 접근이 필요하지 않습니다. 기업 프록시 뒤에 있다면 HTTPS_PROXY 환경 변수를 설정하세요.

python.org의 공식 Python 설치 프로그램을 사용하는 것을 권장합니다. Windows 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/웹 버전은 지원되지 않습니다. 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 이슈를 작성하면 진단을 도와드립니다.

일부 제품에 대해 제한된 무료 체험을 제공하여 워크플로우에서 MCP 통합을 테스트할 수 있습니다. 현재 체험 가능 여부는 Gumroad의 각 제품 페이지를 확인하세요. Blender MCP 같은 일부 커넥터에는 기본 기능을 무료로 사용할 수 있는 커뮤니티 에디션이 있습니다.

구매일로부터 14일 환불 정책을 제공합니다. 제품이 설명대로 작동하지 않거나 요구 사항을 충족하지 못하는 경우 주문 정보와 함께 soardesignjimmy@gmail.com으로 문의하세요. 환불은 원래 결제 플랫폼(Gumroad)을 통해 처리됩니다. 환불된 라이선스는 비활성화됩니다.

Gumroad를 통해 판매하며, 지원하는 결제 방법: 신용/체크카드(Visa, Mastercard, American Express), PayPal, Apple Pay. 엔터프라이즈 또는 대량 구매의 경우 직접 청구 및 은행 이체를 준비할 수 있습니다. 대체 결제 방법은 문의해 주세요.

SOAR는 구독이 아닌 일회 구매 라이선스를 사용합니다. 라이선스를 구매하면 해당 메이저 버전에 대해 영구적으로 사용할 수 있습니다. 취소할 것이 없습니다. 향후 메이저 버전 업그레이드에는 할인된 업그레이드 가격으로 새 구매가 필요할 수 있습니다. 마이너 버전 업데이트와 패치는 항상 무료입니다.