Aller au contenu principal

API DIAGNOSTIC CVC · SOURCÉ CONSTRUCTEUR

POUR LOGICIELS, AGENTS IA ET SUPPORT TECHNIQUE

LE DIAGNOSTIC CVC
POUR VOTRE PRODUIT

Ajoutez à votre produit des réponses CVC sourcées, des outils agent et des sessions guidées — REST v1/v2, MCP et Guide diagnostic Beta. Manuel applicable ou abstention explicite.

  • Procédure constructeur citée — manuel, page, section
  • Abstention quand la source exacte manque — pas de hallucination facturée
  • REST v1 lookup · v2 provenance SKU · sessions Guide diagnostic · MCP 2025-06-18
curl https://api.askmarcel.app/v1/diagnostic \
  -H "Authorization: Bearer ak_live_…" \
  -d '{ "brand": "Mitsubishi", "model": "Ecodan PUHZ-W85", "error_code": "E7" }'

CONTRAT TECHNIQUE

Quelle API utiliser ?

v1 pour le lookup large, v2 pour la provenance SKU stricte, sessions Guide diagnostic pour le diagnostic guidé, MCP pour vos agents.

SurfaceStatutQuand l'utiliserLimite
Lookup large, automatisations, intégrations historiquesLiveVous avez besoin d’un code erreur, d’une recherche documentaire ou d’un diagnostic one-shot sans exiger la provenance SKU stricte.Pas de provenance SKU stricte ; diagnostic/turn = guidé PAC Air/Eau historique.
Agents et logiciels qui doivent citer ou s’abstenirLiveVous devez répondre uniquement avec un manuel exact pour le SKU — sinon abstention (non facturable).Pas une session stateful multi-tours.
GMAO, FSM, cockpit — diagnostic guidé journaliséBetaVous voulez le Guide diagnostic : contrôle suivant sûr, journal de session et reprise par session_id.Beta — 5 marques ancres, PAC Air/Eau + Air/Air ; pas les 400k codes en profondeur.
ChatGPT, Claude, agents maisonLiveVotre agent appelle des outils MCP sur mcp.askmarcel.app (protocole 2025-06-18).OAuth actuel : pas de scope diagnostic.run pour les sessions Beta.

Deux périmètres : Lookup mondial (400k+ codes) ≠ Guide diagnostic Beta (panasonic, daikin, atlantic, mitsubishi-electric, gree, ~15 % chemin causal). Ne promettez pas le Guide diagnostic sur tout le corpus.

REST

Pour enrichir un workflow existant avec lookup, résolution SKU et réponses sourcées.

MCP

Pour donner les mêmes outils sourcés à Claude, ChatGPT ou à votre agent maison.

Harnais Beta

Pour une session guidée, avec modèle/SKU, journal et abstention explicite quand le contrôle sûr manque.

Guide complet — quelle API ?

LE VRAI GOULOT D'ÉTRANGLEMENT

VOTRE LOGICIEL SAIT QUI, QUAND, OÙ.
PAS COMMENT RÉPARER.

Votre GMAO gère les tournées. Votre ERP gère la facturation. Votre agent IA répond aux clients. Mais au moment critique — le code erreur affiché sur la machine — tous renvoient encore le technicien vers la hotline et des PDF de 400 pages. AskMarcel apporte la donnée technique sourcée ; votre produit garde son workflow, son UX et sa relation client.

01

Construire en interne = un projet lourd.

Collecter, nettoyer et structurer les manuels de dizaines de marques, c'est un métier. Pas un sprint.

02

Les IA génériques inventent.

Un LLM sans base métier hallucine une valeur ohmique. Sur le terrain, une mauvaise valeur = un retour chantier.

03

La donnée existe déjà — ailleurs.

AskMarcel l'a déjà crawlée, structurée et vérifiée. Vous la branchez au lieu de la refaire.

UNE API, TROIS PROMESSES

MARCEL RÉPOND. VOS OUTILS AGISSENT.

De la requête brute à la procédure affichée — citation constructeur ou abstention explicite.

01

Entrée flexible : code, modèle, ou photo.

Envoyez un code erreur, une référence modèle, une plaque signalétique en base64, ou une question en langage naturel. L'API identifie le contexte et normalise la requête. Endpoint POST /v1/diagnostic.

Step 01
02

Deux prises, une après-midi

L'API ne « génère » pas. Elle interroge 400 000+ codes erreur sourcés. REST ou MCP : vos devs branchent en une après-midi. Chaque réponse renvoie sa source exacte — manuel, page, section.

Step 02
03

Sortie structurée : prête à afficher.

JSON propre : procédure pas-à-pas, valeurs attendues (ohmiques, pression, température), référence de pièce SAV. Vous l'affichez tel quel dans votre interface, ou vous le passez à votre agent.

Step 03

REST POUR VOS LOGICIELS. MCP POUR VOS AGENTS.

