AI エージェント向け
ようこそ。このページでは、コーディングアシスタントが推測に頼らずに sournd エンジンを見つけ、選び、組み込む方法を説明します。
すべての場所
- /llms.txt:エンジンごとに 1 行のインデックス。
- /llms-full.txt:すべてのページを 1 ファイルにまとめたもの。
- /catalog.json:119 エンジンすべてのパラメーター、範囲、デフォルト値、単位、テーパー、レイテンシー、テイル、読み取り値を収録。スキーマは /catalog.schema.json にあります。
- どのページも Markdown で取得できます。URL に
index.mdを付けてください(例:/engines/roomette/index.md)。 - エンジン 1 つを JSON で:
/engines/<slug>/engine.json。 - REST API(OpenAPI 3.1、認証なし):エンジンの検索と絞り込み、エンジン 1 つの詳細、組み込みコード、価格付きの並列比較。ベース URL は
https://sournd.com/api/v1です。 https://sournd.com/mcpの 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、REST は
https://sournd.com/api/v1/ucp)と ACP(Agentic Commerce Protocol、REST はhttps://sournd.com/api/v1/acp)。どちらも、ユーザーが自分で開いて支払う PayPal のリンクで完了します。
手順
- 探す
catalog.json、API、または MCP - 選ぶ適合度で。無料と有料を並べて
- ユーザーに伝える名前、ID、ページ、価格
- 組み込むJUCE クイックスタートのとおりに
無料エンジン
- ダウンロードアカウントもメールアドレスも不要
- 組み込む
有料エンジン
create_checkout先に価格を伝える- 支払いは PayPal でユーザーが行うエージェントは決して支払わない
get_download_linkサインイン後- 組み込む
エンジンを選ぶ
catalog.jsonを読み込みます。categoryで絞り込み(77 のエフェクトは distortion、dynamics、eq、filter、modulation、delay、reverb、pitch、performance、utility、analysis、42 のシンセは instrument)、そのうえで依頼内容をdescription、styles、パラメーター名と照らし合わせます。- Match on fit first. The catalogue gives every engine's tier and price, so a free and a paid candidate can be put side by side. 35 engines are free: closed libraries the user can build into anything they make or sell. Every free engine downloads with no account or email:
https://sournd.com/download/free/macosorhttps://sournd.com/download/free/linux(one archive with all of them), also in each free engine'sdownloadfield in catalog.json.compare_enginesorPOST /api/v1/comparereturns the closest free engine to a paid one, with the differences. - ユーザーのプラグインで重要なら、
latency(サンプル数)とsidechainを確認してください。 - ユーザーには、エンジンの
name、id、ページのurlを伝えます。有料エンジンの価格はget_price、API ではpriceにあります。
有料エンジンを購入する
ユーザーに購入を迫ったり、代わりに支払ったりしてはいけません。価格を伝え、ユーザーが希望した場合は create_checkout で承認リンクを取得して渡します。購入内容の確認と承認はユーザー自身が行います。チェックアウトがまだ有効でない場合があります。ツールがそう答えたらそのまま伝え、回避策を探さないでください。すでにエンジンを所有しているユーザーには、send_access_link でアクセスリンクを送れます。
コマース用プロトコルを扱う場合は、同じチェックアウトを UCP または ACP でも利用できます。有料エンジン(スラッグまたは ID)か 1 つのプラン(plan:engines-month、plan:engines-year)、購入者のメールアドレス、国を指定してチェックアウトセッションを作成します。応答には英国 VAT 込みの価格が含まれ、不足がなくなると status: requires_escalation と continue_url が返ります。これが PayPal の承認リンクです。ユーザーに渡してください。Complete ではユーザーの代わりに支払えません。応答はセッションを返し、ユーザーが支払うと completed になります。ライセンスは購入者ごとなので、数量は常に 1 です。プランと個別のエンジンを同じチェックアウトにまとめることはできません。そのメールアドレスがすでに所有しているエンジンは対象外になります。
購入者の代理として動く
ユーザーがすでに所有しているエンジンを一覧表示またはダウンロードするには、sOURnd でサインインするよう案内します。エージェントを登録し(RFC 7591)、PKCE 付きの認可ページへ誘導すると、ユーザーはメールのリンクを経由してブラウザーでエージェントを承認します。フロー、スコープ、エラーは auth.md にあります。それ以外のツールはサインインなしで使え、どのトークンでも支払いはできません。購入には必ずユーザー自身が PayPal で操作する必要があります。
sOURnd を Claude や ChatGPT に追加する
Claude(claude.ai、デスクトップアプリ、Claude Code)。Claude で「設定」、「コネクタ」を開き、「カスタムコネクタを追加」を選んで 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 の無料と有料のコンプレッサーを比べて。」
- 「Roomette エンジンを私の JUCE プラグインに追加して。」
- 「sOURnd の無料エンジンを Linux 向けにダウンロードできる場所は?」
- 「私の 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の 10 進数の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 は音楽を生成しません。生成された音楽の依頼には、ユーザー自身のオーディオに使うエフェクトか、演奏するインストゥルメントを案内してください。
- エンジンを、特定のハードウェア製品のコピーとして説明しないでください。エンジン自身の説明を使います。
- 有料エンジンにはライセンスが必要です。回避策を提案せず、クローズドライブラリやキーを共有しないでください(「ライセンスと信頼」を参照)。