Serveur MCP

Passerelle expose un serveur MCP (Model Context Protocol) permettant à un agent IA d'intégrer Passerelle directement — créer des paiements, consulter des statuts, configurer le routage — sans passer par du code applicatif classique.

Connexion

• Endpoint : POST /mcp (transport Streamable HTTP, mode stateless — aucune session persistée entre deux appels)
• Authentification : la même clé API marchand que le reste de l'API, en en-tête Authorization: Bearer sk_.... Chaque agent IA doit présenter sa propre clé — il n'existe pas de sandbox MCP publique sans clé, ni de mécanisme d'authentification MCP distinct (OAuth, etc.)

Exemple de configuration pour un client MCP générique :

{
  "mcpServers": {
    "passerelle": {
      "url": "https://api.passerelle.abecedaire.tg/mcp",
      "headers": {
        "Authorization": "Bearer sk_..."
      }
    }
  }
}

Tools exposés

Chaque tool délègue au même service que l'endpoint REST équivalent — même comportement, même portée (toujours limité à votre compte marchand).

create_payment

Équivalent de POST /payments (guide Paiements).

Paramètre	Requis
amount	oui
customerName	oui
customerPhone	oui
customerEmail, description, returnUrl, currency	non

get_payment_status

Équivalent de GET /payments/:reference. Paramètre : reference (requis).

list_aggregators_health

Équivalent de GET /health/gateways. Aucun paramètre.

list_routing_rules

Lecture seule de vos règles de routage effectives (Comment fonctionne le routage). Aucun paramètre.

set_routing_preferences

Met à jour l'ordre de partenaires préféré et les moyens de paiement acceptés, et régénère immédiatement vos règles de routage — équivalent à ce que fait le tableau de bord (Préférences de routage).

Paramètre	Requis
preferredGatewayOrder	oui (tableau, peut être vide)
preferredPaymentMethods	oui (tableau, peut être vide)

get_settlement_status

Équivalent de GET /settlements / GET /settlements/:id (guide Règlements) :

• Avec id : détail d'un règlement
• Sans id : liste paginée de vos règlements