Connecte ton assistant IA.

Ton serveur. Une URL MCP.

Inclus dans la version commerçant 5.0.0+. Aucun démon supplémentaire, environnement Node.js ni relais hébergé. Utilise le domaine API configuré de l'installation, par exemple https://api.example.com/mcp.

1. Ouvre Réglages → Accès API. Crée un identifiant dédié et attribue les projets nécessaires à ton assistant. Commence en lecture seule.
2. Dans Connexions IA · MCP, active MCP. Sélectionne ton identifiant, choisis Lecture seule et enregistre.
3. Ajoute l'URL affichée aux réglages HTTP/MCP distants de ton assistant.
4. Pour OAuth, connecte-toi à ta console commerçant. Vérifie le nom du client, l'adresse de retour et les permissions de l'identifiant, puis approuve. Basic Auth et TOTP existants s'appliquent toujours.

{
  "mcpServers": {
    "whollycrypto": {
      "url": "https://api.example.com/mcp"
    }
  }
}

Remplace le domaine d'exemple. Les formats de configuration varient selon le client ; choisis Streamable HTTP, pas une commande locale ni une ancienne URL SSE.

Pose des questions sur tes paiements.

• « Affiche les dernières factures impayées de mon magasin. »
• « Quels actifs ce magasin peut-il accepter ? »
• « Vérifie les soldes des portefeuilles et les livraisons webhook échouées. »
• « Crée une facture de 25 EUR pour la commande 1042. » Nécessite la permission de créer des factures.

Huit outils de lecture couvrent les projets, magasins, moyens de paiement, portefeuilles, factures, l'historique des livraisons et les conversions en cache. Un neuvième outil facultatif crée des factures selon les règles API existantes.

Les résultats incluent les identifiants du projet et du magasin. Les montants restent des chaînes décimales. Les taux et soldes en cache gardent leurs informations de fraîcheur ; une conversion n'est pas un devis de facture garanti.

Choisis ce à quoi l'assistant peut accéder.

MCP est désactivé par défaut, y compris après une mise à jour. Les clés API existantes n'obtiennent pas d'accès automatiquement. L'assistant ne voit que les projets approuvés ; les restrictions IP et la limite REST de l'identifiant s'appliquent aussi à MCP.

Pour créer des factures, sélectionne un identifiant en lecture/écriture et Lecture + création de factures. Les clients OAuth doivent demander mcp:invoice:create, et tu dois cocher Autoriser aussi la création de factures lors de l'approbation.

Réutilise la même valeur idempotency_key et le même corps de facture après un dépassement de délai. Une nouvelle clé crée une nouvelle facture. Les règles habituelles de spread, tolérance, paiement et crédit s'appliquent toujours.

Aucun export de clés ni outil d'envoi d'argent. MCP ne peut pas révéler les phrases de récupération, envoyer des fonds, effectuer des sweeps, rembourser, renvoyer des callbacks ni modifier les comptes, domaines et la facturation.

N'approuve qu'un client que tu reconnais. Les noms des clients ne sont pas vérifiés. Ton fournisseur d'IA reçoit les informations que tu l'autorises à lire, y compris les données clients renvoyées par les outils de factures.

Si une connexion échoue.

• 404: active MCP et utilise l'hôte API, pas celui de la console ni de la page de paiement.
• 401: reconnecte-toi avec OAuth ou vérifie que ton identifiant bearer est valide.
• 403: vérifie l'accès de l'identifiant, les projets approuvés, l'origine et les restrictions des IP sources.
• 405 sur GET : normal. Cet endpoint sans état utilise POST et des réponses JSON finies, sans flux SSE autonome.
• 429: attends Retry-After. MCP et REST partagent le quota de l'identifiant.
• Impossible de créer des factures : vérifie toutes les permissions d'écriture, le statut du projet/magasin, la disponibilité des paiements et la vérification du compte de crédits.

Désactive le cache Cloudflare et les vérifications interactives pour /mcp, /mcp/oauth/* et les chemins de découverte OAuth. Les listes d'IP autorisées doivent inclure les adresses de sortie documentées du service de l'assistant.

Révisions du protocole prises en charge : 2025-11-25, 2025-06-18 et 2025-03-26. Le client doit en prendre en charge une. Consulte la Référence API pour chaque outil, endpoint et format d'erreur.

Choisis les moyens de paiement par facture.

Utilise invoice.payment_methods avec chain_slug: "ethereum" et asset_tickers: ["USDC", "USDT"]. Trouve les slugs et symboles dans les Moyens de paiement du magasin ou avec list_payment_methods.

La version commerçant 5.4.0+ ignore les choix inactifs ou non acceptés. Sans correspondance, les réglages du magasin s'appliquent. Une blockchain seule inclut tous ses actifs actifs acceptés. Les symboles partagés nécessitent la valeur exacte de asset_ids. Les contrôles de disponibilité et de taux s'appliquent toujours, avec des erreurs propres à la blockchain. Lightning est distinct ; un tableau de sélection vide est invalide. Format de requête →