Référence des outils MCP

Le serveur MCP a 12 outils. Votre IA les appelle pour lire et écrire les pages d'un seul website.

• Un token MCP = un website. Aucun outil ne prend d'id de website.
• Auth : Authorization: Bearer <token>, ou le token dans le chemin de l'URL (https://mcp.flocon-ai.com/<token>). Seul le token mcp fonctionne. Un mauvais token donne 401.
• Les outils voient les brouillons et les pages publiées.
• Chaque outil renvoie du JSON en texte, sauf list_docs et read_doc (texte simple). Les erreurs reviennent comme une erreur d'outil, en une phrase simple.

Voir Connecter le serveur MCP pour l'installer. Voir la référence des blocs pour le champ blocks.

Outils de lecture

get_website

À appeler en premier. Aucune entrée.

Renvoie :

• name, locales, defaultLocale
• plan
• limits : published et maxPages
• counts : published, drafts, total

list_pages

Liste les pages, brouillons inclus. Sans les blocs.

Renvoie { pages }. Chaque page a path, locale, title, status, updatedAt.

search_pages

Cherche dans le titre, la description SEO, le chemin et le texte des blocs. Sans tenir compte de la casse. Brouillons inclus.

Renvoie { pages }, mêmes champs que list_pages.

get_page

Renvoie la page complète (seo et blocks inclus), brouillon ou publiée.

Erreur : No page at <path> in locale "<locale>".

get_setup

Renvoie du code prêt à coller pour le website.

Renvoie framework, files (chacun avec path et code), env et notes.

list_docs

Liste la doc de Flocon AI : le titre, l'URL et le résumé de chaque page. Aucune entrée.

Renvoie https://flocon-ai.com/llms.txt en texte simple. Votre IA s'en sert pour répondre aux questions sur Flocon AI (offres, brouillons, installation, blocks).

read_doc

Renvoie une page de la doc en Markdown.

Erreur : Not a Flocon AI docs URL. Seules les URLs flocon-ai.com/docs/... fonctionnent.

Outils d'écriture

create_page

Crée une page. Elle est publiée s'il y a de la place, sinon enregistrée en brouillon. Le message le dit.

Champs de seo : title, description (obligatoires), keywords, author, schemas (optionnels).

Renvoie path, locale, status, publishAt, message, warnings.

Erreurs :

• Le chemin existe : utilisez update_page.
• Limite de pages atteinte : rien n'est enregistré.
• Limite de pages publiées atteinte : la page est enregistrée en brouillon à la place (pas une erreur). Le message le dit.
• Validation échouée : Not saved. Fix this and try again: puis une liste.

update_page

Modifie une page. Le statut ne change pas.

Renvoie path, locale, status, publishAt, message, warnings. Sur un brouillon, publishAt est ignoré et le message le dit.

Erreurs : page introuvable, validation échouée.

publish_page

Publie un brouillon.

Renvoie path, locale, status, message.

Erreurs : page introuvable, limite de pages publiées atteinte.

unpublish_page

Remet une page publiée en brouillon. Cela libère une place publiée.

Renvoie path, locale, status (draft), message.

Erreur : page introuvable.

delete_page

Supprime une page définitivement. Impossible d'annuler.

Renvoie path, locale, message.

Erreur : page introuvable.

Règles de validation

Une écriture est refusée si :

• la locale n'est pas activée sur le website
• le path :
  • ne commence pas par /
  • finit par /
  • contient //
  • utilise autre chose que a-z minuscules, 0-9, - et /
  • commence par une locale
  • fait plus de 200 caractères
• il y a plus de 100 blocs
• les blocs pèsent plus de 50 Ko
• title est vide

Ceci donne des avertissements, pas des erreurs (la page est quand même enregistrée) :

• seo.title fait plus de 60 caractères
• seo.description ne fait pas entre 140 et 160 caractères

Limites

• Limite de pages publiées : bloque publish_page et un create_page publié.
• Limite de pages : bloque tout create_page, brouillon ou non.
• Les erreurs montrent les compteurs, par exemple Published limit reached (10/10 on free).

Mis à jour 31 octobre 2026