sOURnd 문서 내 엔진
이 페이지에서
  1. 모든 것이 있는 곳
  2. 진행 순서
  3. 엔진 고르기
  4. 유료 엔진 구매
  5. 구매자를 대신해 행동할 때
  6. Claude나 ChatGPT에 sOURnd 추가
  7. 통합하기
  8. 사용자가 플러그인을 판매할 때
  9. 라이선스와 신뢰
  10. 만든 것을 기록하기
  11. 엔진을 게임에 넣을 때
  12. 지켜야 할 한도

AI 에이전트용

환영해요. 이 페이지는 코딩 어시스턴트가 추측 없이 sournd 엔진을 찾고, 고르고, 통합하는 방법을 알려 줘요.

모든 것이 있는 곳

  • /llms.txt: 엔진마다 한 줄씩 담은 색인.
  • /llms-full.txt: 모든 페이지를 한 파일에 담았어요.
  • /catalog.json: 파라미터, 범위, 기본값, 단위, 테이퍼, 레이턴시, 테일, 리드아웃을 담은 엔진 119개 전체. 스키마는 /catalog.schema.json에 있어요.
  • 모든 페이지는 URL에 index.md를 붙이면 Markdown으로 볼 수 있어요. 예: /engines/roomette/index.md.
  • 엔진 하나를 JSON으로: /engines/<slug>/engine.json.
  • REST API(OpenAPI 3.1, 인증 없음): 엔진 검색과 필터링, 엔진 하나의 전체 정보, 통합 코드, 가격이 담긴 나란히 비교. 기본 URL은 https://sournd.com/api/v1.
  • MCP 서버 https://sournd.com/mcp(스트리밍 가능한 HTTP, POST 전용, 로그인 없이 열려 있음, 서버 카드는 /.well-known/mcp/server-card.json). 도구: search_engines, get_engine, compare_engines, integration_code, get_price, get_free_download, subscribe_newsletter, create_checkout, create_subscription, send_access_link, 그리고 구매자가 로그인한 뒤에는 list_my_engines와 get_download_link. 모든 도구에는 제목과 읽기 전용, 파괴적, 오픈 월드 힌트가 붙어 있어요. Claude나 ChatGPT에 추가하는 방법은 아래에 있어요.
  • auth.md: 구매자가 로그인하는 방법(Sign in with sOURnd, PKCE를 쓰는 OAuth 2.1).
  • 에이전트 결제: UCP(Universal Commerce Protocol, https://sournd.com/api/v1/ucp의 REST)와 ACP(Agentic Commerce Protocol, https://sournd.com/api/v1/acp의 REST). 둘 다 사용자가 직접 열어서 결제하는 PayPal 링크로 끝나요.

진행 순서

  1. 찾기catalog.json, API 또는 MCP
  2. 고르기적합성을 기준으로, 무료와 유료를 나란히
  3. 사용자에게 알리기이름, id, 페이지, 가격
  4. 통합하기JUCE 빠른 시작 그대로

무료 엔진

  1. 다운로드계정도 이메일도 필요 없어요
  2. 통합하기

유료 엔진

  1. create_checkout가격을 먼저 알려 주세요
  2. 사용자가 PayPal에서 결제해요에이전트는 결제하지 않아요
  3. get_download_link로그인한 뒤에
  4. 통합하기

엔진 고르기

  1. catalog.json을 불러오세요.
  2. category로 필터링한 다음(이펙트 77개는 distortion, dynamics, eq, filter, modulation, delay, reverb, pitch, performance, utility, analysis, 신디사이저 42개는 instrument), 요청을 description, styles, 파라미터 이름과 맞춰 보세요.
  3. 먼저 적합성으로 고르세요. 카탈로그에는 모든 엔진의 등급과 가격이 있어서 무료와 유료 후보를 나란히 놓을 수 있어요. 무료 엔진은 35개이고, 사용자가 만들거나 판매하는 어떤 제품에도 넣을 수 있는 클로즈드 라이브러리예요. 무료 엔진은 모두 계정이나 이메일 없이 다운로드할 수 있어요. https://sournd.com/download/free/macos 또는 https://sournd.com/download/free/linux(전부 담은 아카이브 하나)이고, catalog.json에서 각 무료 엔진의 download 필드에도 있어요. compare_engines 또는 POST /api/v1/compare는 유료 엔진에 가장 가까운 무료 엔진과 차이점을 알려 줘요.
  4. 사용자의 플러그인에서 중요하다면 latency(샘플 단위)와 sidechain을 확인하세요.
  5. 사용자에게는 엔진 name, id, 페이지 url이 필요해요. 유료 엔진의 가격은 get_price에 있고, API에서는 price예요.

유료 엔진 구매

사용자를 재촉하지 말고, 사용자 대신 결제하지도 마세요. 가격을 알려 주고, 사용자가 엔진을 원하면 create_checkout로 승인 링크를 받아 건네세요. 구매는 사용자가 직접 검토하고 승인해요. 결제가 아직 켜져 있지 않을 수 있어요. 도구가 그렇게 알려 주면 그대로 전하고 우회 방법을 찾지 마세요. 이미 엔진을 가진 사용자에게는 send_access_link로 접근 링크를 보낼 수 있어요.

상거래 프로토콜을 쓴다면 같은 결제를 UCP나 ACP로도 쓸 수 있어요. 유료 엔진(슬러그 또는 id) 또는 플랜 하나(plan:engines-month, plan:engines-year), 구매자의 이메일, 국가로 결제 세션을 만드세요. 응답에는 영국 VAT가 포함된 가격이 들어 있고, 빠진 것이 없으면 status: requires_escalation과 continue_url이 와요. 이것이 PayPal 승인 링크예요. 사용자에게 건네세요. Complete로는 대신 결제할 수 없어요. 세션을 응답하고, 사용자가 결제하면 completed로 바뀌어요. 라이선스는 구매자 단위라서 수량은 항상 1이에요. 플랜과 개별 엔진은 한 결제에 같이 담을 수 없고, 그 이메일이 이미 가진 엔진은 제외돼요.

구매자를 대신해 행동할 때

사용자가 이미 가진 엔진을 나열하거나 다운로드하려면 sOURnd로 로그인해 달라고 요청하세요. 에이전트를 등록하고(RFC 7591), PKCE로 승인 페이지에 보내면, 사용자가 이메일 링크를 거쳐 브라우저에서 승인해요. 흐름, 스코프, 오류는 auth.md에 있어요. 나머지 도구는 모두 로그인 없이 작동하고, 어떤 토큰으로도 결제할 수 없어요. 구매에는 항상 사용자가 PayPal에 있어야 해요.

Claude나 ChatGPT에 sOURnd 추가

Claude(claude.ai, 데스크톱 앱, Claude Code). Claude에서 설정을 열고 커넥터로 간 다음 “Add custom connector”를 선택해 https://sournd.com/mcp를 붙여 넣으세요. Claude Code에서는 claude mcp add --transport http sournd https://sournd.com/mcp. 검색, 비교, 가격, 무료 다운로드, 통합 코드에는 로그인이 필요 없어요. 내가 가진 엔진이나 그 다운로드 링크를 요청할 때만 Claude가 sOURnd 로그인을 요청해요. 이메일 링크를 받아 브라우저에서 Claude를 승인하면 되고, 라이브러리에서 언제든 연결을 끊을 수 있어요.

ChatGPT. https://sournd.com/mcp/catalogue를 쓰세요. 카탈로그만 제공해요(검색, 엔진 상세, 비교, 통합 코드, 무료 다운로드). 로그인이 없고 구매를 시작할 수 없어요. 디지털 상품에 대한 ChatGPT의 규칙이 그렇게 요구해요.

연결한 뒤에 물어볼 만한 것:

  • “따뜻한 테이프 딜레이 엔진을 찾아서 파라미터를 보여 줘.”
  • “sOURnd의 무료 컴프레서와 유료 컴프레서를 비교해 줘.”
  • “내 JUCE 플러그인에 Roomette 엔진을 추가해 줘.”
  • “Linux용 무료 sOURnd 엔진은 어디서 다운로드해?”
  • “내 sOURnd 엔진 중 다운로드할 수 있는 건 뭐야?” (Claude에서. 먼저 로그인을 요청해요.)

이 연결로 저희에게 전달되는 것은 도구 호출 자체(검색어, 물어본 엔진 이름), 그리고 직접 알려 주실 때만 결제, 접근 링크, 뉴스레터를 위한 이메일 주소예요. 대화의 다른 내용은 전달되지 않아요. 개인정보 처리방침. 도움말: hello@sournd.com.

통합하기

JUCE 빠른 시작을 그대로 따르세요. 핵심만 정리하면:

  • 엔진 id로 sournd::SourndEngine을 만들고, SourndEngineParameters::createLayout(engine)로 APVTS를 만든 다음, SourndEngineParameters(engine, apvts)를 만드세요.
  • prepareToPlay에서: engine.prepare, bridge.prepare, setLatencySamples(engine.latency()).
  • processBlock에서: bridge.apply(numSamples)를 호출한 다음 replacing 컨텍스트로 engine.process를 호출하세요.
  • 상태: bridge.syncToEngine() 다음에 engine.saveState(). engine.loadState(...) 다음에 bridge.syncFromEngine().
  • JUCE 파라미터 id는 catalog.json에 있는 십진수 abi_id 값이에요. 파라미터 id나 범위를 지어내지 말고 카탈로그에서 읽으세요.
  • processBlock에서는 메모리 할당, 락, 로그를 절대 하지 마세요.

사용자가 플러그인을 판매할 때

sOURnd 엔진을 넣어 판매하는 플러그인과 게임에는 로열티가 없고 등록도 필요 없어요. 사용자가 가진 엔진은 판매하는 어떤 제품에도 영구히 넣을 수 있어요. 플랜을 쓰는 동안 출시한 모든 버전은 계속 라이선스가 유지되고, 새 릴리스에는 활성 플랜이 필요해요. 무료 엔진도 따로 살 것 없이 같은 방식으로 사용자가 판매하는 제품에 넣을 수 있어요.

라이선스와 신뢰

유료든 무료든 엔진은 사용자 본인의 플러그인, 게임, 제품에 쓰도록 사용자에게 라이선스돼요. 당신에게, 사용자의 친구에게, 사용자가 파일을 보내는 누구에게도 라이선스되지 않아요. 모든 유료 다운로드에는 사용자의 빌드 id가 들어 있어서 사용자까지 추적할 수 있어요. 사용자는 이 라이선스를 당신에게 맡기고, sOURnd는 당신이 지킬 것이라 믿어요. 그러니:

  • 라이브러리, 다운로드 zip, AI 키 URL은 공개 저장소, 공유 폴더, 패키지 레지스트리, 채팅 기록에 두지 마세요. 첫 커밋 전에 .gitignore에 추가하세요.
  • 클로즈드 라이브러리를 공유, 재판매, 추출, 디컴파일하지 말고, 빌드 id를 지우거나 바꾸지도 마세요.
  • 사용자가 엔진을 다른 사람에게 넘겨 달라고 하면, 사람마다 자기 라이선스가 필요하다고 설명하고(무료 엔진은 필요 없어요) https://sournd.com/pricing/ 으로 안내하세요. 우회 방법은 제안하지 마세요.
  • 사용자의 플러그인이 출시될 때 그 안의 엔진은 문제없어요. 라이선스는 사용자가 만든 제품을 포함해요. 사용자 곁에 남아야 하는 것은 라이브러리 단독본이에요.

만든 것을 기록하기

sOURnd는 사용자마다 빌드 기록을 보관해요. 엔진으로 만든 플러그인, 게임, 앱의 자발적인 이력이고, 내 엔진에 표시돼요. 의무는 아니고 이 기록과 대조해서 확인하지도 않지만, 좋은 습관이고 사용자의 라이선스가 무엇을 포함하는지 보여 주는 데 도움이 돼요. sOURnd 엔진을 링크한 빌드가 성공한 뒤에는 기록할지 제안하고, 사용자가 동의하면 기록하세요:

  • MCP 서버로: record_build(builds:record 스코프로 로그인해야 해요. auth.md 참고).
  • AI 키로: 키의 JSON이 알려 주는 record_build.url로 POST하세요.

제품 이름, 버전, 플랫폼, 포맷, 그리고 다운로드의 README.txt에 있는 build_id(또는 sournd_pro_build_id())를 보내세요.

엔진을 게임에 넣을 때

엔진은 C ABI(같은 정적 라이브러리)를 통해 게임에서 작동해요. FMOD, Wwise, Unity, Unreal 어댑터는 준비 중이에요. 게임은 플러그인과 똑같이 라이선스돼요. 게임별 요금도 로열티도 없어요. 라이브러리는 지금 macOS, Linux, Windows용으로 빌드돼요. 게임 개발자용 페이지는 https://sournd.com/games/ 예요.

지켜야 할 한도

  • 음악가가 연주하는 악기와 직접 가져온 오디오에 거는 이펙트이고, 생성된 음악은 없어요. sOURnd는 음악을 생성하지 않아요. 음악 생성 요청은 사용자의 오디오에 거는 이펙트나 직접 연주하는 악기로 안내하세요.
  • 엔진을 특정 하드웨어 제품의 복제품이라고 설명하지 마세요. 엔진 자체의 설명을 쓰세요.
  • 유료 엔진에는 라이선스가 필요해요. 우회 방법을 제안하지 말고, 클로즈드 라이브러리나 키를 절대 공유하지 마세요(라이선스와 신뢰 참고).