Documentation du serveur MCP

47 outils répartis en 7 familles, générés depuis le registre du serveur — cette page est donc toujours à jour (RapidoCRM Academy, version 1.1.0).

Se connecter

Trois étapes, une seule fois.

  1. Générer une clé d'API dans /admin/parametres en choisissant sa portée (lecture, écriture ou complet).
  2. Ajouter le serveur /mcp dans Claude, ChatGPT ou Mistral, puis autoriser l'accès sur la page de consentement avec un compte administrateur de l'Académie.
  3. Transmettre la clé via l'en-tête X-Academie-Cle: <clé>. Le paramètre cle_api reste accepté en repli, mais il est déprécié.

Conventions

À lire avant le premier appel.

  • Authentification : jeton OAuth (compte administrateur de l'Académie) + clé d'API de l'Académie.
  • Clé d'API : en-tête `X-Academie-Cle: <clé>` recommandé ; le paramètre `cle_api` reste accepté en repli (déprécié).
  • Portées de clé : `lecture` (lister_*, obtenir_*, journal_*, statistiques_*), `ecriture` (tout sauf suppressions), `complet` (suppressions incluses).
  • Limitation de débit : 120 appels par minute et par clé ; l'erreur indique le délai d'attente.
  • Idempotence : les créations sont idempotentes sur le `slug` ; rejouer une requête ne crée pas de doublon.
  • Retours partiels : sur un lot, les éléments valides sont enregistrés et les échecs listés avec leur raison.
  • Publication immédiate : aucune validation manuelle, `publier_*` met le contenu en ligne.
  • Journalisation : chaque écriture est tracée dans le journal des publications (source `api_mcp`).

Découverte — 1 outils

Comprendre le serveur avant de l'utiliser.

capacites_academie

portée : lecturelecture seule

Décrit le serveur MCP de RapidoCRM Académie : familles d'outils, nombre d'outils par famille, chiffres du catalogue et conventions d'usage. À appeler en premier.

ParamètreTypeRequisDescription
detailbooléennonOptionnel. Sans effet : conservé pour la compatibilité des clients MCP.
Exemple d'appel
{
  "method": "tools/call",
  "params": {
    "name": "capacites_academie",
    "arguments": {}
  }
}

Catalogue (modules & tutoriels) — 7 outils

Lecture du catalogue : modules, tutoriels, vignettes, travail restant.

lister_modules

portée : lecturelecture seule

Renvoie les modules du catalogue avec leur avancement (vidéos en ligne / prévues).

ParamètreTypeRequisDescription
cle_apitextenonOptionnel (déprécié). Préférez l'en-tête Authorization: Bearer <clé> (ou X-Academie-Cle). Clé générée dans /admin/parametres.
Exemple d'appel
{
  "method": "tools/call",
  "params": {
    "name": "lister_modules",
    "arguments": {}
  }
}

obtenir_module

portée : lecturelecture seule

Renvoie un module et la liste ordonnée de ses tutoriels.

ParamètreTypeRequisDescription
cle_apitextenonOptionnel (déprécié). Préférez l'en-tête Authorization: Bearer <clé> (ou X-Academie-Cle). Clé générée dans /admin/parametres.
slugtexteouiSlug du module.
Exemple d'appel
{
  "method": "tools/call",
  "params": {
    "name": "obtenir_module",
    "arguments": {
      "slug": "mon-tutoriel"
    }
  }
}

lister_tutoriels

portée : lecturelecture seule

Liste les tutoriels, filtrable par module, statut et recherche libre.

ParamètreTypeRequisDescription
cle_apitextenonOptionnel (déprécié). Préférez l'en-tête Authorization: Bearer <clé> (ou X-Academie-Cle). Clé générée dans /admin/parametres.
moduletextenonSlug du module.
statutvaleur imposéenonFiltre de statut.
qtextenonRecherche libre dans le titre et l'accroche.
Exemple d'appel
{
  "method": "tools/call",
  "params": {
    "name": "lister_tutoriels",
    "arguments": {}
  }
}

obtenir_tutoriel

portée : lecturelecture seule

Renvoie la fiche complète d'un tutoriel (étapes, astuces, prompts, transcription, SEO).

ParamètreTypeRequisDescription
cle_apitextenonOptionnel (déprécié). Préférez l'en-tête Authorization: Bearer <clé> (ou X-Academie-Cle). Clé générée dans /admin/parametres.
slugtexteouiSlug du tutoriel.
Exemple d'appel
{
  "method": "tools/call",
  "params": {
    "name": "obtenir_tutoriel",
    "arguments": {
      "slug": "mon-tutoriel"
    }
  }
}

lister_vignettes

portée : lecturelecture seule

Renvoie les vignettes (thumbnails 1280x720) générées pour les tutoriels, avec leur URL directe, utilisable pour le montage vidéo ou la publication YouTube.

ParamètreTypeRequisDescription
cle_apitextenonOptionnel (déprécié). Préférez l'en-tête Authorization: Bearer <clé> (ou X-Academie-Cle). Clé générée dans /admin/parametres.
moduletextenonSlug du module pour filtrer.
slugtextenonSlug d'un tutoriel précis.
Exemple d'appel
{
  "method": "tools/call",
  "params": {
    "name": "lister_vignettes",
    "arguments": {}
  }
}

tutoriels_incomplets

portée : lecturelecture seule

Liste les tutoriels auxquels il manque une vidéo, une transcription, une vignette ou du SEO, pour prioriser le travail.

ParamètreTypeRequisDescription
cle_apitextenonOptionnel (déprécié). Préférez l'en-tête Authorization: Bearer <clé> (ou X-Academie-Cle). Clé générée dans /admin/parametres.
Exemple d'appel
{
  "method": "tools/call",
  "params": {
    "name": "tutoriels_incomplets",
    "arguments": {}
  }
}

journal_publications

portée : lecturelecture seule

Renvoie les dernières écritures effectuées via l'API et le MCP.

ParamètreTypeRequisDescription
cle_apitextenonOptionnel (déprécié). Préférez l'en-tête Authorization: Bearer <clé> (ou X-Academie-Cle). Clé générée dans /admin/parametres.
limitenombrenonNombre de lignes (50 par défaut).
Exemple d'appel
{
  "method": "tools/call",
  "params": {
    "name": "journal_publications",
    "arguments": {}
  }
}

Production de tutoriels — 12 outils

Chaîne de production complète : création, médias, transcription, SEO, mise en ligne.

creer_tutoriel

portée : ecriture

Crée un tutoriel complet. Idempotent : si le slug existe déjà, les champs fournis sont fusionnés.

ParamètreTypeRequisDescription
cle_apitextenonOptionnel (déprécié). Préférez l'en-tête Authorization: Bearer <clé> (ou X-Academie-Cle). Clé générée dans /admin/parametres.
titretexteouiTitre du tutoriel.
moduletextenonSlug du module de rattachement.
numeronombrenonNuméro d'ordre dans le module.
slugtextenonSlug souhaité (déduit du titre sinon).
titre_courttextenonTitre court pour les cartes.
accrochetextenonPhrase d'accroche.
explicationtextenonExplication détaillée.
a_quoi_ca_serttextenonBénéfice métier.
prerequisliste de textenonListe des prérequis.
etapesliste de valeurnonÉtapes : { titre, texte, duree }.
astucesliste de valeurnonAstuces : { titre, texte, niveau }.
cas_usageliste de valeurnonCas d'usage : { contexte, action, resultat }.
promptsliste de valeurnonPrompts : { titre, texte, outil_mcp }.
statutvaleur imposéenonStatut initial.
Exemple d'appel
{
  "method": "tools/call",
  "params": {
    "name": "creer_tutoriel",
    "arguments": {
      "titre": "…"
    }
  }
}

publier_tutoriel

portée : ecriture

Met le tutoriel en ligne immédiatement (statut en_ligne + date de publication), sans validation admin.

ParamètreTypeRequisDescription
cle_apitextenonOptionnel (déprécié). Préférez l'en-tête Authorization: Bearer <clé> (ou X-Academie-Cle). Clé générée dans /admin/parametres.
slugtexteouiSlug du tutoriel.
Exemple d'appel
{
  "method": "tools/call",
  "params": {
    "name": "publier_tutoriel",
    "arguments": {
      "slug": "mon-tutoriel"
    }
  }
}

enregistrer_video

portée : ecriture

Enregistre le lien AWS S3 de la vidéo du tutoriel et sa durée.

ParamètreTypeRequisDescription
cle_apitextenonOptionnel (déprécié). Préférez l'en-tête Authorization: Bearer <clé> (ou X-Academie-Cle). Clé générée dans /admin/parametres.
slugtexteouiSlug du tutoriel.
video_urltexteouiURL S3 de la vidéo.
duree_secondesnombrenonDurée en secondes.
Exemple d'appel
{
  "method": "tools/call",
  "params": {
    "name": "enregistrer_video",
    "arguments": {
      "slug": "mon-tutoriel",
      "video_url": "…"
    }
  }
}

enregistrer_video_avatar

portée : ecriture

Enregistre le lien AWS S3 de la vidéo avatar (format 9:16) du tutoriel.

ParamètreTypeRequisDescription
cle_apitextenonOptionnel (déprécié). Préférez l'en-tête Authorization: Bearer <clé> (ou X-Academie-Cle). Clé générée dans /admin/parametres.
slugtexteouiSlug du tutoriel.
video_avatar_urltexteouiURL S3 de la vidéo avatar.
Exemple d'appel
{
  "method": "tools/call",
  "params": {
    "name": "enregistrer_video_avatar",
    "arguments": {
      "slug": "mon-tutoriel",
      "video_avatar_url": "…"
    }
  }
}

enregistrer_youtube

portée : ecriture

Enregistre l'URL YouTube du tutoriel et en extrait l'identifiant vidéo.

ParamètreTypeRequisDescription
cle_apitextenonOptionnel (déprécié). Préférez l'en-tête Authorization: Bearer <clé> (ou X-Academie-Cle). Clé générée dans /admin/parametres.
slugtexteouiSlug du tutoriel.
youtube_urltexteouiURL YouTube publique.
Exemple d'appel
{
  "method": "tools/call",
  "params": {
    "name": "enregistrer_youtube",
    "arguments": {
      "slug": "mon-tutoriel",
      "youtube_url": "…"
    }
  }
}

enregistrer_vignette

portée : ecriture

Enregistre l'URL de la vignette (thumbnail) du tutoriel.

ParamètreTypeRequisDescription
cle_apitextenonOptionnel (déprécié). Préférez l'en-tête Authorization: Bearer <clé> (ou X-Academie-Cle). Clé générée dans /admin/parametres.
slugtexteouiSlug du tutoriel.
thumbnail_urltexteouiURL de la vignette 16:9.
Exemple d'appel
{
  "method": "tools/call",
  "params": {
    "name": "enregistrer_vignette",
    "arguments": {
      "slug": "mon-tutoriel",
      "thumbnail_url": "…"
    }
  }
}

enregistrer_transcription

portée : ecriture

Enregistre la transcription complète et les chapitres horodatés du tutoriel.

ParamètreTypeRequisDescription
cle_apitextenonOptionnel (déprécié). Préférez l'en-tête Authorization: Bearer <clé> (ou X-Academie-Cle). Clé générée dans /admin/parametres.
slugtexteouiSlug du tutoriel.
transcriptiontexteouiTexte intégral de la transcription.
chapitresliste de objetnonChapitres horodatés.
Exemple d'appel
{
  "method": "tools/call",
  "params": {
    "name": "enregistrer_transcription",
    "arguments": {
      "slug": "mon-tutoriel",
      "transcription": "…"
    }
  }
}

enregistrer_seo

portée : ecriture

Enregistre le titre, la description, les mots-clés et l'image OG du tutoriel.

ParamètreTypeRequisDescription
cle_apitextenonOptionnel (déprécié). Préférez l'en-tête Authorization: Bearer <clé> (ou X-Academie-Cle). Clé générée dans /admin/parametres.
slugtexteouiSlug du tutoriel.
seo_titretextenonBalise title (60 caractères max conseillés).
seo_descriptiontextenonMeta description (160 caractères max conseillés).
seo_mots_clesliste de textenonMots-clés.
seo_og_imagetextenonImage Open Graph.
Exemple d'appel
{
  "method": "tools/call",
  "params": {
    "name": "enregistrer_seo",
    "arguments": {
      "slug": "mon-tutoriel"
    }
  }
}

ajouter_astuces

portée : ecriture

Ajoute ou remplace les astuces du tutoriel.

ParamètreTypeRequisDescription
cle_apitextenonOptionnel (déprécié). Préférez l'en-tête Authorization: Bearer <clé> (ou X-Academie-Cle). Clé générée dans /admin/parametres.
slugtexteouiSlug du tutoriel.
astucesliste de valeurouiAstuces : { titre, texte, niveau }.
modevaleur imposéenonAjouter à la suite ou remplacer la liste.
Exemple d'appel
{
  "method": "tools/call",
  "params": {
    "name": "ajouter_astuces",
    "arguments": {
      "slug": "mon-tutoriel",
      "astuces": [
        "…"
      ]
    }
  }
}

ajouter_cas_usage

portée : ecriture

Ajoute ou remplace les cas d'usage (contexte, action, résultat) du tutoriel.

ParamètreTypeRequisDescription
cle_apitextenonOptionnel (déprécié). Préférez l'en-tête Authorization: Bearer <clé> (ou X-Academie-Cle). Clé générée dans /admin/parametres.
slugtexteouiSlug du tutoriel.
cas_usageliste de valeurouiCas d'usage : { contexte, action, resultat }.
modevaleur imposéenonAjouter à la suite ou remplacer la liste.
Exemple d'appel
{
  "method": "tools/call",
  "params": {
    "name": "ajouter_cas_usage",
    "arguments": {
      "slug": "mon-tutoriel",
      "cas_usage": [
        "…"
      ]
    }
  }
}

ajouter_prompts

portée : ecriture

Ajoute ou remplace les prompts prêts à copier du tutoriel.

ParamètreTypeRequisDescription
cle_apitextenonOptionnel (déprécié). Préférez l'en-tête Authorization: Bearer <clé> (ou X-Academie-Cle). Clé générée dans /admin/parametres.
slugtexteouiSlug du tutoriel.
promptsliste de valeurouiPrompts : { titre, texte, description, outil_mcp }.
modevaleur imposéenonAjouter à la suite ou remplacer la liste.
Exemple d'appel
{
  "method": "tools/call",
  "params": {
    "name": "ajouter_prompts",
    "arguments": {
      "slug": "mon-tutoriel",
      "prompts": [
        "…"
      ]
    }
  }
}

configurer_agent_tutoriel

portée : ecriture

Définit les instructions et les outils MCP de l'agent IA du tutoriel.

ParamètreTypeRequisDescription
cle_apitextenonOptionnel (déprécié). Préférez l'en-tête Authorization: Bearer <clé> (ou X-Academie-Cle). Clé générée dans /admin/parametres.
slugtexteouiSlug du tutoriel.
agent_instructionstextenonInstructions système de l'agent.
agent_outils_mcpliste de textenonOutils MCP autorisés.
Exemple d'appel
{
  "method": "tools/call",
  "params": {
    "name": "configurer_agent_tutoriel",
    "arguments": {
      "slug": "mon-tutoriel"
    }
  }
}

Formations & hubs — 4 outils

Parcours pédagogiques, leçons et regroupements métier.

creer_formation

portée : ecriture

Crée ou met à jour un parcours de formation (idempotent sur le slug).

ParamètreTypeRequisDescription
cle_apitextenonOptionnel (déprécié). Préférez l'en-tête Authorization: Bearer <clé> (ou X-Academie-Cle). Clé générée dans /admin/parametres.
titretexteouiTitre du parcours.
slugtextenonSlug souhaité.
sous_titretextenon
descriptiontextenon
categorietextenonCatégorie (marketing, vente, communication…).
niveautextenondebutant, intermediaire ou avance.
duree_minutesnombrenon
cover_urltextenon
objectifsliste de textenon
public_cibletextenon
Exemple d'appel
{
  "method": "tools/call",
  "params": {
    "name": "creer_formation",
    "arguments": {
      "titre": "…"
    }
  }
}

ajouter_lecon

portée : ecriture

Ajoute ou met à jour une leçon d'une formation (idempotent sur le numéro).

ParamètreTypeRequisDescription
cle_apitextenonOptionnel (déprécié). Préférez l'en-tête Authorization: Bearer <clé> (ou X-Academie-Cle). Clé générée dans /admin/parametres.
formationtexteouiSlug de la formation.
numeronombreouiNuméro de la leçon.
titretexteouiTitre de la leçon.
contenutextenonContenu Markdown.
video_urltextenon
youtube_urltextenon
duree_minutesnombrenon
points_clesliste de textenon
exercicevaleurnonExercice pratique.
quizliste de valeurnonQuestions de quiz.
promptsliste de valeurnon
transcriptiontextenon
Exemple d'appel
{
  "method": "tools/call",
  "params": {
    "name": "ajouter_lecon",
    "arguments": {
      "formation": "…",
      "numero": 1,
      "titre": "…"
    }
  }
}

publier_formation

portée : ecriture

Publie la formation et ses leçons immédiatement, sans validation admin.

ParamètreTypeRequisDescription
cle_apitextenonOptionnel (déprécié). Préférez l'en-tête Authorization: Bearer <clé> (ou X-Academie-Cle). Clé générée dans /admin/parametres.
slugtexteouiSlug de la formation.
Exemple d'appel
{
  "method": "tools/call",
  "params": {
    "name": "publier_formation",
    "arguments": {
      "slug": "mon-tutoriel"
    }
  }
}

configurer_hub

portée : ecriture

Crée ou met à jour un hub métier et son agent IA (nom, instructions, outils, actions suggérées).

ParamètreTypeRequisDescription
cle_apitextenonOptionnel (déprécié). Préférez l'en-tête Authorization: Bearer <clé> (ou X-Academie-Cle). Clé générée dans /admin/parametres.
slugtexteouiSlug du hub.
nomtexteouiNom affiché du hub.
descriptiontextenon
iconetextenon
couleurtextenonCouleur hexadécimale.
module_idsliste de textenonIdentifiants des modules rattachés.
agent_nomtextenon
agent_instructionstextenon
agent_outils_mcpliste de textenon
agent_actions_suggereesliste de valeurnonActions rapides : { libelle, prompt }.
Exemple d'appel
{
  "method": "tools/call",
  "params": {
    "name": "configurer_hub",
    "arguments": {
      "slug": "mon-tutoriel",
      "nom": "…"
    }
  }
}

Marketplace de prompts — 11 outils

Bibliothèque de prompts IA, variantes et statistiques d'usage.

lister_prompts

portée : lecturelecture seule

Appeler pour parcourir ou filtrer la marketplace de prompts : « quels prompts avez-vous sur les relances ? », « liste les prompts du module vente ». Renvoie des fiches résumées et paginées, sans le texte complet. Ne pas appeler pour lire un prompt précis : utiliser obtenir_prompt.

ParamètreTypeRequisDescription
cle_apitextenonOptionnel (déprécié). Préférez l'en-tête Authorization: Bearer <clé> (ou X-Academie-Cle). Clé générée dans /admin/parametres.
moduletextenonSlug du module.
categorietextenon
typevaleur imposéenon
niveauvaleur imposéenon
outil_mcptextenonNom technique d'un outil CRM.
qtextenonRecherche libre sur titre, description et texte.
est_publiebooléennon
sourcevaleur imposéenon
limitenombrenonDéfaut 50, maximum 200.
decalagenombrenon
Exemple d'appel
{
  "method": "tools/call",
  "params": {
    "name": "lister_prompts",
    "arguments": {}
  }
}

obtenir_prompt

portée : lecturelecture seule

Appeler pour lire un prompt en entier : texte, variables, prérequis, exemple de résultat, outil MCP visé, variantes par IA, tutoriel lié et statistiques de copies. Ne pas appeler pour explorer : utiliser lister_prompts.

ParamètreTypeRequisDescription
cle_apitextenonOptionnel (déprécié). Préférez l'en-tête Authorization: Bearer <clé> (ou X-Academie-Cle). Clé générée dans /admin/parametres.
slugtexteouiSlug du prompt.
Exemple d'appel
{
  "method": "tools/call",
  "params": {
    "name": "obtenir_prompt",
    "arguments": {
      "slug": "mon-tutoriel"
    }
  }
}

creer_prompt

portée : ecriture

Appeler pour publier un prompt dans la marketplace. Idempotent sur le slug : un prompt existant voit ses champs fournis fusionnés, les autres restent intacts. Les variables sont déduites du texte ([placeholder]) si elles ne sont pas fournies. Publication immédiate, sans validation admin. Ne pas appeler pour plus de 3 prompts d'affilée : utiliser creer_prompts_lot.

ParamètreTypeRequisDescription
cle_apitextenonOptionnel (déprécié). Préférez l'en-tête Authorization: Bearer <clé> (ou X-Academie-Cle). Clé générée dans /admin/parametres.
titretexteouiTitre lisible du prompt.
textetexteouiTexte du prompt. Chaque [placeholder] entre crochets devient une variable.
slugtextenonSlug souhaité ; déduit du titre si absent.
descriptiontextenonUne phrase : à quoi sert ce prompt.
moduletextenonSlug du module rattaché.
categorietextenon
typevaleur imposéenon
niveauvaleur imposéenon
outil_mcptextenonNom technique de l'outil CRM principal visé.
outils_mcp_secondairesliste de textenon
variablesliste de textenonDéduites automatiquement du texte si le paramètre est absent.
prerequisliste de textenon
exemple_resultattextenon
temps_gagne_minutesnombrenon
tutoriel_slugtextenon
est_favoribooléennon
est_publiebooléennonDéfaut : true, publication immédiate.
sourcevaleur imposéenonmanuel, genere (par une IA) ou importe.
ordrenombrenon
Exemple d'appel
{
  "method": "tools/call",
  "params": {
    "name": "creer_prompt",
    "arguments": {
      "titre": "…",
      "texte": "…"
    }
  }
}

creer_prompts_lot

portée : ecriture

Appeler pour publier jusqu'à 50 prompts en un seul appel, par exemple pour couvrir tous les outils d'une famille CRM. Ne s'arrête jamais sur une erreur unitaire : renvoie le récapitulatif des créés, mis à jour et rejetés avec la raison de chaque rejet.

ParamètreTypeRequisDescription
cle_apitextenonOptionnel (déprécié). Préférez l'en-tête Authorization: Bearer <clé> (ou X-Academie-Cle). Clé générée dans /admin/parametres.
promptsliste de objetouiDe 1 à 50 prompts.
Exemple d'appel
{
  "method": "tools/call",
  "params": {
    "name": "creer_prompts_lot",
    "arguments": {
      "prompts": [
        "…"
      ]
    }
  }
}

modifier_prompt

portée : ecriture

Appeler pour corriger un prompt existant. Patch partiel strict : un champ absent n'est jamais écrasé, un champ à null est explicitement effacé. Ne pas appeler pour créer : utiliser creer_prompt.

ParamètreTypeRequisDescription
cle_apitextenonOptionnel (déprécié). Préférez l'en-tête Authorization: Bearer <clé> (ou X-Academie-Cle). Clé générée dans /admin/parametres.
slugtexteouiSlug du prompt à modifier.
titretextenon
textetextenon
descriptiontextenon
moduletextenon
categorietextenon
typevaleur imposéenon
niveauvaleur imposéenon
outil_mcptextenon
outils_mcp_secondairesliste de textenon
variablesliste de textenon
prerequisliste de textenon
exemple_resultattextenon
temps_gagne_minutesnombrenon
tutoriel_slugtextenon
est_favoribooléennon
est_publiebooléennon
sourcevaleur imposéenon
ordrenombrenon
Exemple d'appel
{
  "method": "tools/call",
  "params": {
    "name": "modifier_prompt",
    "arguments": {
      "slug": "mon-tutoriel"
    }
  }
}

publier_prompt

portée : ecriture

Appeler pour rendre un prompt visible dans la marketplace publique. Mise en ligne immédiate. Ne pas appeler pour le retirer : utiliser depublier_prompt.

ParamètreTypeRequisDescription
cle_apitextenonOptionnel (déprécié). Préférez l'en-tête Authorization: Bearer <clé> (ou X-Academie-Cle). Clé générée dans /admin/parametres.
slugtexteoui
Exemple d'appel
{
  "method": "tools/call",
  "params": {
    "name": "publier_prompt",
    "arguments": {
      "slug": "mon-tutoriel"
    }
  }
}

depublier_prompt

portée : ecriture

Appeler pour retirer un prompt de la marketplace publique sans le supprimer (il reste modifiable en admin). Ne pas appeler pour effacer définitivement : utiliser supprimer_prompt.

ParamètreTypeRequisDescription
cle_apitextenonOptionnel (déprécié). Préférez l'en-tête Authorization: Bearer <clé> (ou X-Academie-Cle). Clé générée dans /admin/parametres.
slugtexteoui
Exemple d'appel
{
  "method": "tools/call",
  "params": {
    "name": "depublier_prompt",
    "arguments": {
      "slug": "mon-tutoriel"
    }
  }
}

supprimer_prompt

portée : completdestructif

Appeler seulement sur demande explicite de suppression. Exige confirmation:true ; sans confirmation, renvoie ce qui serait détruit (variantes incluses). Les compteurs de copies restent en historique. Préférer depublier_prompt pour un simple retrait.

ParamètreTypeRequisDescription
cle_apitextenonOptionnel (déprécié). Préférez l'en-tête Authorization: Bearer <clé> (ou X-Academie-Cle). Clé générée dans /admin/parametres.
slugtexteoui
confirmationbooléenouiDoit valoir true pour supprimer réellement.
Exemple d'appel
{
  "method": "tools/call",
  "params": {
    "name": "supprimer_prompt",
    "arguments": {
      "slug": "mon-tutoriel",
      "confirmation": true
    }
  }
}

ajouter_variante_prompt

portée : ecriture

Appeler pour publier la version d'un prompt adaptée à une IA précise (Claude, ChatGPT ou Mistral). Remplace la variante existante pour cette IA.

ParamètreTypeRequisDescription
cle_apitextenonOptionnel (déprécié). Préférez l'en-tête Authorization: Bearer <clé> (ou X-Academie-Cle). Clé générée dans /admin/parametres.
slugtexteouiSlug du prompt parent.
iavaleur imposéeoui
textetexteoui
notetextenonPourquoi cette variante diffère.
Exemple d'appel
{
  "method": "tools/call",
  "params": {
    "name": "ajouter_variante_prompt",
    "arguments": {
      "slug": "mon-tutoriel",
      "ia": "…",
      "texte": "…"
    }
  }
}

prompts_manquants

portée : lecturelecture seule

Appeler pour savoir quoi produire ensuite côté marketplace : « qu'est-ce qui manque dans les prompts ? ». Renvoie les outils CRM sans prompt, les modules avec moins de trois prompts, les prompts sans exemple de résultat, sans prérequis ou sans variantes IA, et ceux sans aucun placeholder alors que leur outil a des paramètres obligatoires.

ParamètreTypeRequisDescription
cle_apitextenonOptionnel (déprécié). Préférez l'en-tête Authorization: Bearer <clé> (ou X-Academie-Cle). Clé générée dans /admin/parametres.
Exemple d'appel
{
  "method": "tools/call",
  "params": {
    "name": "prompts_manquants",
    "arguments": {}
  }
}

statistiques_prompts

portée : lecturelecture seule

Appeler pour mesurer l'usage de la marketplace : nombre de prompts par module, par type et par niveau, top 20 des plus copiés, répartition des copies par IA et évolution sur 30 jours. Ne pas appeler pour un état global de l'Académie : utiliser statistiques_academie.

ParamètreTypeRequisDescription
cle_apitextenonOptionnel (déprécié). Préférez l'en-tête Authorization: Bearer <clé> (ou X-Academie-Cle). Clé générée dans /admin/parametres.
Exemple d'appel
{
  "method": "tools/call",
  "params": {
    "name": "statistiques_prompts",
    "arguments": {}
  }
}

Routines — 11 outils

Rituels d'actions récurrentes, étapes, exécutions et KPI.

lister_routines

portée : lecturelecture seule

Appeler pour parcourir les rituels récurrents de l'Académie : « vous avez une routine pour les impayés ? », « liste les routines hebdomadaires ». Réponse résumée et paginée. Ne pas appeler pour le détail d'une routine : utiliser obtenir_routine.

ParamètreTypeRequisDescription
cle_apitextenonOptionnel (déprécié). Préférez l'en-tête Authorization: Bearer <clé> (ou X-Academie-Cle). Clé générée dans /admin/parametres.
cadencevaleur imposéenon
categorietextenon
moduletextenonSlug du module rattaché.
hubtextenonSlug du hub rattaché.
niveauvaleur imposéenon
est_publiebooléennon
qtextenonRecherche libre sur titre et promesse.
limitenombrenonDéfaut 50, maximum 200.
decalagenombrenon
Exemple d'appel
{
  "method": "tools/call",
  "params": {
    "name": "lister_routines",
    "arguments": {}
  }
}

obtenir_routine

portée : lecturelecture seule

Appeler avant d'exécuter une routine ou pour l'expliquer : promesse, étapes, prompt déclencheur, outils mobilisés, KPI, prérequis, tutoriels liés et dernières exécutions.

ParamètreTypeRequisDescription
cle_apitextenonOptionnel (déprécié). Préférez l'en-tête Authorization: Bearer <clé> (ou X-Academie-Cle). Clé générée dans /admin/parametres.
slugtexteoui
Exemple d'appel
{
  "method": "tools/call",
  "params": {
    "name": "obtenir_routine",
    "arguments": {
      "slug": "mon-tutoriel"
    }
  }
}

creer_routine

portée : ecriture

Appeler pour publier un rituel récurrent : cadence, prompt déclencheur, étapes, outils MCP, KPI. Idempotent sur le slug : les champs fournis sont fusionnés, les autres restent intacts. Refuse la création si un outil cité dans les étapes n'existe pas dans le catalogue outils_crm, et indique lequel.

ParamètreTypeRequisDescription
cle_apitextenonOptionnel (déprécié). Préférez l'en-tête Authorization: Bearer <clé> (ou X-Academie-Cle). Clé générée dans /admin/parametres.
titretexteoui
promessetexteouiLe bénéfice concret en une phrase.
prompt_declencheurtexteouiMessage que l'utilisateur copie dans son IA pour lancer la routine.
slugtextenon
descriptiontextenon
sous_titretextenon
moduletextenonSlug du module rattaché.
hubtextenonSlug du hub rattaché.
categorietextenon
cadencevaleur imposéenon
jour_suggeretextenonEx. « lundi », « 1er du mois ».
heure_suggereetextenonFormat 24 h, ex. « 08:30 ».
duree_minutesnombrenon
temps_gagne_minutesnombrenon
niveauvaleur imposéenon
etapesliste de objetnon
outils_mcpliste de textenon
agent_instructionstextenon
format_sortietextenon
kpi_codetextenon
kpi_libelletextenon
kpi_unitetextenon
kpi_sensvaleur imposéenon
kpi_cibletextenon
prerequisliste de textenon
tutoriels_liesliste de textenon
formation_slugtextenon
iconetextenon
couleurtextenon
produittextenon
ordrenombrenon
est_publiebooléennon
sourcevaleur imposéenon
Exemple d'appel
{
  "method": "tools/call",
  "params": {
    "name": "creer_routine",
    "arguments": {
      "titre": "…",
      "promesse": "…",
      "prompt_declencheur": "…"
    }
  }
}

publier_routine

portée : ecriture

Appeler pour mettre une routine en ligne immédiatement, sans validation admin. Ne pas appeler pour la retirer : utiliser depublier_routine.

ParamètreTypeRequisDescription
cle_apitextenonOptionnel (déprécié). Préférez l'en-tête Authorization: Bearer <clé> (ou X-Academie-Cle). Clé générée dans /admin/parametres.
slugtexteoui
Exemple d'appel
{
  "method": "tools/call",
  "params": {
    "name": "publier_routine",
    "arguments": {
      "slug": "mon-tutoriel"
    }
  }
}

enregistrer_execution_routine

portée : ecriture

Appeler juste après avoir exécuté une routine pour en consigner le résultat : valeur du KPI, compte rendu, actions proposées et verdict (gardee, ajustee ou abandonnee). Ne pas appeler pour lire l'historique : utiliser journal_routine.

ParamètreTypeRequisDescription
cle_apitextenonOptionnel (déprécié). Préférez l'en-tête Authorization: Bearer <clé> (ou X-Academie-Cle). Clé générée dans /admin/parametres.
slugtexteouiSlug de la routine exécutée.
verdictvaleur imposéeouiDécision prise à l'issue de l'exécution.
valeur_kpinombrenonValeur mesurée du KPI de la routine.
compte_rendutextenon
actions_proposeesliste de textenon
notetextenon
duree_minutesnombrenon
session_idtextenonSession anonyme de suivi.
Exemple d'appel
{
  "method": "tools/call",
  "params": {
    "name": "enregistrer_execution_routine",
    "arguments": {
      "slug": "mon-tutoriel",
      "verdict": "…"
    }
  }
}

journal_routine

portée : lecturelecture seule

Appeler pour suivre une routine dans le temps : « comment évolue ma routine de relance ? ». Renvoie les exécutions datées avec leur KPI, la moyenne, la tendance et la répartition des verdicts.

ParamètreTypeRequisDescription
cle_apitextenonOptionnel (déprécié). Préférez l'en-tête Authorization: Bearer <clé> (ou X-Academie-Cle). Clé générée dans /admin/parametres.
slugtexteoui
periode_joursnombrenonFenêtre d'analyse, défaut 90.
session_idtextenonRestreindre à une session anonyme.
limitenombrenon
Exemple d'appel
{
  "method": "tools/call",
  "params": {
    "name": "journal_routine",
    "arguments": {
      "slug": "mon-tutoriel"
    }
  }
}

modifier_routine

portée : ecriture

Appeler pour corriger une routine existante. Patch partiel strict : un champ absent n'est jamais écrasé, module ou hub à null les détache. Ne pas appeler pour créer : utiliser creer_routine.

ParamètreTypeRequisDescription
cle_apitextenonOptionnel (déprécié). Préférez l'en-tête Authorization: Bearer <clé> (ou X-Academie-Cle). Clé générée dans /admin/parametres.
titretextenon
promessetextenonLe bénéfice concret en une phrase.
prompt_declencheurtextenonMessage que l'utilisateur copie dans son IA pour lancer la routine.
slugtexteouiSlug de la routine à modifier.
descriptiontextenon
sous_titretextenon
moduletextenon
hubtextenon
categorietextenon
cadencevaleur imposéenon
jour_suggeretextenonEx. « lundi », « 1er du mois ».
heure_suggereetextenonFormat 24 h, ex. « 08:30 ».
duree_minutesnombrenon
temps_gagne_minutesnombrenon
niveauvaleur imposéenon
etapesliste de objetnon
outils_mcpliste de textenon
agent_instructionstextenon
format_sortietextenon
kpi_codetextenon
kpi_libelletextenon
kpi_unitetextenon
kpi_sensvaleur imposéenon
kpi_cibletextenon
prerequisliste de textenon
tutoriels_liesliste de textenon
formation_slugtextenon
iconetextenon
couleurtextenon
produittextenon
ordrenombrenon
est_publiebooléennon
sourcevaleur imposéenon
Exemple d'appel
{
  "method": "tools/call",
  "params": {
    "name": "modifier_routine",
    "arguments": {
      "slug": "mon-tutoriel"
    }
  }
}

depublier_routine

portée : ecriture

Appeler pour retirer une routine du site public sans la supprimer. Ne pas appeler pour effacer définitivement : utiliser supprimer_routine.

ParamètreTypeRequisDescription
cle_apitextenonOptionnel (déprécié). Préférez l'en-tête Authorization: Bearer <clé> (ou X-Academie-Cle). Clé générée dans /admin/parametres.
slugtexteoui
Exemple d'appel
{
  "method": "tools/call",
  "params": {
    "name": "depublier_routine",
    "arguments": {
      "slug": "mon-tutoriel"
    }
  }
}

supprimer_routine

portée : completdestructif

Appeler seulement sur demande explicite. Exige confirmation:true ; sans confirmation, renvoie ce qui serait détruit (étapes et exécutions liées). Préférer depublier_routine pour un simple retrait.

ParamètreTypeRequisDescription
cle_apitextenonOptionnel (déprécié). Préférez l'en-tête Authorization: Bearer <clé> (ou X-Academie-Cle). Clé générée dans /admin/parametres.
slugtexteoui
confirmationbooléenouiDoit valoir true pour supprimer réellement.
Exemple d'appel
{
  "method": "tools/call",
  "params": {
    "name": "supprimer_routine",
    "arguments": {
      "slug": "mon-tutoriel",
      "confirmation": true
    }
  }
}

ajouter_etapes_routine

portée : ecriture

Appeler pour compléter le déroulé d'une routine. mode='ajouter' complète la liste existante, mode='remplacer' la réécrit entièrement. Chaque outil_mcp cité doit exister dans le catalogue outils_crm.

ParamètreTypeRequisDescription
cle_apitextenonOptionnel (déprécié). Préférez l'en-tête Authorization: Bearer <clé> (ou X-Academie-Cle). Clé générée dans /admin/parametres.
slugtexteoui
etapesliste de objetoui
modevaleur imposéeouiajouter complète, remplacer réécrit.
Exemple d'appel
{
  "method": "tools/call",
  "params": {
    "name": "ajouter_etapes_routine",
    "arguments": {
      "slug": "mon-tutoriel",
      "etapes": [
        "…"
      ],
      "mode": "…"
    }
  }
}

routines_incompletes

portée : lecturelecture seule

Appeler pour prioriser le travail sur les routines : renvoie les routines publiées sans étapes, sans KPI, sans prompt déclencheur, ou citant un outil qui n'existe plus dans le catalogue CRM.

ParamètreTypeRequisDescription
cle_apitextenonOptionnel (déprécié). Préférez l'en-tête Authorization: Bearer <clé> (ou X-Academie-Cle). Clé générée dans /admin/parametres.
Exemple d'appel
{
  "method": "tools/call",
  "params": {
    "name": "routines_incompletes",
    "arguments": {}
  }
}

Structure & CRM — 1 outils

Synchronisation du catalogue des outils du MCP RapidoCRM.

synchroniser_outils

portée : ecriture

Interroge le serveur MCP RapidoCRM, met à jour le catalogue des outils de l'Académie (familles, modules, paramètres) et génère un prompt par outil qui n'en a pas encore.

ParamètreTypeRequisDescription
cle_apitextenonOptionnel (déprécié). Préférez l'en-tête Authorization: Bearer <clé> (ou X-Academie-Cle). Clé générée dans /admin/parametres.
urltextenonURL du serveur MCP RapidoCRM (défaut : https://crm.rapidosoftware.com/mcp).
forcer_cataloguebooléennonUtiliser le catalogue de référence local au lieu d'interroger le serveur MCP.
Exemple d'appel
{
  "method": "tools/call",
  "params": {
    "name": "synchroniser_outils",
    "arguments": {}
  }
}