Je AI-assistent koppelen (MCP)

MCP (Model Context Protocol) is de standaardmanier waarop een AI-assistent (Claude bijvoorbeeld) verbinding maakt met een tool en die ook 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 jouw rechten.

• Het zijn dezelfde functies die de website gebruikt, met dezelfde validaties, dezelfde review en dezelfde moderatie.
• Programmeren hoeft niet: je koppelt het met één regel en een token dat jij aanmaakt en intrekt wanneer je wilt.
• Werkt met Claude en met elke client die MCP spreekt.

1. 1Ga naar MCP in je panel en klik op Token aanmaken.
2. 2Geef het een naam die zegt waar het voor is («Claude op mijn laptop», «verkoop») en kies de rechten. Heeft je account 2FA, dan vragen we je om de code.
3. 3Kopieer het token meteen: om veiligheidsredenen wordt het niet nog een keer getoond. Ben je het kwijt, trek het dan in en maak een nieuw token aan.
4. 4Zet het in een omgevingsvariabele en koppel je client met het bijbehorende blok (hieronder staat er een per client).
5. 5Open een nieuwe sessie van je assistent: de tools worden aangekondigd bij het begin van het gesprek, dus in het gesprek dat al openstond verschijnen ze niet.

read -rs BERNUVIA_TOKEN && export BERNUVIA_TOKEN

$BERNUVIA_TOKEN = Read-Host "Bernuvia token"

claude mcp add --transport http bernuvia https://www.bernuvia.com/api/mcp \
  --header "Authorization: Bearer ${BERNUVIA_TOKEN}"

https://www.bernuvia.com/api/mcp
Authorization: Bearer TU_TOKEN

https://www.bernuvia.com/api/mcp
Authorization: Bearer TU_TOKEN

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

{
  "servers": {
    "bernuvia": {
      "type": "http",
      "url": "https://www.bernuvia.com/api/mcp",
      "headers": {
        "Authorization": "Bearer ${env:BERNUVIA_TOKEN}"
      }
    }
  }
}

Elk token heeft rechten en elke functie vraagt om het zijne. Je geeft hem alleen wat je wilt dat hij doet:

• Alleen lezen: catalogus en reviews, je aankopen, favorieten, saldo, meldingen, referrals en statistieken.
• Koper: winkelwagen, favorieten markeren, reviews achterlaten, fouten melden, betalingen voorbereiden, een eigen order sluiten die je nog niet hebt betaald en die geen inwisselbare offerte meer heeft, en een geschil over je aankopen openen, intrekken of sluiten na afloop van de termijn.
• Verkoper: je verkopen en statistieken, concepten, publiceren ter review, kortingscodes en reageren op reviews.

Je kunt meerdere verbindingen tegelijk hebben zonder dat ze elkaar in de weg zitten: een om te verkopen, een om te kopen, of een per account van jou. Let alleen op dat elke verbinding zijn eigen naam en zijn eigen variabele heeft.

• Eén naam per doel, op het token en op de server in je client: `bernuvia-ventas` en `bernuvia-compras` herken je in één oogopslag.
• Eén variabele per token: `BERNUVIA_TOKEN_VENTAS` en `BERNUVIA_TOKEN_COMPRAS`, zodat je nooit de verkeerde sleutel plakt.
• Bereik per map of per project als je client dat toelaat: de configuratie staat bij het project en laadt alleen als je daar werkt. Is er alleen globale configuratie, dan zijn verschillende namen genoeg.
• Elk token draagt zijn eigen rechten: een token om te kopen kan niet verkopen, en een om te verkopen beheert je agents niet.

Het is geen belofte: de server heeft hier simpelweg geen functies voor, dus geen enkele agent (ook niet met een gestolen token) kan het proberen.

• Een betaling ondertekenen. Hij kan de aankoop voorbereiden en je de link geven; ondertekenen doe jij in de browser met je wallet. Met geschillen net zo: hij bereidt de link voor om er een te openen, in te trekken of na afloop van de termijn te sluiten (als de termijn verstreek zonder dat het team besliste, keert het hele bedrag zonder commissie naar jou terug), en ondertekenen doe jij.
• Je geld opnemen. Opnemen vereist jouw handtekening en een code die naar je e-mail wordt gestuurd.
• Aan je account komen. Hij verandert je e-mailadres niet, je 2FA niet, en maakt geen andere tokens aan.
• Het beheerderspaneel in. Een agent werkt als jou, en alleen als jou.

1. 1Ga naar MCP en klik op Intrekken bij het token waar je je zorgen over maakt: het werkt meteen niet meer.
2. 2Vermoed je dat je account gecompromitteerd is, zet dan 2FA aan bij Beveiliging: bij het activeren worden AL je tokens in één klap ingetrokken, en worden de andere sessies afgesloten.