Documentation API & MCP

Guides, référence et tutoriels pour intégrer AskMarcel dans votre produit ou agent IA — sans compte pour lire, compte Developer pour agir.

Démarrage en 3 étapes

Trois étapes : obtenir une clé ak_live_, envoyer un diagnostic, lire la réponse JSON sourcée. Hôte contractuel : api.askmarcel.app/v1.

Voir le quickstart →

Guides

Authentification

Deux modes : clé API Bearer (ak_live_ pour serveur/MCP, pk_live_ pour client) ou OAuth 2.0 (connecteurs Claude). N'utilisez jamais l'ancien préfixe sk_*.

Serveur MCP

7 outils MCP sur mcp.askmarcel.app : recherche, procédures, codes erreur, diagnostic sourcé. Transport JSON-RPC POST — pas de SSE streamable aujourd'hui.

API REST

Hôte contractuel api.askmarcel.app/v1. Point d'entrée principal : POST /diagnostic pour un diagnostic sourcé en un aller-retour.

Quotas & erreurs

Quotas prépayés par palier (v3). Pay-on-success sur diagnostic. Pack unique 29 €/1 000 req au-delà de l'enveloppe incluse.

Webhooks

Les webhooks se configurent dans l'espace développeur authentifié (Starter+). Payload JSON signé, retry automatique.

Intégrations par plateforme

Référence OpenAPI

Surface API complète sur api.askmarcel.app/v1/openapi.json — rendue par Scalar.

Ouvrir la référence →