Comment piloter Confluence avec Claude
Pilotez Confluence avec Claude : rédigez les pages en markdown, publiez-les via l'API et faites approuver chacune d'elles par une personne. Nos politiques SOC 2 servent d'exemple.

Vous pouvez piloter Confluence avec Claude : il rédige chaque page en markdown, convertit ce markdown en Atlassian Document Format et l'enrichit de macros Capable et Confluence pour que la page corresponde à votre modèle. Une personne approuve chaque page avant qu'elle ne fasse foi. Rien n'est considéré comme terminé tant que ce n'est pas approuvé.
Nous avons utilisé cette méthode pour créer l'espace des politiques de notre audit SOC 2 Type II : 77 documents qui devaient être exacts, cohérents et validés par une personne responsable. Les mêmes étapes fonctionnent pour tout ensemble de pages de même structure, comme un manuel, une bibliothèque de runbooks ou un processus de release. Les politiques ne sont qu'un exemple. C'est la méthode qui compte.
Comment piloter Confluence avec Claude ?
Cinq étapes, dans cet ordre :
- Regroupez les faits dans un seul fichier, et demandez à Claude de n'affirmer rien qui n'y figure pas.
- Demandez à Claude de rédiger chaque page en markdown, puis de la convertir en Atlassian Document Format avant l'envoi.
- Fournissez-lui une page d'exemple qui sert de modèle. Claude enrichit le markdown avec des macros Capable et Confluence pour que chaque page corresponde à ce modèle.
- Publiez avec un script qui fait un essai à blanc, effectue une sauvegarde et refuse d'omettre la section d'approbation.
- Faites lire et approuver chaque page par une personne. Définissez une expiration adaptée à votre cycle de révision.
C'est l'API REST de Confluence qui se charge de l'écriture, et c'est ainsi que nous avons publié les politiques. Vous pouvez faire de même via le serveur MCP Rovo d'Atlassian : Claude lit l'espace, puis crée et met à jour les pages depuis le chat. Il rattrape rapidement l'API. Pour l'instant, il peut avoir du mal à importer des images et à gérer les parties les plus avancées d'une page que le serveur ne prend pas encore en charge. Pour celles-ci, un script reste le moyen d'écriture le plus sûr, car il vous offre un essai à blanc, une sauvegarde et un journal.
Donnez à Claude les faits, et rien d'autre
Le plus utile, nous l'avons fait avant toute rédaction. Nous avons regroupé tout ce qui est vrai sur l'entreprise dans un seul fichier de profil : les outils que nous utilisons, qui occupe quel rôle, où se trouvent les données et comment elles sont traitées.
La règle pour Claude était simple : n'affirmer rien qui ne figure pas dans le profil. Si une page nécessitait un fait absent du profil, le brouillon le signalait, et nous ajoutions ce fait au profil plutôt qu'à la page. Les 77 brouillons sont ainsi restés cohérents entre eux, car ils puisaient tous à la même source.
Les brouillons étaient des fichiers markdown dans un dépôt git, faciles à relire sous forme de diff et faciles à régénérer en cas de changement. Confluence n'accepte pas ce fichier comme page. Avant l'import, Claude convertit le markdown en Atlassian Document Format. Regroupez les brouillons selon l'organisation de l'espace. Les nôtres étaient répartis en politiques, procédures, registres, rôles, gouvernance et preuves.
Laissez une page d'exemple définir le format
Nous avons créé une page à la main dans Confluence et l'avons traitée comme le modèle. Chaque brouillon devait ressembler à ceci :
- une bannière Capable Approval en haut, pour que les lecteurs voient si cette version est approuvée
- des propriétés de page pour le responsable, le type de document et le cycle de révision, afin que les rapports puissent les lister
- un séparateur avant chaque section
- un pied de page Approval indiquant le statut de la version actuelle et l'historique complet des approbations
C'est Claude qui assure la mise en conformité lors de la conversion du markdown. Il enrichit le brouillon avec des macros Capable et des éléments natifs de Confluence, afin que la page importée corresponde au modèle. Il peut ajouter n'importe lequel d'entre eux : la bannière et le pied de page d'approbation, les propriétés de page, un séparateur avant une section, des cartes, des tableaux de recherche, des diagrammes et du markdown. Ils font tous partie de Capable for Confluence.
def require_approval(doc, title):
"""ADF after conversion. Publish only if the template's approval macro is there."""
if not adf_has_macro(doc, "approval"):
raise SystemExit(f"Refusing to write page missing approval: {title}")
Publiez via l'API, avec un essai à blanc
Chaque écriture suivait les mêmes règles :
- Essai à blanc par défaut. Le script affiche ce qu'il modifierait. Il n'écrit que si vous le lui demandez explicitement.
- Sauvegarder d'abord. Le contenu actuel de chaque page est enregistré avant toute modification.
- Tout journaliser. Chaque création, mise à jour, déplacement et étiquette est consigné dans un fichier journal.
- Refuser de publier une page sans sa section d'approbation. C'est la vérification que nous reprendrions en premier :
if not adf_has_macro(doc, "approval"):
raise SystemExit(f"Refusing to write page missing approval: {title}")
Une page qui échappe à l'approbation est pire que pas de page du tout : le script s'arrête donc plutôt que de la publier.
Une fois la page dans l'espace, Publishing for Confluence enregistre où elle a été publiée et par qui. Dans notre exemple, la politique a atterri dans l'espace Compliance :
Faites approuver chaque page par une personne
C'est ce qui permet de répéter la méthode en toute sécurité. Claude peut rédiger une page convaincante mais erronée sur un détail que vous seul remarqueriez. Le fichier de profil réduit ce risque. C'est l'approbation humaine qui le traite.
Chaque page arrivait dans Confluence non approuvée. Le responsable la lisait, puis l'approuvait ou la rejetait avec des commentaires dans Capable Approval. Les pages rejetées repartaient pour un nouveau brouillon. Rien n'était considéré comme terminé sans un approbateur nommé et une date.
Deux paramètres ont permis à ce dispositif de tenir dans la durée. Nous les avons réglés pour une révision annuelle des politiques. À vous de choisir le cycle dont vos pages ont réellement besoin.
- Les approbations expirent. Le cycle de révision n'est pas un rappel dans l'agenda de quelqu'un. Lorsqu'une approbation expire, la page apparaît de nouveau comme non approuvée et revient dans la liste des validations. Le pied de page enregistre la date, la version et le nombre minimal d'approbations.
- L'historique reste sur la page. Chaque décision, avec son auteur et la version concernée, est visible dans le pied de page. Capable inscrit lui-même une ligne lorsque l'état d'approbation change : le registre ne repose donc pas uniquement sur le commentaire de la personne.
Confluence Cloud propose aussi sa propre approbation de page sur les offres Premium et Enterprise. Notre guide sur l'approbation de pages Confluence la présente. La documentation d'Atlassian ne décrit pas d'approbations qui expirent selon un cycle, et la fonctionnalité n'est pas disponible sur Free ni Standard. Nous avons utilisé Capable Approval ici, car l'expiration et l'historique sur la page constituent le contrôle.
Essayez gratuitement Capable Approval sur l'Atlassian Marketplace →
Cartes, tableaux de recherche et autres macros
Les pages de politiques sont les documents. Les pages qui les entourent passent par la même conversion : Claude enrichit le markdown avec des macros pour que la page d'accueil corresponde à son modèle.
Une page d'accueil comme « Start here » est un ensemble de macros de cartes. Chaque carte comporte un titre, une courte ligne, une couleur et un lien vers une page. Claude ajoute la carte lors de la conversion du markdown. Il ne s'agit pas d'une liste de liens collée dans la page.
Une liste de documents est une macro Capable Search, que Claude ajoute lors de la même conversion. Les lignes ne sont pas des titres qu'il a saisis. La macro exécute une recherche enregistrée (quelles pages, quelle étiquette) et affiche les colonnes que vous avez choisies. Comme Approval est installé, ces colonnes peuvent inclure Approval Status et Expires at. Lorsque quelqu'un approuve une page, la ligne se met à jour. Inutile de republier la page d'accueil.
Le panneau d'information au-dessus du tableau est lui aussi une macro de mise en forme, ajoutée lors de ce même passage. Un bloc diagramme ou markdown relève du même type d'enrichissement. Les étiquettes déterminent les pages affichées : une page étiquetée controlled peut figurer dans la liste de révision, un enregistrement étiqueté comp-open reste parmi les enregistrements ouverts jusqu'à sa clôture. Pour en savoir plus, consultez l'utilisation de Capable Search avec les approbations. Le même principe fonctionne pour n'importe quel ensemble de pages, pas seulement pour un audit.
Ce qu'il faut changer la deuxième fois
Transférez la source de vérité. Lors de la première publication, le markdown dans git était la copie de référence. Dès que des personnes ont commencé à approuver et à modifier les pages dans Confluence, cela a dû changer. Nos scripts de publication associaient les pages par titre et définissaient le parent de chacune : les relancer aurait déplacé des pages et réinitialisé des approbations déjà données. Nous les avons désactivés. Confluence fait désormais foi, et le dépôt sert d'historique.
Les liens entre fichiers ne survivent pas au transfert. Un lien d'un fichier markdown vers un autre devient un lien cassé dans Confluence. Résolvez chaque lien vers un véritable ID de page avant de publier.
Cantonnez Claude aux faits. Convertir le markdown en ADF et l'enrichir pour qu'il corresponde au modèle ne change pas la règle. Il ne doit toujours rien affirmer qui ne figure pas dans le profil. Lisez la page avant que quiconque ne l'approuve.
L'approbation est le contrôle. La valeur ne tient pas au fait que Claude ait rédigé 77 brouillons. Elle tient au fait que chacun d'eux a été lu et validé par la personne qui en est responsable, et le sera de nouveau à l'expiration de l'approbation.
Appliquez la méthode à vos propres pages
Vous n'avez pas besoin de nos scripts pour adopter la même approche :
- Consignez en un seul endroit les faits sur lesquels reposent vos documents.
- Demandez à Claude de rédiger chaque page en markdown, en s'appuyant uniquement sur ces faits. Avant l'import, il convertit le markdown en Atlassian Document Format et l'enrichit avec des macros Capable et Confluence pour que la page corresponde à votre modèle. Cartes, recherche, diagrammes, markdown et approbation sont autant de macros qu'il peut ajouter.
- Créez une page d'exemple et traitez-la comme le modèle.
- Publiez avec un script qui fait un essai à blanc, effectue une sauvegarde et refuse d'omettre la section d'approbation. Rovo MCP peut créer et mettre à jour les pages depuis le chat, et il progresse vite, mais l'import d'images et certaines opérations avancées peuvent encore échouer.
- Activez l'approbation, avec une expiration adaptée à votre cycle de révision.
- Ajoutez des macros de cartes pour les pages d'accueil, ainsi qu'un tableau de recherche dont les colonnes incluent le statut d'approbation, pour qu'aucune page non approuvée ne passe inaperçue.
Essayez gratuitement Capable for Confluence sur l'Atlassian Marketplace →
Questions fréquentes
Comment piloter Confluence avec Claude ?
Regroupez dans un seul fichier les faits que Claude peut utiliser, et demandez-lui de rédiger chaque page en markdown. Avant l'import, Claude convertit ce markdown en Atlassian Document Format et l'enrichit avec des macros Capable et Confluence pour que la page corresponde à votre modèle. Publiez via l'API REST de Confluence ou Rovo MCP, et laissez chaque nouvelle page non approuvée jusqu'à ce qu'une personne la valide.
Claude peut-il publier une page directement dans Confluence ?
Oui. Un script qui appelle l'API REST de Confluence peut faire un essai à blanc, sauvegarder la page actuelle et refuser d'en publier une dépourvue de sa section d'approbation. Le serveur MCP Rovo d'Atlassian peut également créer et mettre à jour des pages depuis le chat. Il rattrape rapidement l'API, mais l'import d'images et certaines opérations de page plus avancées peuvent encore échouer.
Claude peut-il créer des macros Capable ?
Oui. Lorsque Claude convertit le markdown en Atlassian Document Format, il peut ajouter toutes les macros Capable, ainsi que les éléments natifs de Confluence, pour que la page corresponde à votre modèle. Cela inclut les cartes, les tableaux de recherche, les panneaux, l'approbation, les diagrammes et le markdown.
Comment éviter qu'une republication efface une approbation ?
Considérez Confluence comme la référence dès que des personnes commencent à y approuver et à modifier des pages. Un script qui associe les pages par titre et définit le parent de chacune déplacera des pages et réinitialisera les approbations si vous le relancez. Désactivez-le après la première publication.
Une approbation doit-elle être renouvelée ?
Oui, si vous définissez une expiration. Sur nos pages de politiques, l'approbation dure 12 mois. À son expiration, la page apparaît comme non approuvée et revient dans la liste des validations. Capable Approval conserve l'historique de chaque décision sur la page.
Atlassian, Confluence et Rovo sont des marques commerciales d'Atlassian Pty Ltd. Claude est une marque commerciale d'Anthropic, PBC. Capable Works Limited n'est pas affilié à Anthropic.











