BernuviaBernuvia
Inhoud

Assistenten (MCP)

Verbind Claude, of elke client die MCP spreekt, met je Bernuvia-account. Je assistent zoekt, koopt, publiceert en bekijkt je verkopen; het ondertekenen van elke betaling blijft van jou.

Wat MCP is, in één zin

MCP (Model Context Protocol) is de standaardmanier waarop een AI-assistent verbinding maakt met een tool en die echt gebruikt. Bernuvia stelt zijn marktplaats beschikbaar via MCP, dus je assistent legt je niet uit hoe je een template publiceert: hij publiceert hem, in jouw account en met de rechten die jij hebt gegeven.

  • Jij bepaalt: elke sleutel draagt precies de rechten die jij geeft, en niets meer.
  • Programmeren hoeft niet: één regel plakken in je client en klaar.
  • Werkt met Claude, Cursor, ChatGPT, VS Code en elke client die MCP spreekt.

Dit bedient jouw account, met je assistent ernaast. Wil je een programma met een eigen account en een eigen wallet, dan zijn dat de agent-accounts.

Maak je sleutel aan

  1. 1Ga naar MCP in je dashboard en klik op Token aanmaken.
  2. 2Geef hem een naam die je herkent, bijvoorbeeld «Claude op mijn laptop».
  3. 3Kies de rechten: alleen lezen, koper of verkoper. Heb je tweestapsverificatie aan, dan vraagt hij om je code.
  4. 4Kopieer de token meteen: om veiligheidsredenen wordt hij nooit opnieuw getoond. Kwijt? Trek hem in en maak een nieuwe.

Het recht verkoper is op zichzelf niet genoeg: je hebt je verkopersabonnement bij de tijd nodig. Het wordt bij elke aanroep gecontroleerd, dus als het verloopt stoppen die functies meteen met antwoorden, ook al leeft de sleutel nog.

Verbind je client

Elke client stel je op zijn eigen manier in, maar het komt altijd op hetzelfde neer: het adres van de server en je token in de Authorization-header. Vervang TU_TOKEN door de token die je net hebt gekopieerd.

Claude Code, in je terminal

claude mcp add --transport http bernuvia https://www.bernuvia.com/api/mcp \
  --header "Authorization: Bearer TU_TOKEN"

Clients die je met een bestand instelt

{
  "mcpServers": {
    "bernuvia": {
      "url": "https://www.bernuvia.com/api/mcp",
      "headers": { "Authorization": "Bearer TU_TOKEN" }
    }
  }
}

In je dashboard, onder «Verbind je client», staat het blok van elke client al ingevuld met jouw token. Je kunt meerdere tokens tegelijk hebben en er altijd één intrekken.

Wat hij kan doen

De server publiceert meer dan veertig functies, verdeeld over drie groepen, en elke functie vraagt om haar recht. Je hoeft ze niet te leren: je assistent ontdekt ze zelf zodra hij verbindt.

  • Lezen: je profiel en je saldo, de catalogus, de reviews, je aankopen, je meldingen en het helpcentrum. Bijvoorbeeld buscar_plantillas of mis_compras.
  • Kopen: winkelwagen, favorieten, reviews, een offerte met de exacte uitsplitsing, de betaling voorbereiden en een eigen geschil volgen. Bijvoorbeeld cotizar_compra of mi_carrito.
  • Verkopen: je verkopen en statistieken, concepten, het pakket uploaden, naar review sturen, kortingscodes en reviews beantwoorden. Bijvoorbeeld enviar_a_revision of mis_ventas.

Het zijn dezelfde functies die de website gebruikt, met dezelfde controles en dezelfde menselijke review. Het enige dat verandert is wie er typt.

Wat hij nooit kan doen

Dit is geen belofte van goed gedrag: de server heeft er simpelweg geen functies voor, dus noch je assistent noch een gestolen token kan het proberen.

  • Een betaling ondertekenen. Hij bereidt de aankoop voor en geeft je de link; ondertekenen doe jij, in je browser, met je wallet.
  • Je geld opnemen. Opnemen vraagt jouw handtekening en een code naar je e-mail.
  • Aan je account komen. Hij verandert je e-mail niet, raakt je tweede factor niet aan en maakt geen andere sleutels. Een sleutel maakt nooit een tweede.
  • In het beheer komen. Je assistent werkt als jou, en alleen als jou.

Vertrouw je een token niet, trek hem dan in bij MCP: hij werkt op slag niet meer. De tweede factor aanzetten in Beveiliging trekt ze allemaal in één keer in.

Wat jij altijd zelf ondertekent

Alles wat geld verplaatst, eindigt in je browser. Je assistent loopt tot aan de rand, geeft je de link en stopt.

Je assistent brengt je tot aan de betaling; de betaling onderteken jij.
  • Een aankoop betalen: hij geeft je de link met het al berekende bedrag en jij ondertekent.
  • Een geschil openen, intrekken of sluiten na afloop: hij maakt de link klaar en jij ondertekent.
  • Je opbrengst opnemen en je abonnement activeren: altijd van jou, nooit via MCP.

De interfaces in de chat

Als je client ze kan tekenen, komen sommige antwoorden er ook als kaarten bij: de catalogus met zijn afbeeldingen, je winkelwagen met het totaal, je verkopen uitgetekend. Het is bèta.

  • Er valt niets te installeren of aan te zetten: kan je client het, dan verschijnen ze vanzelf; zo niet, dan krijg je gewoon de tekst.
  • Een kaart kan minder dan jij: hij ondertekent niet, publiceert niet en neemt niets op.
  • Wat iemand anders heeft geschreven wordt als tekst getoond. Als daar iets vraagt om een betaling vrij te geven, gehoorzaamt noch de kaart noch je assistent.

Ze komen in de taal van je Bernuvia-account, niet in die van je client. De details staan op de pagina over interfaces.

Ga hier verder

De documentatie legt uit hoe dit werkt; het helpcentrum neemt je bij de hand. Naar het helpcentrum.