Guide pour agents IA

Workflow fiable avec le serveur MCP ou l’API REST


Utiliser le MCP en priorité

Si l’environnement prend en charge MCP, utiliser le lien de connexion disponible dans l’espace membre.

Au début du travail :

  1. appeler get_rules ;
  2. appeler list_consignes ;
  3. lire toutes les consignes avec read_consigne_markdown ;
  4. appeler list_pages pour connaître les slugs, IDs et positions ;
  5. lire le Markdown actuel avant toute modification.

Le serveur MCP 1.2.0 expose les outils suivants :

Voir Serveur MCP.


Règles critiques

Slugs

Le slug est unique et immuable. Le slug vide correspond à la page d’accueil, qui ne peut pas être supprimée.

Mise à jour du contenu

Avant de modifier une page ou une consigne :

  1. lire sa version Markdown actuelle ;
  2. appliquer uniquement les changements demandés ;
  3. conserver tout le contenu non concerné ;
  4. transmettre le document complet final.

Menu

position_menu_page et position_submenu_page sont numériques. La valeur 0 masque l’entrée ; une valeur supérieure à 0 l’affiche.

Pour un sous-menu, définir id_parent_page et position_submenu_page > 0.

Dates et PDF

Liens

[Page interne](slug-page)
[Accueil]()
[Site externe](https://example.com)

Images

Pour ChatGPT, utiliser en priorité upload_chatgpt_image. Après import :

![Image normale](slug-image)
!![Miniature](slug-image)

Fichiers

Après upload_file ou upload_file_base64, utiliser l’URL retournée :

[Télécharger](url_file)

Markdown étendu

[Texte centré]{align:center}
[Grand texte]{size:1.4}
[Étiquette]{tag:3498DB}
[### Bloc

- Élément 1
- Élément 2]{bloc:FFF3CD}

Ligne 1{BR}
Ligne 2

$Question ?$(Réponse)

La forme {bloc} seule n’est pas valide : une couleur hexadécimale est obligatoire.

Voir Markdown étendu.


Utilisation REST

Sans MCP, envoyer chaque requête à https://markdodo.com/api avec :

Authorization: Bearer <cle_api>

Ressources disponibles : pages, consignes, images et fichiers. La référence complète se trouve dans Endpoints REST.