Créer et modifier des articles avec MCP

Une fois connecté à Elium via MCP, un assistant peut enregistrer de nouveaux contenus dans Elium et modifier des articles existants. Par défaut, ses modifications sont enregistrées en brouillon : vous les relisez dans Elium, puis vous suivez votre procédure habituelle de publication ou d’approbation.

createArticle

Demandez à votre assistant connecté d’enregistrer du contenu dans Elium, par exemple : "Crée un brouillon intitulé Compte rendu de réunion dans l’espace Opérations à partir de ce Markdown."

1. Demandez à l’assistant de trouver l’espace avec findSpaces et de vérifier que vous pouvez y créer du contenu.
2. Fournissez le titre de l’article et son contenu en Markdown. L’assistant les transmet à createArticle avec l’identifiant de l’espace. Par défaut, l’article est enregistré en brouillon (publish: false).
3. Ouvrez le lien de l’article renvoyé par l’assistant. Relisez le brouillon dans Elium, puis suivez votre procédure habituelle de publication ou d’approbation.

Vous pouvez demander explicitement à l’assistant de publier le nouvel article (publish: true). Vos droits dans l’espace s’appliquent : une approbation peut être nécessaire avant la publication. Le résultat contient l’identifiant de l’article, son lien et une indication de publication. Un article non publié peut être un brouillon ou un article en attente d’approbation.

L’outil accepte le Markdown standard, notamment les tableaux, listes de tâches, textes barrés, notes de bas de page, formules mathématiques, indices et exposants. Pour des exemples de syntaxe, consultez Format d’entrée Markdown. Utilisez les formes Markdown standard avec cet outil ; il ne propose pas le mode d’import Elium Markdown.

Si l’import ne peut pas conserver une mise en forme ou un contenu, la demande est refusée avant la création de l’article. Demandez à l’assistant de corriger les problèmes signalés, puis de réessayer.

updateArticle

Demandez à votre assistant connecté de modifier un passage précis, par exemple : "Dans la politique de déplacement, remplace l’indemnité de repas de 25 € par 30 € et enregistre un brouillon."

1. Demandez à l’assistant de lire d’abord l’article, y compris son dernier brouillon s’il contient des modifications non publiées.
2. Indiquez les passages à modifier. L’assistant transmet le texte Markdown exact et son remplacement. Il doit aussi transmettre la version lue pour qu’Elium refuse la modification si une version plus récente existe. Pour un article traduit, la langue lue est obligatoire ; seule cette traduction est modifiée.
3. Ouvrez le lien de l’article dans Elium. Relisez le brouillon, puis suivez votre procédure habituelle de publication ou d’approbation. L’outil ne publie jamais les modifications.

Chaque passage doit correspondre à un seul emplacement, sauf si l’assistant demande explicitement de remplacer toutes les occurrences. Un remplacement vide supprime le texte. Si un passage est introuvable, ambigu ou chevauche une autre modification, toute la demande est refusée et l’article reste inchangé. La modification est aussi refusée si quelqu’un édite déjà l’article. En cas de conflit de version, demandez à l’assistant de relire le dernier brouillon avant de réessayer.

L’outil modifie uniquement le corps de l’article. Il peut ajouter un court commentaire à l’historique des versions et signale les ajustements de mise en forme. Consultez le format Markdown en entrée pour connaître les formats acceptés.

findSections

Liste les sections (dossiers) qu’un espace utilise pour organiser ses articles. Seuls les espaces configurés pour cela ont des sections ; pour les autres, le résultat est vide et les articles créés restent non classés.

Chaque résultat comprend l’identifiant de la section, son chemin complet (noms des parents séparés par " / ") et sa description si elle est renseignée. La description explique généralement ce qui doit y être classé.

Transmettez l’id de la section comme paramètre section_id de createArticle pour classer un nouvel article dans cette section.

getContentSyntax

Renvoie la spécification Markdown utilisée pour le corps des articles. Elle documente chaque bloc et élément en ligne avec ses attributs, les formes Markdown et HTML acceptées, et les éléments que chaque type de document accepte.

Consultez-la avant d’écrire ou de modifier un corps qui nécessite plus que des paragraphes, des listes et des liens. C’est le dialecte que readArticle renvoie et que createArticle et updateArticle attendent.

L’outil ne prend aucun argument et renvoie la spécification en Markdown. Le même document est aussi disponible comme ressource à l’adresse elium://content/syntax.

checkArticleBody

Simule l’import d’un corps d’article et indique ce qu’il deviendrait une fois enregistré. Rien n’est écrit.

C’est la vérification que createArticle exécute avant d’écrire quoi que ce soit : un corps qui revient comme importable est un corps que l’outil acceptera. Comparez le canonical_markdown renvoyé avec ce que vous avez envoyé : le balisage qu’Elium ne reconnaît pas est supprimé ou conservé comme texte brut, ce qui apparaît là plutôt que comme un problème.

Le résultat comprend :

• importable : indique si createArticle accepterait ce corps

• canonical_markdown : le corps tel qu’il serait enregistré, reconverti en Markdown

• problems : ce que l’import perdrait ou réécrirait, une ligne par élément

Utilisez cet outil avant createArticle lorsque le corps contient une mise en forme complexe. Si des problèmes sont signalés, consultez getContentSyntax pour connaître le balisage accepté, corrigez le corps et vérifiez à nouveau.