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.mdan 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_linkund, sobald der Käufer sich anmeldet,list_my_enginesundget_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 unterhttps://sournd.com/api/v1/acp). Beide enden in einem PayPal-Link, den der Nutzer selbst öffnet und bezahlt.
Der Weg
- Finden
catalog.json, die API oder MCP - Auswählennach Passform, kostenlos neben kostenpflichtig
- Dem Nutzer sagenName, ID, Seite und Preis
- Einbindengenau nach dem JUCE-Schnellstart
Kostenlose Engine
- Herunterladenkein Konto, keine E-Mail
- Einbinden
Kostenpflichtige Engine
create_checkoutzuerst den Preis nennen- Der Nutzer zahlt bei PayPalnie der Agent
get_download_linksobald er sich anmeldet- Einbinden
Eine Engine auswählen
- Lade
catalog.json. - 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 mitdescription,stylesund den Parameternamen ab. - 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/macosoderhttps://sournd.com/download/free/linux(ein Archiv mit allen), auch im Felddownloadjeder kostenlosen Engine in catalog.json.compare_enginesoderPOST /api/v1/compareliefert die ähnlichste kostenlose Engine zu einer kostenpflichtigen, samt Unterschieden. - Prüfe
latency(Samples) undsidechain, falls es für das Plugin des Nutzers wichtig ist. - Der Nutzer braucht den
nameder Engine, ihreidund dieurlder Seite. Den Preis einer kostenpflichtigen Engine liefertget_price, in der API ist esprice.
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::SourndEnginemit der Engine-ID, dann den APVTS ausSourndEngineParameters::createLayout(engine), dannSourndEngineParameters(engine, apvts). - In
prepareToPlay:engine.prepare,bridge.prepare,setLatencySamples(engine.latency()). - In
processBlock:bridge.apply(numSamples), dannengine.processmit einem Replacing-Context. - Zustand:
bridge.syncToEngine(), dannengine.saveState();engine.loadState(...), dannbridge.syncFromEngine(). - JUCE-Parameter-IDs sind die dezimalen
abi_id-Werte incatalog.json. Erfinde nie Parameter-IDs oder Bereiche: Lies sie aus dem Katalog. - Nie in
processBlockallozieren, 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
.gitignoreein. - 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 Scopebuilds:record, siehe auth.md). - Mit einem KI-Schlüssel:
POSTan dierecord_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).