API & Intégrations

Chinaski est conçu pour être automatisé : une API REST pour les scripts et les pipelines, des webhooks sortants pour les autres systèmes, et un serveur Model Context Protocol pour que les assistants IA puissent travailler directement sur le CMS. Cette section couvre les trois.

Dans cette section

• Serveur MCP: le serveur Jinja JSON-RPC sur stdio qui expose le CMS à Claude Code et aux autres clients MCP ; configuration, sessions, retries et familles d'outils.
• Référence des outils MCP: la référence outil par outil : arguments, comportement et outils de composition de plus haut niveau.
• Webhooks: les quatre types d'événements sortants (form, post, publish, build), les formes de payload, la signature, les retries et le journal de livraison.
• Automatisation: la surface d'API machine : clés API (scopes read/write, rate limits, expiration), les endpoints /api/* (lectures, créations/mises à jour, upserts, batch jobs, déclencheurs de build) et les endpoints de health pour les monitors.

Deux publics, deux portes

• Les machines qui veulent scripter Chinaski parlent REST avec une clé API : des lectures pour le reporting, des create/update pour les pipelines, jobs pour les imports en masse, et le déclencheur de build. Tout est audité par clé, et une clé peut avoir un scope read ou write.
• Les assistants qui veulent travailler sur le CMS passent par le serveur MCP intégré ; un processus par projet, JSON-RPC sur stdio, adossé au même modèle de clés API ; il ajoute des outils de plus haut niveau (create-with-blocks, translate, bulk import, audits) par-dessus les verbes REST.

Ce qui part vers l'extérieur

La surface API comprend aussi des webhooks sortants : des événements que le CMS vous envoie : submissions, changements de posts, publications planifiées et builds terminés, chacun signable avec un secret HMAC. Le mode air-gap désactive tout cela (et tout autre appel sortant) tant qu'une intégration n'est pas activée délibérément.

Ce que l'API ne fera pas

• Aucun endpoint public de commentaires/feed (ils n'existent pas).
• Aucun verbe DELETE : la suppression reste dans l'interface admin pour éviter une perte de données accidentelle causée par l'automatisation ; l'état de publication et la trash restent des opérations manuelles ou de niveau éditeur.
• Pas d'usurpation de session admin via une clé : les clés API ne portent ni identité utilisateur ni rôles ; elles agissent comme leur propre acteur dans la piste d'audit.