MCP

Laissez Claude, ChatGPT, Cursor et Codex lire la documentation, créer des factures de test et vérifier les commandes pour vous. Il ne fait qu’encaisser et lire des données. Il ne peut pas sortir d’argent.

Obtenir un jeton
Connexion requisehttps://blockwallets.io/mcp

Connexion OAuth, ou jeton MCP (Bearer) créé dans le tableau de bord. Tous les outils.

Sans connexionhttps://blockwallets.io/mcp/public

Outils publics uniquement : documentation, réseaux, tarifs, explication de la signature, liste d’intégration.

Ce qu’il fait

En bref : intégrer, déboguer et suivre vos comptes depuis votre IA.

Pendant que vous écrivez l’intégration, votre IA lit directement notre documentation et les règles de signature, sans copier-coller.

Avec un jeton de test, l’IA crée une facture de test, vous simulez le paiement et elle vérifie le statut de bout en bout.

Au quotidien, demandez « combien avons-nous encaissé hier ? » ou « order_1042 est-elle payée ? » et obtenez la réponse.

Installer

Copiez un extrait dans votre outil.

Créez des jetons dans le tableau de bord, sous « Développeurs › Outils IA (MCP) » ; le jeton n’est affiché qu’une fois. Commencez par un jeton de test.

Claude Code
claude mcp add --transport http blockwallets https://blockwallets.io/mcp \
  --header "Authorization: Bearer bw_mcp_test_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

Avec un jeton ; ou retirez --header et lancez /mcp dans Claude Code pour vous connecter via OAuth.

Claude Code · outils de documentation seulement (sans connexion)
claude mcp add --transport http blockwallets-docs https://blockwallets.io/mcp/public
Cursor · ~/.cursor/mcp.json
{
  "mcpServers": {
    "blockwallets": {
      "url": "https://blockwallets.io/mcp",
      "headers": {
        "Authorization": "Bearer bw_mcp_test_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}
Windsurf · ~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "blockwallets": {
      "serverUrl": "https://blockwallets.io/mcp",
      "headers": {
        "Authorization": "Bearer bw_mcp_test_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}
Codex · ~/.codex/config.toml
[mcp_servers.blockwallets]
url = "https://blockwallets.io/mcp"
bearer_token_env_var = "BLOCKWALLETS_MCP_TOKEN"

Mettez le jeton dans la variable d’environnement BLOCKWALLETS_MCP_TOKEN ; nécessite une version récente de Codex prenant en charge MCP en HTTP.

Connecteurs

Claude et ChatGPT : il suffit de se connecter.

Claude (web / bureau)

  1. Paramètres → Connecteurs → Ajouter un connecteur personnalisé
  2. Nommez-le blockwallets et utilisez l’URL https://blockwallets.io/mcp
  3. Cliquez sur Connecter et connectez-vous à votre tableau de bord blockwallets dans la page qui s’ouvre
  4. Sur la page de consentement, choisissez le mode test ou production et l’autorisation de créer des factures, puis cliquez sur Autoriser

ChatGPT

  1. Paramètres → Applications et connecteurs → Avancé, activez le mode développeur
  2. Créez un connecteur avec l’URL https://blockwallets.io/mcp et l’authentification OAuth
  3. Connectez-vous à votre tableau de bord blockwallets
  4. Choisissez le mode et les permissions sur la page de consentement, puis cliquez sur Autoriser

Pas envie de vous connecter ? Utilisez https://blockwallets.io/mcp/public pour les seuls outils publics de documentation.

Outils

11 outils, aucun ne peut sortir d’argent.

OutilRôlePermission
search_docsRecherche dans la documentation d’intégration ; renvoie les sections et liens pertinentspublic
get_docLit une section de la documentation en Markdownpublic
list_networksCryptos et réseaux, confirmations, montants minimumpublic
get_pricingFrais et paliers de volumepublic
explain_signatureExplique le calcul de la signature pas à pas (ne demande jamais d’API key)public
integration_checklistÉtapes d’intégration et liste de recette pour votre stackpublic
create_paymentCrée une facture et renvoie sa page de paiement (idempotent par order_id)payments:create
create_payment_linkCrée un lien de paiement et un QR codepayments:create
get_paymentLit une facture par order_id ou uuidread
list_paymentsListe les factures par statut et par dateread
get_balanceLit le solde en production (lecture seule, pas de retrait)read

Sécurité

Il encaisse. Il n’envoie jamais.

Aucun outil ne sort d’argent

Retraits, versements, remboursements, adresses de retrait, URL de callback et clés ne sont pas dans MCP et n’ont aucune permission. Vous seul pouvez le faire dans le tableau de bord.

Commencez en mode test

Les identifiants de test ne créent des factures que sur testnet et ne voient que des données de test. Pas d’argent réel.

Gardez la production en lecture seule

Les identifiants de production voient les vraies commandes et les vrais soldes. N’accordez que la lecture sauf besoin de créer des factures. Les comptes avec double authentification exigent un code pour les identifiants de production, et nous vous prévenons par e-mail à chaque fois.

Révocable à tout moment

Jetons et autorisations OAuth sont dans une même liste du tableau de bord. Révoquez-en un et ses jetons cessent immédiatement de fonctionner.

Uniquement des empreintes

Jetons et codes sont stockés en sha256 ; un jeton n’est affiché qu’une fois. Chaque appel marchand est journalisé, et chaque identifiant est limité à 60 requêtes par minute.

FAQ

Qu’est-ce que MCP ?

Le Model Context Protocol, un standard ouvert permettant aux outils d’IA d’appeler des services externes. Une fois connectés, Claude, ChatGPT, Cursor et d’autres appellent directement les outils blockwallets.

Une IA peut-elle s’en servir pour prendre mon argent ?

Non. Il n’existe aucun outil de retrait, de versement, de remboursement ou de changement d’adresse ou de clé, ni aucune permission pour cela.

Quelle différence entre test et production ?

Le mode test fonctionne sur des testnets publics avec des factures et des données de test ; la production est votre vrai compte. Faites d’abord fonctionner le parcours en mode test.

Cursor prend-il en charge la connexion OAuth ?

Pour l’instant, utilisez un jeton du tableau de bord dans Cursor. OAuth fonctionne avec les clients qui utilisent une redirection https ou loopback, comme Claude, ChatGPT et Claude Code.

Comment révoquer l’accès ?

Retrouvez le jeton ou l’autorisation dans le tableau de bord, sous « Développeurs › Outils IA (MCP) », et révoquez-le ; c’est immédiat.