Connecteur MCP (IA)

Qu'est-ce que le MCP Mobupay ?

Le Model Context Protocol (MCP) est un standard ouvert qui permet à un assistant IA (Claude Desktop, Cursor, etc.) de se connecter à des sources de données et d'outils. Le serveur MCP Mobupay expose à votre IA : (1) toute la documentation publique Mobupay en recherche naturelle, (2) le catalogue des endpoints de l'API, et (3) l'exécution des requêtes GET de l'API (lecture seule).

Point d'accès

• URL du serveur : https://public.mcp.mobupay.ai/mcp
• Transport : HTTP (StreamableHTTP). Aucune connexion n'est demandée : la documentation et le catalogue des endpoints répondent directement.
• Pour lire vos données ou créer un ticket, ajoutez votre clé API dans l'en-tête X-Mobupay-Api-Key. C'est elle qui identifie votre compte marchand.

Installation depuis Claude Desktop / Cursor

Ajoutez le serveur dans la configuration MCP de votre client. Sans clé, votre assistant accède à la documentation :

{
  "mcpServers": {
    "mobupay": {
      "command": "npx",
      "args": ["mcp-remote", "https://public.mcp.mobupay.ai/mcp"]
    }
  }
}

Avec votre clé API, il accède en plus à vos données et peut ouvrir un ticket :

{
  "mcpServers": {
    "mobupay": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://public.mcp.mobupay.ai/mcp",
        "--header",
        "X-Mobupay-Api-Key:${MOBUPAY_API_KEY}"
      ],
      "env": { "MOBUPAY_API_KEY": "sk_test_VOTRE_CLE" }
    }
  }
}

En une ligne avec Claude Code : claude mcp add --transport http mobupay https://public.mcp.mobupay.ai/mcp --header "X-Mobupay-Api-Key: sk_test_VOTRE_CLE". Commencez par une clé sk_test_ : l'outil mobupay_whoami vous dira à tout moment quel environnement votre assistant interroge. Évitez de passer la clé en argument d'outil (apiKey) : elle transiterait alors par la conversation.

Outils disponibles

• mobupay_search_docs — recherche en langage naturel dans toute la documentation publique.
• mobupay_list_endpoints — liste les endpoints de l'API (filtrable par méthode et par tag).
• mobupay_describe_endpoint — détaille un endpoint (paramètres, schémas, exemples).
• mobupay_whoami — indique à quoi correspond votre clé : marchand, environnement (test ou production) et permissions. Clé requise.
• mobupay_api_get — exécute une requête GET sur l'API (lecture seule). Clé requise.
• tickets_create — ouvre un ticket rattaché à votre compte marchand. Clé requise.

Les trois premiers outils répondent sans clé. En accès anonyme, la recherche dans la documentation est plafonnée à 20 questions par heure.

Exécuter des requêtes GET

L'outil mobupay_api_get appelle réellement l'API Mobupay avec votre clé API. Vous ne voyez que les données que votre clé autorise. La clé est fournie par le header X-Mobupay-Api-Keyde votre client MCP ; elle n'est jamais stockée par le serveur MCP.

• Seules les méthodes GET documentées sont exécutables (aucune écriture).
• Clé manquante : erreur MCP_API_KEY_REQUIRED.
• Endpoint non autorisé / non-GET : erreur MCP_ENDPOINT_NOT_ALLOWED.

Sécurité

Le MCP ne lit et n'écrit rien de lui-même : il rejoue vos appels avec votre clé API, et ne voit donc que ce que votre clé autorise. Seules les requêtes GET documentées sont exécutables ; la seule écriture possible est l'ouverture d'un ticket de support. La clé n'est ni stockée ni journalisée par le serveur MCP : elle est relue à chaque requête depuis l'en-tête de votre client. Une clé révoquée depuis votre espace Mobupay cesse aussitôt d'ouvrir l'accès aux données ; sa description par mobupay_whoami peut rester en cache une minute.