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

15 outils MCP sur mcp.askmarcel.app : lookup, guidé PAC, provenance SKU et boucle session Harnais Beta (Air/Eau + Air/Air). POST JSON-RPC — pas de SSE.

API REST

Hôte contractuel api.askmarcel.app. v1 = lookup sourcé. v2 = provenance SKU stricte (diagnostic null si pas de manuel exact).

Quotas & erreurs

Quotas mensuels stricts par palier (v4). Création Harnais = quota sessions uniquement. Pas de pack ni facturation a posteriori.

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 →