Serveur MCP
Votre assistant IA, au comptoir des remboursements.
Interrogez Claude, Cursor ou tout client MCP sur vos remboursements en langage courant. Il lit vos dossiers et vos preuves et, si vous l'autorisez, propose des décisions qui arrivent dans votre file d'approbation.
- HTTP diffusable, JSON-RPC 2.0
- Versions de protocole 2025-11-25 et 2026-07-28
- Budget de 10 secondes par appel
- 11 outils, vérifiés au démarrage
Pour les marchands
Ce que ça change pour votre équipe.
Demandez au lieu de chercher
Quels dossiers attendent, ce que le client a dit, quelle version de politique s'est appliquée. Les réponses viennent de votre espace de travail, pas d'une supposition.
Des propositions, pas des actions
Les outils d'écriture ne font que proposer. Chaque proposition attend une personne dans votre file d'approbation.
Tout est consigné
Les propositions et les décisions humaines qui s'y rapportent vont dans la même piste d'audit que tous les autres dossiers.
Outils
Onze outils, dont sept en lecture seule.
Les outils de lecture sont actifs pour toute clé d'API d'espace de travail. Les outils de proposition restent désactivés tant qu'ils ne sont pas activés pour votre espace de travail.
Outils de lecture
| Outil | Ce qu'il renvoie |
|---|---|
list_cases | Vos dossiers, filtrés et paginés. |
get_case | Un dossier avec son état, ses montants et ses articles. |
dispute.case_timeline | La chronologie ordonnée d'un dossier. |
dispute.evidence_sections | Les sections de preuves réunies pour un litige. |
dispute.shopper_communications | Les messages échangés avec le client. |
dispute.policy_version_text | Le texte de la version de politique appliquée. |
dispute.prior_transaction_summary | Un résumé des transactions antérieures du client. |
Outils de proposition
Désactivés par défaut. Ils exigent le module External Agent Access (inclus dans Scale) et sont activés pour votre espace de travail sur demande.
| Outil | Ce qu'il renvoie |
|---|---|
start_case | Propose l'ouverture d'un dossier. |
cancel_case | Propose l'annulation d'un dossier. |
submit_evidence | Propose des preuves de litige pour examen. |
propose_decision | Propose une décision avec justification, niveau de confiance et citations. |
Accès
Votre clé, vos portées.
Clé d'API d'espace de travail
Envoyez-la comme jeton porteur. La clé est limitée à un espace de travail, et la limite de débit effective est la plus basse entre celle de la clé et celle de votre forfait.
OAuth 2.1
Connexion depuis le client avec PKCE (S256), sans clé à copier. Les jetons d'accès durent 1 heure, les jetons d'actualisation 30 jours. Les identifiants client ne sont pas acceptés.
| Portée | Autorise |
|---|---|
read | Lire les dossiers, chronologies et preuves. |
intake | Proposer l'ouverture ou l'annulation d'un dossier. |
approvals | Proposer des preuves et des décisions. |
Configuration
Connexion en trois étapes.
01
Créez une clé d'API d'espace de travail
Créez une clé dans le tableau de bord, sous API et webhooks, et choisissez ses portées. Commencez par la lecture.
02
Ajoutez Lumtry à votre client
Le serveur parle MCP en HTTP diffusable au chemin /mcp de votre hôte d'API. Choisissez votre client ci-dessous.
03
Posez vos questions
Essayez : quelles approbations ont plus d'un jour, ou pourquoi la commande 10442 est en attente.
Remplacez api-host par l'hôte de votre API Lumtry et gardez la clé hors des fichiers partagés.
claude mcp add --transport http lumtry https://<api-host>/mcp \
--header "Authorization: Bearer eqk_live_…"{
"mcpServers": {
"lumtry": {
"url": "https://<api-host>/mcp",
"headers": { "Authorization": "Bearer ${env:LUMTRY_API_KEY}" }
}
}
}{
"mcpServers": {
"lumtry": {
"command": "npx",
"args": ["mcp-remote", "https://<api-host>/mcp", "--header", "Authorization:${LUMTRY_AUTH}"],
"env": { "LUMTRY_AUTH": "Bearer eqk_live_…" }
}
}
}POST /mcp
Authorization: Bearer eqk_live_…
Content-Type: application/json
{
"jsonrpc": "2.0",
"id": 7,
"method": "tools/call",
"params": {
"name": "propose_decision",
"arguments": {
"refund_case_id": "01J9Z3K4M8Q2V6X0B5N7T1R3Y8",
"recommended_decision": "manual_review",
"rationale": "Carrier scan shows delivery; photo shows damage.",
"confidence": 0.72,
"citations": ["dispute.evidence_sections#delivery"]
},
"_meta": { "idempotencyKey": "prop-10442-1" }
}
}Garde-fous
Ce que votre agent ne peut jamais faire.
Déplacer de l'argent seul
Il n'y a aucun canal de décision autonome. Une personne approuve chaque proposition.
Changer la destination d'un remboursement
Un agent ne peut jamais définir la destination d'un remboursement ni modifier un montant.
Marquer un remboursement comme terminé
L'achèvement vient seulement du flux de travail après un vrai résultat du processeur.
Contourner vos règles
Les propositions passent quand même par votre politique épinglée et votre file d'approbation.
Questions
Vos questions sur MCP, répondues.
Un assistant peut-il rembourser un client seul?
Non. Les outils de lecture ne font que lire. Les outils de proposition placent une proposition dans votre file d'approbation, et une personne décide.
Quels assistants fonctionnent?
Tout client qui parle MCP en HTTP diffusable, dont Claude Code, Cursor et Claude Desktop par un pont.
Ai-je besoin d'OAuth?
Non. Une clé d'API d'espace de travail fonctionne comme jeton porteur. La connexion OAuth 2.1 est offerte sur demande.
Comment activer les outils de proposition?
Ils exigent le module External Agent Access, inclus dans Scale, et sont activés pour votre espace de travail sur demande. D'ici là, seuls les sept outils de lecture existent.
Y a-t-il des limites de débit?
Oui. La limite effective est la plus basse entre celle de votre clé et le plafond de votre forfait.
Que peut-il voir?
Seulement l'espace de travail auquel appartient la clé ou le jeton, dans les portées que vous avez accordées.
Faites une place à votre assistant au comptoir des remboursements.
Commencez gratuitement, créez une clé et connectez-vous en quelques minutes. Demandez-nous d'activer les outils de proposition quand vous êtes prêt.