Deinen KI-Assistenten verbinden (MCP)
Bernuvia spricht MCP: Dein Assistent kann suchen, kaufen, veröffentlichen und deine Verkäufe abfragen, mit genau den Rechten, die du ihm gibst, und ohne jemals eine Zahlung zu signieren.
Was das ist und wozu es gut ist
MCP (Model Context Protocol) ist der Standard, über den sich ein KI-Assistent (zum Beispiel Claude) mit einem Werkzeug verbindet und es wirklich benutzt. Bernuvia stellt seinen Marktplatz per MCP bereit: Dein Assistent erklärt dir also nicht, wie du eine Vorlage veröffentlichst, er veröffentlicht sie, in deinem Konto und mit deinen Rechten.
- Es sind dieselben Funktionen, die auch die Website nutzt, mit denselben Prüfungen, derselben Freigabe und derselben Moderation.
- Du musst nicht programmieren: Es reicht eine Zeile und ein Token, das du selbst erstellst und jederzeit widerrufst.
- Funktioniert mit Claude und mit jedem Client, der MCP spricht.
Eine ausführlichere Erklärung mit Beispielen findest du auf der MCP-Seite.
So verbindest du es
- 1Geh in deinem Panel auf MCP und klick auf Token erstellen.
- 2Gib ihm einen Namen, der sagt, wofür er da ist („Claude auf meinem Laptop“, „Verkauf“), und wähl die Rechte aus. Wenn dein Konto 2FA hat, wirst du nach dem Code gefragt.
- 3Kopier das Token sofort: Aus Sicherheitsgründen wird es nicht noch einmal angezeigt. Wenn du es verlierst, widerruf es und erstell ein neues.
- 4Leg es in einer Umgebungsvariablen ab und verbinde deinen Client mit dem passenden Block (unten findest du einen pro Client).
- 5Öffne eine neue Sitzung deines Assistenten: Die Werkzeuge werden zu Beginn der Unterhaltung angekündigt, in der schon offenen tauchen sie also nicht auf.
Aus dem offiziellen MCP-Verzeichnis: Bernuvia steht dort als `com.bernuvia/marketplace`. Wenn dein Client dieses Verzeichnis liest, fügst du Bernuvia von dort hinzu und gibst nur das Token an; die Blöcke unten sind für Clients, die es nicht lesen.
macOS und Linux: Leg das Token in der Variablen `BERNUVIA_TOKEN` ab. Beim Einfügen ist nichts zu sehen und es landet nicht im Verlauf.
read -rs BERNUVIA_TOKEN && export BERNUVIA_TOKENWindows (PowerShell): dasselbe, in einer Zeile.
$BERNUVIA_TOKEN = Read-Host "Bernuvia token"Claude Code: im Terminal, mit installiertem Claude Code, füg diesen Befehl ein. Dein Token taucht nicht auf: das übernimmt die Variable.
claude mcp add --transport http bernuvia https://www.bernuvia.com/api/mcp \
--header "Authorization: Bearer ${BERNUVIA_TOKEN}"Claude Desktop und claude.ai: unter Einstellungen › Connectors, „Benutzerdefinierten Connector hinzufügen“: Server-URL einfügen und dein Token in den Authorization-Header. Hier kommt das Token in das Feld der App selbst, nie in die Unterhaltung.
https://www.bernuvia.com/api/mcp
Authorization: Bearer TU_TOKENChatGPT: aktiviere den Entwicklermodus unter Einstellungen › Connectors und füge einen MCP-Server mit URL und Token hinzu, ebenfalls in sein eigenes Feld.
https://www.bernuvia.com/api/mcp
Authorization: Bearer TU_TOKENCursor: trag den Server in ~/.cursor/mcp.json (oder unter Einstellungen › MCP) mit diesem Block ein. Löst deine Version die Variable nicht auf, scheitert die Verbindung an der Authentifizierung und du musst den Wert in die Datei schreiben.
{
"mcpServers": {
"bernuvia": {
"url": "https://www.bernuvia.com/api/mcp",
"headers": {
"Authorization": "Bearer ${BERNUVIA_TOKEN}"
}
}
}
}VS Code: in der .vscode/mcp.json deines Projekts (oder deiner Benutzer-mcp.json) ein Server vom Typ http. Die Form `${env:...}` liest die Umgebungsvariable.
{
"servers": {
"bernuvia": {
"type": "http",
"url": "https://www.bernuvia.com/api/mcp",
"headers": {
"Authorization": "Bearer ${env:BERNUVIA_TOKEN}"
}
}
}
}Dein Token wird nie in einen Chat geklebt und taucht auf keinem Screenshot auf. Es ist ein Schlüssel: wer ihn hat, kommt mit deinen Rechten herein. Rutscht er in eine Unterhaltung, auf einen Screenshot oder in ein Repository, widerruf ihn unter MCP und erstell ein neues.
Du kannst bis zu 3 aktive Tokens gleichzeitig haben. Jedes Mal, wenn eines erstellt oder gelöscht wird, benachrichtigen wir dich per E-Mail und über die Benachrichtigungen.
Die Rechte
Jedes Token hat Rechte, und jede Funktion verlangt ihres. Du gibst ihm nur das, was es tun soll:
- Nur lesen: Katalog und Bewertungen, deine Käufe, Favoriten, Guthaben, Benachrichtigungen, Empfehlungen und Statistiken.
- Käufer: Warenkorb, Favoriten markieren, Bewertungen schreiben, Fehler melden, Zahlungen vorbereiten, eine noch unbezahlte eigene Bestellung ohne einlösbares Angebot schließen und einen Streitfall zu deinen Käufen eröffnen, zurückziehen oder nach Fristablauf schließen.
- Verkäufer: deine Verkäufe und Statistiken, Entwürfe, zur Prüfung einreichen, Rabattcodes und Antworten auf Bewertungen.
Das Verkäufer-Recht lässt sich nur vergeben, wenn du ein Verkäuferkonto mit bezahltem Abo hast. Läuft deine Mitgliedschaft ab, antworten diese Funktionen sofort nicht mehr, auch wenn das Token weiter gültig ist.
Mehrere Konten oder mehrere Tokens
Du kannst mehrere Verbindungen gleichzeitig haben, ohne dass sie sich in die Quere kommen: eine zum Verkaufen, eine zum Kaufen oder eine pro Konto von dir. Achten musst du nur darauf, dass jede ihren eigenen Namen und ihre eigene Variable hat.
- Ein Name pro Zweck, am Token und am Server in deinem Client: `bernuvia-ventas` und `bernuvia-compras` sind auf einen Blick zu unterscheiden.
- Eine Variable pro Token: `BERNUVIA_TOKEN_VENTAS` und `BERNUVIA_TOKEN_COMPRAS`, damit du nie den falschen Schlüssel einfügst.
- Gültig nur für einen Ordner oder ein Projekt, wenn dein Client das erlaubt: die Konfiguration liegt beim Projekt und wird nur geladen, wenn du dort arbeitest. Gibt es nur eine globale Konfiguration, reichen verschiedene Namen.
- Jedes Token trägt seine eigenen Rechte: eines zum Kaufen kann nicht verkaufen, und eines zum Verkaufen verwaltet deine Agenten nicht.
Es sind Tokens DESSELBEN Kontos, und die Zahlungen signierst du. Soll ein Programm kaufen, ohne dass du dabei bist, und dabei mit seiner eigenen Wallet zahlen, dann ist das ein Agent aus deinem Konto: Er handelt ebenfalls als du, signiert aber selbst.
Was dein Assistent NICHT kann
Das ist kein Versprechen: Der Server hat für diese Dinge schlicht keine Funktionen, kein Agent und auch kein gestohlenes Token kann es also überhaupt versuchen.
- Eine Zahlung signieren. Er kann den Kauf vorbereiten und dir den Link geben; signieren tust du selbst im Browser mit deiner Wallet. Bei Streitfällen genauso: Er bereitet den Link vor, um einen zu eröffnen, ihn zurückzuziehen oder ihn nach Fristablauf zu schließen (wenn die Frist verstrichen ist, ohne dass das Team entschieden hat, geht der volle Betrag ohne Gebühr an dich zurück), und signieren tust du.
- Dein Geld auszahlen. Eine Auszahlung verlangt deine Signatur und einen Code, den wir an deine E-Mail schicken.
- An dein Konto gehen. Er ändert weder deine E-Mail noch deine 2FA und erstellt auch keine weiteren Tokens.
- Ins Admin-Panel kommen. Ein Agent handelt als du: und nur als du.
Agenten: Davon gibt es zwei Arten. Der Agent, den du unter Meine Agenten anlegst, handelt als du, zahlt aber mit SEINER eigenen Wallet, und auch er kann weder dein Geld abheben noch Bewertungen in deinem Namen hinterlassen noch Zugangsschlüssel anlegen. Die autonomen Agenten sind eigene Konten, die entstehen, indem sie mit ihrer Wallet signieren. In beiden Fällen signiert der Agent selbst mit seiner Wallet; Bernuvia signiert weiterhin nichts für ihn und lässt ihn nicht ins Admin-Panel.
Wenn etwas schiefgeht
- 1Geh auf MCP und klick bei dem Token, das dir Sorgen macht, auf Widerrufen: Es funktioniert sofort nicht mehr.
- 2Wenn du vermutest, dass dein Konto kompromittiert ist, aktivier die 2FA unter Sicherheit: Beim Aktivieren werden ALLE deine Tokens auf einen Schlag widerrufen und außerdem die übrigen Sitzungen beendet.
Ein verlorenes Token kann nicht zahlen, nichts auszahlen und dein Konto nicht ändern: Es tut höchstens, im Rahmen seiner Rechte, das, was du selbst tun könntest, wenn du deine Sachen liest oder verwaltest.
Verwandte Artikel
War dieser Artikel hilfreich?
Nicht gelöst? Schreib uns über Kontakt oder geh zurück zum Hilfe-Center.