API REST

Pour intégrer AskMarcel dans un produit existant.

  • Endpoints : /diagnostic, /search, /error-codes, /procedure
  • Auth par clé Bearer, quotas clairs, webhooks
  • SDK JS/TS et OpenAPI fournis
  • Idéal : GMAO, ERP, portails SAV, apps mobiles métier
Agents IA

Serveur MCP

Pour donner à n'importe quel agent IA une expertise CVC réelle.

  • Serveur MCP natif : Claude, ChatGPT, Gemini, agents maison
  • L'agent « appelle » Marcel comme un outil, avec sources
  • Zéro glue code : ajoutez le serveur, l'agent sait diagnostiquer
  • Idéal : copilotes SAV, chatbots support, assistants internes
MCP
{
  "mcpServers": {
    "askmarcel": {
      "url": "https://mcp.askmarcel.app",
      "headers": { "Authorization": "Bearer ak_live_…" }
    }
  }
}

Le même cerveau vérifié. Deux prises. Vous choisissez celle qui branche le mieux votre stack.

POUR DÉVELOPPEURS & INTÉGRATEURS

Développeurs & agents IA

DONNEZ À VOTRE AGENT UNE VRAIE EXPERTISE MÉTIER.

Un LLM généraliste devine. Branchez le serveur MCP AskMarcel et votre agent cite ses sources : manuel, page, valeur. Clé Developer gratuite (50 req/mois), SDK et OpenAPI prêts — intégration en une après-midi.

MCP
{
  "mcpServers": {
    "askmarcel": {
      "url": "https://mcp.askmarcel.app",
      "headers": { "Authorization": "Bearer ak_live_…" }
    }
  }
}
Lire la doc MCP

Vous êtes décideur (SAV, e-commerce, éditeur) plutôt que développeur ? Découvrir Marcel Inside →

POURQUOI MARCEL, PAS UN LLM SEUL

L'intégration qui ne facture pas le doute

400 000+ codes erreur branchables

Corpus constructeur exposé en REST et MCP — pour votre stack, pas pour une démo marketing.

Sourcé, toujours.

Page, section, valeur. Réponse traçable — ou abstention explicite.

Toutes marques

PAC, clim, chaudières, poêles & granulés (Daikin, Viessmann, Mitsubishi, Palazzetti…).

Abstention explicite, mesurée sur HVAC-Bench V1

Réplication multi-marchés sans refonte.

0+

codes erreur

0

marques

0

modèles référencés

0

outils MCP

Voir la preuve chiffrée

UNE PRISE POUR CHAQUE ÉCHELLE

BRANCHEZ-VOUS. PAS DE FACTURE SURPRISE.

Developer pour tester. Starter et Business s'activent en self-service : vous n'achetez pas du volume, vous achetez le droit de vous appuyer dessus. Marque blanche avec l'équipe.

On ne facture que ce qu'on sait

Une requête n'est décomptée que si la réponse est sourcée et exploitable. Les erreurs et les réponses vides sont gratuites.

Developer

Test, POC, agents perso

Gratuit
  • 50 requêtes/mois — plafond strict
  • API REST + serveur MCP
  • Attribution « Powered by AskMarcel »
  • Test et POC — production non autorisée
Créer une clé gratuite

Starter

Indies, intégrateurs

29€/ mois HT
  • Usage en production autorisé
  • REST + MCP, sans attribution
  • Webhooks & support e-mail
  • 500 requêtes/mois incluses
Choisir Starter
Populaire

Business

Sociétés de SAV, éditeurs GMAO/ERP

149€/ mois HT
  • SLA contractuel & rate-limits élevés
  • Citation opposable — manuel + page
  • Support prioritaire · sièges illimités
  • Usage loyal : 5 000 requêtes/mois
Choisir Business

Scale / Marque blanche

Fabricants, distributeurs, gros éditeurs

Setup dès 5 000 €+ abonnement dès 490 €/mois
  • Volume dédié
  • Marque blanche
  • Corpus custom
  • Account manager
Parler à l'équipe
  • Plafond strict par palier (v4) : pas de pack de dépassement ni facturation a posteriori.
  • −2 mois en annuel payé d'avance : Starter 290 €/an, Business 1 490 €/an.
  • Developer : 50 requêtes/mois, plafond strict, pas de recharge. Pour tester, pas pour produire.
  • Un seul retour chantier évité (150 € et plus) paie l'année de Starter.

Vous êtes technicien sur le terrain ? Voir les tarifs app →

Questions fréquentes

Tout ce qu'il faut savoir avant de brancher Marcel.

Besoin d'aide technique ? Contactez notre équipe

LE CERVEAU EST PRÊT. BRANCHEZ-LE.

Créez une clé gratuite en 2 minutes, ou parlez à l'équipe pour un setup équipe / marque blanche.