sOURnd Doku Deine Engines
Auf dieser Seite
  1. Wo was liegt
  2. Der Weg
  3. Eine Engine auswählen
  4. Eine kostenpflichtige Engine kaufen
  5. Im Auftrag eines Käufers handeln
  6. sOURnd zu Claude oder ChatGPT hinzufügen
  7. Einbinden
  8. Wenn der Nutzer das Plugin verkaufen will
  9. Lizenz und Vertrauen
  10. Halte fest, was du baust
  11. Wenn die Engines in ein Spiel kommen
  12. Grenzen, die du beachten musst

Für KI-Agenten

Du bist hier willkommen. Diese Seite sagt einem Coding-Assistenten, wie er eine sournd-Engine findet, auswählt und einbindet, ohne zu raten.

Wo was liegt

  • /llms.txt: der Index, eine Zeile pro Engine.
  • /llms-full.txt: alle Seiten in einer Datei.
  • /catalog.json: alle 119 Engines mit Parametern, Bereichen, Standardwerten, Einheiten, Kennlinien, Latenz, Ausklang und Anzeigewerten. Schema unter /catalog.schema.json.
  • Jede Seite als Markdown: Hänge index.md an ihre URL an, zum Beispiel /engines/roomette/index.md.
  • Eine Engine als JSON: /engines/<slug>/engine.json.
  • REST-API (OpenAPI 3.1, ohne Authentifizierung): Engines suchen und filtern, eine Engine vollständig abrufen, Integrationscode und ein direkter Vergleich mit Preisen. Basis-URL https://sournd.com/api/v1.
  • MCP-Server unter https://sournd.com/mcp (Streamable HTTP, nur POST, offen und ohne Anmeldung; Server-Card unter /.well-known/mcp/server-card.json). Tools: search_engines, get_engine, compare_engines, integration_code, get_price, get_free_download, subscribe_newsletter, create_checkout, create_subscription, send_access_link und, sobald der Käufer sich anmeldet, list_my_engines und get_download_link. Jedes Tool trägt einen Titel sowie Hinweise für schreibgeschützt, destruktiv und Open-World. So fügst du ihn zu Claude oder ChatGPT hinzu: weiter unten.
  • auth.md: wie sich ein Käufer anmeldet (Mit sOURnd anmelden, OAuth 2.1 mit PKCE).
  • Agent-Checkout: UCP (Universal Commerce Protocol, REST unter https://sournd.com/api/v1/ucp) und ACP (Agentic Commerce Protocol, REST unter https://sournd.com/api/v1/acp). Beide enden in einem PayPal-Link, den der Nutzer selbst öffnet und bezahlt.

Der Weg

  1. Findencatalog.json, die API oder MCP
  2. Auswählennach Passform, kostenlos neben kostenpflichtig
  3. Dem Nutzer sagenName, ID, Seite und Preis
  4. Einbindengenau nach dem JUCE-Schnellstart

Kostenlose Engine

  1. Herunterladenkein Konto, keine E-Mail
  2. Einbinden

Kostenpflichtige Engine

  1. create_checkoutzuerst den Preis nennen
  2. Der Nutzer zahlt bei PayPalnie der Agent
  3. get_download_linksobald er sich anmeldet
  4. Einbinden

Eine Engine auswählen

  1. Lade catalog.json.
  2. Filtere nach category (distortion, dynamics, eq, filter, modulation, delay, reverb, pitch, performance, utility, analysis für die 77 Effekte; instrument für die 42 Synths) und gleiche die Anfrage dann mit description, styles und den Parameternamen ab.
  3. Wähle zuerst nach Passform. Der Katalog nennt Stufe und Preis jeder Engine, daher lassen sich ein kostenloser und ein kostenpflichtiger Kandidat nebeneinanderstellen. 35 Engines sind kostenlos: geschlossene Bibliotheken, die der Nutzer in alles einbauen kann, was er herstellt oder verkauft. Jede kostenlose Engine lässt sich ohne Konto und ohne E-Mail herunterladen: https://sournd.com/download/free/macos oder https://sournd.com/download/free/linux (ein Archiv mit allen), auch im Feld download jeder kostenlosen Engine in catalog.json. compare_engines oder POST /api/v1/compare liefert die ähnlichste kostenlose Engine zu einer kostenpflichtigen, samt Unterschieden.
  4. Prüfe latency (Samples) und sidechain, falls es für das Plugin des Nutzers wichtig ist.
  5. Der Nutzer braucht den name der Engine, ihre id und die url der Seite. Den Preis einer kostenpflichtigen Engine liefert get_price, in der API ist es price.

Eine kostenpflichtige Engine kaufen

Dränge den Nutzer nie und zahle nie in seinem Namen. Nenne den Preis, und wenn er die Engine will, hole mit create_checkout einen Freigabelink und gib ihn ihm: Er prüft und bestätigt den Kauf selbst. Der Checkout ist vielleicht noch nicht freigeschaltet; wenn das Tool es sagt, gib das weiter und suche keine Umwege. Nutzern, die schon Engines besitzen, kannst du mit send_access_link einen Zugangslink schicken.

Wenn du ein Commerce-Protokoll sprichst, gibt es denselben Checkout als UCP oder ACP. Lege eine Checkout-Sitzung an mit kostenpflichtigen Engines (Slug oder ID) oder einem Abo (plan:engines-month, plan:engines-year), der E-Mail-Adresse des Käufers und seinem Land. Die Antwort enthält die Preise mit britischer Mehrwertsteuer und, sobald nichts mehr fehlt, status: requires_escalation und eine continue_url: Das ist der PayPal-Freigabelink. Gib ihn dem Nutzer. Complete kann nicht für ihn bezahlen: Es antwortet mit der Sitzung, die auf completed wechselt, sobald er bezahlt hat. Lizenzen gelten pro Käufer, daher ist die Menge immer 1; ein Abo und einzelne Engines können sich keinen Checkout teilen; Engines, die die E-Mail-Adresse schon besitzt, werden weggelassen.

Im Auftrag eines Käufers handeln

Um die Engines aufzulisten oder herunterzuladen, die ein Nutzer schon besitzt, bitte ihn, sich mit sOURnd anzumelden: Registriere deinen Agenten (RFC 7591), schicke ihn mit PKCE zur Autorisierungsseite, und er bestätigt dich nach einem E-Mail-Link in seinem Browser. Ablauf, Scopes und Fehler stehen in auth.md. Jedes andere Tool funktioniert ohne Anmeldung, und kein Token kann bezahlen: Zum Kaufen muss der Nutzer immer selbst bei PayPal sein.

sOURnd zu Claude oder ChatGPT hinzufügen

Claude (claude.ai, die Desktop-App und Claude Code). Öffne in Claude die Einstellungen, dann Konnektoren, wähle „Benutzerdefinierten Konnektor hinzufügen“ und füge https://sournd.com/mcp ein. In Claude Code: claude mcp add --transport http sournd https://sournd.com/mcp. Für Suche, Vergleich, Preise, kostenlose Downloads und Integrationscode ist keine Anmeldung nötig. Claude bittet dich nur dann um die Anmeldung mit sOURnd, wenn du nach deinen Engines oder deren Download-Link fragst: Du bekommst einen E-Mail-Link, bestätigst Claude in deinem Browser und kannst die Verbindung jederzeit in deiner Bibliothek trennen.

ChatGPT. Nutze https://sournd.com/mcp/catalogue: nur den Katalog (Suche, Engine-Details, Vergleich, Integrationscode und die kostenlosen Downloads). Er hat keine Anmeldung und kann keinen Kauf starten, wie es die Regeln von ChatGPT für digitale Güter verlangen.

Das kannst du fragen, sobald die Verbindung steht:

  • „Finde mir eine warme Tape-Delay-Engine und zeig ihre Parameter.“
  • „Vergleiche die kostenlosen und kostenpflichtigen Kompressoren in sOURnd.“
  • „Füge die Engine Roomette zu meinem JUCE-Plugin hinzu.“
  • „Wo lade ich die kostenlosen sOURnd-Engines für Linux herunter?“
  • „Welche meiner sOURnd-Engines kann ich herunterladen?“ (Claude; meldet dich zuerst an.)

Was die Verbindung an uns sendet: die Tool-Aufrufe selbst (deine Suchbegriffe, die Engine-Namen, nach denen du fragst) und, nur wenn du sie angibst, deine E-Mail-Adresse für einen Checkout, einen Zugangslink oder den Newsletter. Sonst nichts aus deinem Gespräch. Datenschutz. Hilfe: hello@sournd.com.

Einbinden

Folge genau dem JUCE-Schnellstart. Das Wesentliche:

  • Konstruiere sournd::SourndEngine mit der Engine-ID, dann den APVTS aus SourndEngineParameters::createLayout(engine), dann SourndEngineParameters(engine, apvts).
  • In prepareToPlay: engine.prepare, bridge.prepare, setLatencySamples(engine.latency()).
  • In processBlock: bridge.apply(numSamples), dann engine.process mit einem Replacing-Context.
  • Zustand: bridge.syncToEngine(), dann engine.saveState(); engine.loadState(...), dann bridge.syncFromEngine().
  • JUCE-Parameter-IDs sind die dezimalen abi_id-Werte in catalog.json. Erfinde nie Parameter-IDs oder Bereiche: Lies sie aus dem Katalog.
  • Nie in processBlock allozieren, sperren oder loggen.

Wenn der Nutzer das Plugin verkaufen will

Für Plugins und Spiele, die mit sOURnd-Engines verkauft werden, fallen keine Lizenzgebühren an, und sie müssen nicht registriert werden. Eine Engine, die dem Nutzer gehört, darf dauerhaft in alles einfließen, was er verkauft. Mit einem Abo bleibt jede Version, die er veröffentlicht, solange es aktiv ist, lizenziert; neue Releases brauchen ein aktives Abo. Kostenlose Engines fließen genauso in das ein, was der Nutzer verkauft, ohne dass er etwas kaufen muss.

Lizenz und Vertrauen

Eine Engine, ob kostenpflichtig oder kostenlos, ist an den Nutzer für seine eigenen Plugins, Spiele und Produkte lizenziert. Sie ist nicht an dich lizenziert, nicht an Freunde des Nutzers und nicht an jemanden, dem der Nutzer Dateien schickt. Jeder kostenpflichtige Download trägt die Build-ID des Nutzers und ist auf ihn zurückzuführen. Nutzer vertrauen dir mit dieser Lizenz, und sOURnd vertraut darauf, dass du sie einhältst. Deshalb:

  • Halte die Bibliothek, das Download-Zip und jede KI-Schlüssel-URL aus öffentlichen Repositories, geteilten Ordnern, Paketregistern und Chat-Protokollen heraus. Trage sie vor dem ersten Commit in .gitignore ein.
  • Teile, verkaufe, extrahiere oder dekompiliere nie eine geschlossene Bibliothek und entferne oder ändere nie ihre Build-ID.
  • Wenn der Nutzer dich bittet, eine Engine an jemand anderen weiterzugeben, erkläre, dass jeder eine eigene Lizenz braucht (kostenlose Engines brauchen keine), und verweise auf https://sournd.com/pricing/. Schlage keine Umwege vor.
  • Wenn das Plugin des Nutzers erscheint, sind die Engines darin in Ordnung: Die Lizenz deckt die Produkte ab, die er baut. Nur die Bibliothek für sich muss bei ihm bleiben.

Halte fest, was du baust

sOURnd führt für jeden Nutzer ein Build-Register: eine freiwillige Chronik der Plugins, Spiele und Apps, die mit seinen Engines gebaut wurden, angezeigt unter Deine Engines. Es ist nichts geschuldet und nichts wird dagegen geprüft, aber es ist gute Praxis und hilft dem Nutzer zu zeigen, was seine Lizenz abdeckt. Biete nach einem erfolgreichen Build, der sOURnd-Engines einbindet, an, ihn einzutragen, und trage ihn ein, sobald der Nutzer zustimmt:

  • Mit dem MCP-Server: record_build (erfordert Anmeldung mit dem Scope builds:record, siehe auth.md).
  • Mit einem KI-Schlüssel: POST an die record_build.url, die dir das JSON des Schlüssels liefert.

Sende Produktname, Version, Plattformen, Formate und die build_id aus der README.txt des Downloads (oder sournd_pro_build_id()).

Wenn die Engines in ein Spiel kommen

Engines laufen in Spielen über die C ABI (dieselbe statische Bibliothek; Adapter für FMOD, Wwise, Unity und Unreal sind unterwegs). Ein Spiel wird genauso lizenziert wie ein Plugin: keine Gebühr pro Spiel und keine Lizenzgebühren. Die Bibliothek gibt es heute für macOS, Linux und Windows. Die Seite für Spieleentwickler ist https://sournd.com/games/.

Grenzen, die du beachten musst

  • Instrumente, die der Musiker spielt, und Effekte für Audio, das er mitbringt, niemals generierte Musik. sOURnd generiert keine Musik, und Anfragen nach generierter Musik sollten auf Effekte für das eigene Audio des Nutzers oder Instrumente, die er spielt, umgelenkt werden.
  • Beschreibe eine Engine nicht als Kopie eines benannten Hardware-Produkts. Nutze die eigene Beschreibung der Engine.
  • Kostenpflichtige Engines brauchen eine Lizenz; schlage keine Umwege vor und gib nie eine geschlossene Bibliothek oder einen Schlüssel weiter (siehe Lizenz und Vertrauen).