KACHINA

Documentation MCP

Quelles données exposer pour un projet / business ?

Connectez votre MCP à KACHINA pour alimenter le tableau de bord écosystème. Un endpoint standard, des métriques optionnelles, une adaptation automatique.

Endpoint recommandé

Exposez toujours le même chemin sur votre MCP :

GET /stats
Exemple : https://mcp.votredomaine.com/stats?period=7d

KACHINA poll cet endpoint pour chaque période (24h, hier, 7j, 15j, 30j). Si /stats est absent, KACHINA propose d’autres chemins détectés (/kachina/stats, /api/stats, etc.) ou ceux listés dans votre découverte racine.

Découverte (optionnel)

Sur GET / ou GET /kachina, vous pouvez indiquer les endpoints disponibles : 

{
  "service": "helvia-mcp",
  "kachina": {
    "stats": "/stats",
    "endpoints": ["/stats", "/health"]
  }
}

Métriques utiles

Vous n’êtes pas obligé de tout renvoyer. KACHINA s’adapte et n’affiche que les clés présentes. Voici le catalogue recommandé pour un business.

Essentielles

Clé Signification
visits Visiteurs / sessions — trafic du produit ou du site. recommandé
users Utilisateurs — comptes actifs, inscrits, ou MAU selon votre métier. recommandé
revenue Chiffre d’affaires — montant (CHF par défaut) sur la période. recommandé
sales Ventes / commandes — nombre de transactions conclues. recommandé

Fortement utiles

Clé Signification
signups Nouveaux inscrits sur la période. optionnel
mrr Revenu récurrent mensuel (SaaS). optionnel
churn Taux de résiliation (%) — delta = variation du churn. optionnel
conversion Taux de conversion visite → vente (%). optionnel
tickets Tickets support ouverts / traités. optionnel
nps Score NPS ou satisfaction. optionnel
errors Erreurs système / 5xx — utile pour les signaux. optionnel

Chaque métrique expose value (nombre) et idéalement delta (variation en % vs période précédente).

Contrat JSON /stats

GET /stats?period=7d

{
  "period": "7d",
  "project": {
    "name": "Helvia",
    "slug": "helvia"
  },
  "metrics": {
    "visits":  { "value": 62000, "delta": 5.4 },
    "users":   { "value": 1840,  "delta": 8.6 },
    "revenue": { "value": 12400, "delta": 12.3, "currency": "CHF" },
    "sales":   { "value": 188,   "delta": 9.1 }
  },
  "alerts": [
    {
      "severity": "warning",
      "title": "Pic d'appels",
      "body": "Volume vocal +42% sur 2h."
    }
  ],
  "updated_at": "2026-07-27T06:00:00Z"
}

Si une clé manque (ex. pas de sales), KACHINA l’ignore et compose la carte projet avec le reste.

Périodes

Le query param period accepte :

Valeur Sens
24hDernières 24 heures
yesterdayJournée d’hier (00:00–23:59)
7d7 derniers jours
15d15 derniers jours
30d30 derniers jours

Le delta compare à la période immédiatement précédente (ex. 7j vs les 7j d’avant).

Alertes / signaux

Tableau optionnel alerts. Severities reconnues : critical, warning, success, info.

Utilisez-les pour les événements qui méritent une attention immédiate (chute de trafic, pic de ventes, incident, premier client du mois…).

Brancher un projet dans KACHINA

  1. Ouvrez my.kachina.app
  2. Cliquez sur + pour ajouter un projet
  3. Indiquez l’hôte MCP, ex. mcp.helvia.app
  4. KACHINA détecte /stats — sinon vous choisissez un endpoint parmi ceux trouvés
  5. Les métriques disponibles sont importées et affichées sur l’orbite
Auth (optionnel)
Si votre MCP exige un token : header Authorization: Bearer … ou query ?token=…. Vous pourrez le renseigner à la connexion.