# MCP · Utilisez blockwallets depuis vos outils d’IA

> Le serveur MCP distant de blockwallets : consultez la documentation d’intégration, créez des factures de test, vérifiez commandes et soldes depuis Claude, ChatGPT, Cursor et Codex. Aucun outil ne peut sortir de l’argent.

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.

## Deux URL

- `https://blockwallets.io/mcp` (Connexion requise): Connexion OAuth, ou jeton MCP (Bearer) créé dans le tableau de bord. Tous les outils.
- `https://blockwallets.io/mcp/public` (Sans connexion): Outils publics uniquement : documentation, réseaux, tarifs, explication de la signature, liste d’intégration.

## 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.

## 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

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

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

### Claude Code · outils de documentation seulement (sans connexion)

```bash
claude mcp add --transport http blockwallets-docs https://blockwallets.io/mcp/public
```

### Cursor · ~/.cursor/mcp.json

```json
{
  "mcpServers": {
    "blockwallets": {
      "url": "https://blockwallets.io/mcp",
      "headers": {
        "Authorization": "Bearer bw_mcp_test_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}
```

### Windsurf · ~/.codeium/windsurf/mcp_config.json

```json
{
  "mcpServers": {
    "blockwallets": {
      "serverUrl": "https://blockwallets.io/mcp",
      "headers": {
        "Authorization": "Bearer bw_mcp_test_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}
```

### Codex · ~/.codex/config.toml

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.

```toml
[mcp_servers.blockwallets]
url = "https://blockwallets.io/mcp"
bearer_token_env_var = "BLOCKWALLETS_MCP_TOKEN"
```

## 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.

## 11 outils, aucun ne peut sortir d’argent.

| Outil | Rôle | Permission |
|---|---|---|
| `search_docs` | Recherche dans la documentation d’intégration ; renvoie les sections et liens pertinents | public |
| `get_doc` | Lit une section de la documentation en Markdown | public |
| `list_networks` | Cryptos et réseaux, confirmations, montants minimum | public |
| `get_pricing` | Frais et paliers de volume | public |
| `explain_signature` | Explique 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 stack | public |
| `create_payment` | Crée une facture et renvoie sa page de paiement (idempotent par order_id) | payments:create |
| `create_payment_link` | Crée un lien de paiement et un QR code | payments:create |
| `get_payment` | Lit une facture par order_id ou uuid | read |
| `list_payments` | Liste les factures par statut et par date | read |
| `get_balance` | Lit le solde en production (lecture seule, pas de retrait) | read |

## 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.

OAuth metadata: https://blockwallets.io/.well-known/oauth-protected-resource · https://blockwallets.io/.well-known/oauth-authorization-server