Serveur MCP

En bref

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.

Choisir la bonne surface

Protocole supporté : 2025-06-18. La spec MCP 2026-07-28 n'est pas encore le contrat public.

Quelle API choisir ?

Matrice REST v1 / v2 / Harnais / MCP : /api/docs/which-api

URL du serveur

Hôte contractuel : https://mcp.askmarcel.app. Utilisez uniquement ce domaine MCP dédié — pas la réécriture interne sur le domaine app.

Claude Desktop (clé API)

{
  "mcpServers": {
    "askmarcel": {
      "url": "https://mcp.askmarcel.app",
      "headers": {
        "Authorization": "Bearer ak_live_..."
      }
    }
  }
}

Les 15 outils

Manifeste 1.3.0-beta.1 : 10 outils GA + 5 outils session Beta (Harnais v2).

search_technical_docs — recherche documentaire (≤ 10 extraits)
get_procedure — procédure complète par chunk_id
get_error_code — lookup marque + code erreur
get_product_sheet — fiche produit et specs
get_pdf_page_snapshot — URL signée page PDF (5 min)
diagnose — lookup sourcé one-shot
diagnose_guided — diagnostic guidé multi-tours PAC Air/Eau
diagnose_v2 — même lookup, provenance SKU stricte (diagnostic null si pas de manuel exact)
resolve_model — résout marque + modèle en SKU (exact ou alias)
get_model_coverage — flags documentaires d’un SKU résolu
start_diagnostic [Beta] — ouvre une session Harnais (quota à la création)
respond_to_diagnostic [Beta] — observation typée ou texte libre
get_diagnostic [Beta] — lecture projection session
close_diagnostic [Beta] — clôture avec avis technicien
get_diagnostic_summary [Beta] — synthèse déterministe exportable

Harnais Beta — Air/Eau + Air/Air

Les cinq outils start_diagnostic, respond_to_diagnostic, get_diagnostic, close_diagnostic, get_diagnostic_summary portent le canal Beta : hypothèses évolutives, action discriminante, citations quand la preuve constructeur est applicable, abstention sinon. Familles : PAC Air/Eau 1.0.0 et PAC Air/Air 0.2.0 uniquement.

Contrat Beta

release_channel=beta sur les réponses session. Pas de probabilité calibrée. Professionnel HVAC qualifié requis.

Transport

POST JSON-RPC 2.0 (initialize, tools/list, tools/call). GET renvoie le manifeste public. GET + Accept: text/event-stream renvoie 405 — les clients Streamable HTTP doivent retomber sur POST.

Pas de stream SSE

GET + Accept: text/event-stream → 405. Les clients Streamable HTTP retombent sur POST JSON-RPC. Tout agent se connecte en client REST et/ou MCP — pas de connecteur dédié.

Tester la connexion

tools/list

curl -s -X POST https://mcp.askmarcel.app \
  -H "Authorization: Bearer ak_live_..." \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'

Quotas & facturation

Pay-on-success : seuls les appels métier réussis consomment le quota. Erreurs Zod, not_found ou out_of_scope ne débitent pas.