Connecter ton assistant IA (MCP)

MCP (Model Context Protocol) est la façon standard dont un assistant IA (Claude, par exemple) se connecte à un outil et s'en sert pour de vrai. Bernuvia expose son marketplace via MCP : ton assistant ne t'explique donc pas comment publier un template, il le publie, sur ton compte et avec tes permissions.

• Ce sont les mêmes fonctions que celles du site, avec les mêmes validations, la même revue et la même modération.
• Pas besoin de programmer : ça se connecte avec une ligne et un token que tu crées et révoques quand tu veux.
• Ça marche avec Claude et avec n'importe quel client qui parle MCP.

1. 1Va dans MCP depuis ton panneau et clique sur Créer un token.
2. 2Donne-lui un nom qui dit à quoi il sert (« Claude de mon portable », « ventes ») et choisis les permissions. Si ton compte a la 2FA, le code te sera demandé.
3. 3Copie le token à ce moment-là : par sécurité, il ne s'affiche plus jamais. Si tu le perds, révoque-le et crées-en un autre.
4. 4Range-le dans une variable d'environnement et connecte ton client avec le bloc qui lui correspond (tu en as un par client ci-dessous).
5. 5Ouvre une nouvelle session de ton assistant : les outils sont annoncés au début de la conversation, ils n'apparaissent donc pas dans celle que tu avais déjà ouverte.

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}"
      }
    }
  }
}

Chaque token porte des permissions et chaque fonction exige la sienne. Tu ne lui donnes que ce que tu veux qu'il fasse :

• Lecture seule : catalogue et avis, tes achats, tes favoris, ton solde, tes notifications, tes parrainages et tes statistiques.
• Acheteur : panier, mettre en favori, laisser des avis, signaler des problèmes, préparer des paiements, fermer une de tes commandes encore impayée et sans devis encore utilisable, et ouvrir, retirer ou clôturer pour délai dépassé un litige sur tes achats.
• Vendeur : tes ventes et tes statistiques, brouillons, publier pour revue, codes de réduction et répondre aux avis.

Tu peux avoir plusieurs connexions à la fois sans qu'elles se marchent dessus : une pour vendre, une pour acheter, ou une par compte à toi. Il suffit que chacune ait son nom et sa variable.

• Un nom par usage, sur le token et sur le serveur dans ton client : `bernuvia-ventas` et `bernuvia-compras` se distinguent d'un coup d'oeil.
• Une variable par token : `BERNUVIA_TOKEN_VENTAS` et `BERNUVIA_TOKEN_COMPRAS`, pour ne jamais coller la mauvaise clé.
• Une portée par dossier ou par projet si ton client le permet : la configuration vit avec le projet et ne se charge que quand tu y travailles. S'il n'a qu'une configuration globale, les noms différents suffisent.
• Chaque token porte ses propres permissions : un token d'achat ne peut pas vendre, et un token de vente ne gère pas tes agents.

Ce n'est pas une promesse : le serveur n'a tout simplement pas de fonctions pour ça, donc aucun agent (ni un token volé) ne peut même essayer.

• Signer un paiement. Il peut préparer l'achat et te donner le lien ; la signature, c'est toi qui la fais dans le navigateur avec ton wallet. Pareil pour les litiges : il prépare le lien pour en ouvrir un, pour le retirer, ou pour le clôturer pour délai dépassé (quand le délai est écoulé sans que l'équipe ait tranché, le montant te revient intégralement, sans commission), et c'est toi qui signes.
• Retirer ton argent. Un retrait exige ta signature et un code envoyé sur ton e-mail.
• Toucher à ton compte. Il ne change ni ton e-mail, ni ta 2FA, et il ne crée pas d'autres tokens.
• Entrer dans le panneau d'administration. Un agent opère en tant que toi, et seulement en tant que toi.

1. 1Va dans MCP et clique sur Révoquer sur le token qui t'inquiète : il cesse de fonctionner à l'instant.
2. 2Si tu soupçonnes que ton compte est compromis, active la 2FA dans Sécurité : en l'activant, TOUS tes tokens sont révoqués d'un coup, en plus de fermer les autres sessions.