Guides
Assistants IA (MCP)
Vendez depuis Claude Code, Cursor ou Codex en un prompt : produits, prix, liens de paiement et paiements de test, via un serveur MCP local avec votre clé.
perly-pay-mcp permet à votre assistant de code de configurer Perly Pay pour vous : créer un produit et son prix, partager un lien de paiement, le payer en mode test et lire ce qui est arrivé. Il tourne sur votre machine et ne parle qu’à l’API de Perly Pay, avec votre clé. Rien de chez nous ne s’intercale.
Mise en place
- 1
Prenez une clé de test
Dashboard → Developers → API keys :
sk_test_…. Construisez avec ; aucun argent réel ne bouge. - 2
Ajoutez le serveur
Une ligne dans Claude Code, ou quelques-unes dans la config de Cursor ou de Codex. Node 20 ou plus récent.
- 3
Demandez
« Vends une consultation d’une heure à 49 $ avec un lien de paiement, puis paie-la en mode test et montre-moi le paiement. »
| Variable | Rôle |
|---|---|
PERLY_PAY_SECRET_KEY | sk_test_… pendant le développement. sk_live_… lit seulement (voir ci-dessous). |
PERLY_PAY_API | Par défaut https://pay.perly.io. |
PERLY_PAY_WEBHOOK_SECRET | Facultatif : whsec_…, la valeur par défaut de verify_webhook_signature. |
Outils
Générés à partir de la description même de l’API : chaque argument est celui de l’API. Les montants sont des entiers en centimes : 4900 vaut 49,00 $.
| Outils | Pour |
|---|---|
create_product, list_products, update_product, create_price, list_prices, update_price | produits et prix |
create_payment_link, list_payment_links, update_payment_link | liens de paiement |
create_invoice, list_invoices, retrieve_invoice, cancel_invoice, create_checkout_session, retrieve_checkout_session | factures et caisse |
create_customer, list_customers, retrieve_customer | clients |
create_subscription, list_subscriptions, retrieve_subscription | abonnements |
check_entitlement, list_entitlements, consume_entitlement_credits, list_credit_usage | accès et crédits |
list_payments, retrieve_payment, list_receipts, retrieve_receipt, list_events | paiements, reçus, événements |
create_refund, list_refunds | remboursements |
create_webhook_endpoint, list_webhook_endpoints, delete_webhook_endpoint | webhooks |
simulate_payment | mode test |
verify_webhook_signature, pay_links | sur votre machine |
simulate_payment paie une facture, ou achète via un lien de paiement puis le paie, si bien que la livraison, les reçus et les webhooks se déclenchent comme pour un vrai acheteur. pay_links donne les pages du tableau de bord pour ce que vous seul pouvez faire.
Ce qu’il ne fera pas
- Avec une clé réelle, il lit seulement. Tout outil qui écrit est refusé : nouvelles factures, sessions de paiement, produits, prix, clients, liens et abonnements, modifications, annulations, remboursements, consommation de crédits et endpoints de webhook. L’outil dit pourquoi ; vous le faites dans le tableau de bord ou dans le code de votre app. Pourquoi : un texte tapé par un acheteur peut atteindre l’assistant, et rien de ce que reçoit le serveur ne prouve que c’est vous, et non le modèle, qui avez approuvé un changement réel.
- Portefeuilles, clés API, votre facture, le passage en réel et la connexion à deux facteurs n’ont pas d’outil. Vous les gérez dans le tableau de bord ;
pay_linksdonne les pages. - Ce qui est irréversible — annuler une facture, ouvrir un remboursement, supprimer un endpoint de webhook — attend
confirm: true, que l’assistant n’envoie qu’après vous l’avoir demandé. - Votre clé secrète n’est jamais répétée dans une réponse ni dans un journal.
Passer en réel
- 1
Connectez un portefeuille
Sa clé publique ou son adresse, dans le tableau de bord. Nous ne demandons jamais de seed ni de clé privée. Voir Portefeuilles.
- 2
Activez le mode réel
Dans le tableau de bord, une fois le portefeuille connecté.
- 3
Changez de clé
Mettez
sk_live_…à la place desk_test_…, sur le serveur de votre app. Votre assistant peut garder la clé de test.