Développeurs

Gérez votre blog depuis un outil d'IA

Laissez Claude ou n'importe quel client MCP lister, écrire, modifier, publier et dépublier les articles du blog de votre boutique via le serveur MCP de Bookatu.

Ce que c'est

Le serveur MCP de l'entreprise, à l'adresse https://bookatu.com/api/mcp, a six outils de blog : blog_list_posts, blog_get_post, blog_create_post, blog_update_post, blog_publish_post et blog_unpublish_post. Ils ne fonctionnent que sur le blog de l'entreprise à laquelle appartient la clé ou l'application connectée. Il n'y a pas d'outil de suppression : retirer un article reste une action à faire dans le tableau de bord.

À quoi ça sert

Vous pouvez demander à votre assistant IA de rédiger un article, d'en retravailler un ou d'en mettre un hors ligne sans ouvrir l'éditeur. Les outils acceptent et refusent les mêmes valeurs que l'éditeur, un article d'une autre entreprise n'est jamais trouvé, et un nouvel article reste un brouillon tant qu'on ne demande pas à l'IA de le publier.

Comment l'utiliser

  1. 1Les propriétaires et les administrateurs créent une clé dans Settings, puis API & monitoring, sous API keys. Dans What this key may do, sur la ligne Blog, forms and email drafts, cochez See posts, forms and email drafts (content:read) pour les deux outils de lecture et Write posts, forms and email drafts (content:write) pour les quatre qui écrivent. Les deux demandent 'Manage the business'. Une clé créée avant les périmètres a besoin d'un accès en lecture et écriture pour écrire, et une application connectée par la connexion a besoin de Read and write quand vous l'approuvez.
  2. 2Dirigez votre client MCP vers https://bookatu.com/api/mcp et envoyez la clé sous la forme Authorization: Bearer bk_live_... à chaque requête. tools/list ne montre que les outils que la clé peut appeler, et un accès en lecture seule est refusé sur chaque outil qui écrit.
  3. 3blog_list_posts liste les brouillons et les articles publiés, du plus récent au plus ancien, avec un statut facultatif all, draft ou published. Il renvoie id, slug, title, status, publishedAt et excerpt, jamais le texte. blog_get_post renvoie un article complet, texte markdown compris, par postId ou slug, et les brouillons sont visibles.
  4. 4blog_create_post demande un titre (de 2 à 140 caractères) et un texte en markdown (jusqu'à 50 000 caractères), avec un extrait facultatif (jusqu'à 300) et une coverImageUrl en http(s). Le slug vient du titre et est rendu unique. Il enregistre un brouillon, sauf si vous envoyez publish: true, qui publie l'article tout de suite.
  5. 5blog_update_post prend un postId et seulement les champs à changer. Tout le reste reste tel quel, et le slug ne change jamais, donc un lien publié continue de fonctionner. Un excerpt ou une coverImageUrl vide efface le champ, et status draft ou published change qui peut voir l'article. blog_publish_post et blog_unpublish_post ne changent que le statut. La première publication fixe publishedAt, et une dépublication ou une nouvelle publication ensuite garde cette date.
  6. 6Les outils ne peuvent pas définir le titre pour la recherche, la description pour la recherche ni les étiquettes, et une mise à jour les laisse tels quels. Définissez-les dans l'éditeur, sous Grow, puis Blog, dans Search & sharing. Une mauvaise valeur est refusée avec une erreur plutôt que coupée, et l'identifiant d'un article d'une autre entreprise répond Post not found. Les schémas complets des outils sont sur /developers.

Was this helpful?

Vous n'avez pas trouvé ce qu'il vous faut ?

Contacter le support ou consultez la FAQ.