So steuern Sie Confluence mit Claude
Confluence mit Claude steuern: Seiten in Markdown entwerfen, per API veröffentlichen und jede Seite von einer Person genehmigen lassen. Unser Beispiel sind unsere SOC-2-Richtlinien.

Sie können Confluence mit Claude steuern: Claude entwirft jede Seite in Markdown, wandelt das Markdown in das Atlassian Document Format um und ergänzt Makros von Capable und Confluence, damit die Seite zu Ihrer Vorlage passt. Eine Person genehmigt jede Seite, bevor sie gilt. Solange eine Seite nicht genehmigt ist, gilt sie nicht als fertig.
So haben wir den Richtlinienbereich für unser SOC-2-Type-II-Audit aufgebaut: 77 Dokumente, die korrekt und einheitlich sein und von einer verantwortlichen Person abgezeichnet werden mussten. Dieselben Schritte funktionieren für jede Gruppe gleich aufgebauter Seiten, etwa ein Handbuch, eine Runbook-Sammlung oder einen Release-Prozess. Die Richtlinien sind nur das Beispiel. Es geht um die Methode.
Wie steuern Sie Confluence mit Claude?
Fünf Schritte in dieser Reihenfolge:
- Legen Sie die Fakten in einer Datei ab und weisen Sie Claude an, nichts zu behaupten, was nicht darin steht.
- Lassen Sie Claude jede Seite in Markdown entwerfen und vor dem Hochladen in das Atlassian Document Format umwandeln.
- Geben Sie Claude eine Beispielseite als Vorlage. Claude ergänzt das Markdown um Makros von Capable und Confluence, damit jede Seite zu dieser Vorlage passt.
- Veröffentlichen Sie mit einem Skript, das einen Probelauf macht, eine Sicherung anlegt und den Genehmigungsabschnitt nie auslässt.
- Lassen Sie jede Seite von einer Person lesen und genehmigen. Legen Sie einen Ablauf fest, der zu Ihrem Prüfzyklus passt.
Geschrieben wird über die Confluence REST API, und so haben wir auch die Richtlinien veröffentlicht. Dasselbe geht über den Rovo MCP Server von Atlassian: Claude liest den Bereich und erstellt und aktualisiert die Seiten direkt aus dem Chat. Der Server holt schnell zur API auf. Derzeit hat er noch Probleme beim Hochladen von Bildern und mit fortgeschritteneren Seitenelementen, die er noch nicht unterstützt. Dafür ist ein Skript weiterhin der sicherere Weg, denn es bietet Probelauf, Sicherung und Protokoll.
Geben Sie Claude die Fakten – und nichts sonst
Der wichtigste Schritt kam vor dem ersten Text. Wir haben alles, was über das Unternehmen zutrifft, in einer Profildatei gesammelt: die Tools, die wir nutzen, wer welche Rolle innehat, wo Daten liegen und wie sie behandelt werden.
Die Regel für Claude war einfach: Nichts behaupten, was nicht im Profil steht. Brauchte eine Seite einen Fakt, der im Profil fehlte, wies der Entwurf darauf hin. Wir haben den Fakt dann im Profil ergänzt, nicht auf der Seite. So blieben alle 77 Entwürfe untereinander einheitlich, weil sie alle auf derselben Quelle beruhten.
Die Entwürfe lagen als Markdown-Dateien in einem Git-Repository. Dort lassen sie sich leicht als Diff prüfen und bei Änderungen neu erzeugen. Confluence übernimmt diese Datei aber nicht als Seite. Vor dem Hochladen wandelt Claude das Markdown in das Atlassian Document Format um. Gliedern Sie die Entwürfe so, wie der Bereich aufgebaut ist. Bei uns waren das Richtlinien, Verfahren, Register, Rollen, Governance und Nachweise.
Eine Beispielseite gibt das Format vor
Wir haben eine Seite in Confluence von Hand erstellt und als Vorlage verwendet. Jeder Entwurf musste am Ende so aussehen:
- ein Capable Approval-Banner oben, damit Leser sehen, ob diese Version genehmigt ist
- Seiteneigenschaften für Verantwortlichen, Dokumenttyp und Prüfzyklus, damit Berichte sie auflisten können
- eine Trennlinie vor jedem Abschnitt
- eine Approval-Fußzeile mit dem Status der aktuellen Version und dem vollständigen Genehmigungsverlauf
Die Anpassung übernimmt Claude bei der Umwandlung des Markdowns. Claude ergänzt den Entwurf um Capable-Makros und um Confluence-eigene Elemente, damit die hochgeladene Seite der Vorlage entspricht. Alles davon kann Claude einfügen: Genehmigungsbanner und -fußzeile, Seiteneigenschaften, eine Trennlinie vor einem Abschnitt, Karten, Suchtabellen, Diagramme und Markdown. Sie alle gehören zu 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}")
Per API veröffentlichen – mit Probelauf
Für jeden Schreibvorgang galten dieselben Regeln:
- Standardmäßig Probelauf. Das Skript zeigt an, was es ändern würde. Es schreibt nur, wenn Sie es ausdrücklich anweisen.
- Zuerst sichern. Der aktuelle Inhalt jeder Seite wird gespeichert, bevor sie geändert wird.
- Alles protokollieren. Jedes Erstellen, Aktualisieren, Verschieben und Labeln landet in einer Protokolldatei.
- Keine Seite ohne Genehmigungsabschnitt veröffentlichen. Diese Prüfung würden wir als Erstes übernehmen:
if not adf_has_macro(doc, "approval"):
raise SystemExit(f"Refusing to write page missing approval: {title}")
Eine Seite ohne Genehmigung ist schlimmer als gar keine Seite. Deshalb bricht das Skript ab, statt sie zu veröffentlichen.
Sobald eine Seite im Bereich liegt, hält Publishing for Confluence fest, wohin sie ging und wer sie veröffentlicht hat. In unserem Beispiel landete die Richtlinie im Bereich „Compliance“:
Jede Seite von einer Person genehmigen lassen
Dieser Teil macht die Methode sicher wiederholbar. Claude kann eine überzeugende Seite schreiben, die in einem Detail falsch ist, das nur Sie bemerken würden. Die Profildatei verringert dieses Risiko. Die Genehmigung durch eine Person beseitigt es.
Jede Seite kam nicht genehmigt in Confluence an. Der Verantwortliche las sie und genehmigte sie oder lehnte sie mit Kommentaren ab – in Capable Approval. Abgelehnte Seiten gingen zurück in einen neuen Entwurf. Nichts galt als erledigt, solange es keinen namentlich genannten Genehmiger und kein Datum hatte.
Zwei Einstellungen sorgen dafür, dass das auf Dauer trägt. Wir haben sie auf eine jährliche Prüfung der Richtlinien eingestellt. Sie wählen den Zyklus, den Ihre eigenen Seiten tatsächlich brauchen.
- Genehmigungen laufen ab. Der Prüfzyklus ist keine Erinnerung in irgendeinem Kalender. Läuft eine Genehmigung ab, wird die Seite wieder als nicht genehmigt angezeigt und landet erneut auf der Freigabeliste. Die Fußzeile hält Datum, Version und die Mindestzahl an Genehmigungen fest.
- Der Verlauf bleibt auf der Seite. Jede Entscheidung – von wem und für welche Version – ist in der Fußzeile sichtbar. Capable selbst schreibt einen Eintrag, wenn sich der Genehmigungsstatus ändert. Der Nachweis besteht also nicht nur aus dem Kommentar der Person.
Confluence Cloud bietet in Premium und Enterprise auch eine eigene Seitengenehmigung. Darauf geht unser Leitfaden zur Seitengenehmigung in Confluence ein. Die Dokumentation von Atlassian beschreibt keine Genehmigungen, die in einem Zyklus ablaufen, und in Free und Standard ist die Funktion nicht enthalten. Wir haben hier Capable Approval genutzt, weil Ablauf und Verlauf auf der Seite die eigentliche Kontrolle sind.
Capable Approval kostenlos im Atlassian Marketplace testen →
Karten, Suchtabellen und weitere Makros
Die Richtlinienseiten sind die Dokumente. Die Seiten drumherum entstehen mit derselben Umwandlung: Claude ergänzt das Markdown um Makros, damit die Übersichtsseite zu ihrer Vorlage passt.
Eine Übersichtsseite wie „Start here“ besteht aus Karten-Makros. Jede Karte hat einen Titel, eine kurze Zeile, eine Farbe und einen Link zu einer Seite. Claude fügt die Karte bei der Umwandlung des Markdowns ein. Es ist keine Linkliste, die in die Seite kopiert wurde.
Eine Dokumentliste ist ein Capable Search-Makro, das Claude bei derselben Umwandlung einfügt. Die Zeilen sind keine von Claude eingetippten Titel. Das Makro führt eine gespeicherte Suche aus (welche Seiten, welches Label) und zeigt die von Ihnen gewählten Spalten. Da Approval installiert ist, können dazu auch Approval Status und Expires at gehören. Genehmigt jemand eine Seite, aktualisiert sich die Zeile. Die Übersichtsseite muss nicht erneut veröffentlicht werden.
Auch das Info-Panel über der Tabelle ist ein Formatierungsmakro, eingefügt im selben Durchgang. Ein Diagramm oder ein Markdown-Block ist dieselbe Art von Ergänzung. Labels bestimmen, welche Seiten erscheinen: Eine Seite mit dem Label controlled kann in der Prüfliste stehen, ein Eintrag mit dem Label comp-open bleibt bei den offenen Einträgen, bis er geschlossen wird. Mehr dazu lesen Sie unter Capable Search mit Genehmigungen nutzen. Das Muster funktioniert für jede Gruppe von Seiten, nicht nur für ein Audit.
Was Sie beim zweiten Mal ändern sollten
Übergeben Sie die maßgebliche Quelle. Bei der ersten Veröffentlichung war das Markdown in Git die Masterkopie. Sobald Personen Seiten genehmigten und in Confluence bearbeiteten, musste sich das ändern. Unsere Veröffentlichungsskripte ordneten Seiten über den Titel zu und setzten für jede Seite die übergeordnete Seite. Ein erneuter Lauf hätte also Seiten verschoben und bereits erteilte Genehmigungen zurückgesetzt. Wir haben die Skripte abgeschaltet. Confluence ist jetzt der Nachweis, das Repository ist Geschichte.
Links zwischen Dateien überstehen den Weg nicht. Ein Link von einer Markdown-Datei auf eine andere wird in Confluence zu einem defekten Link. Lösen Sie vor dem Veröffentlichen jeden Link in eine echte Seiten-ID auf.
Halten Sie Claude bei den Fakten. Die Umwandlung von Markdown in ADF und die Anpassung an die Vorlage ändern nichts an der Regel. Claude darf weiterhin nichts behaupten, was nicht im Profil steht. Lesen Sie die Seite, bevor jemand sie genehmigt.
Die Genehmigung ist die Kontrolle. Der Wert liegt nicht darin, dass Claude 77 Entwürfe geschrieben hat. Er liegt darin, dass jeder davon von der verantwortlichen Person gelesen und abgezeichnet wurde – und wieder wird, wenn die Genehmigung abläuft.
Wenden Sie es auf Ihre eigenen Seiten an
Für denselben Ansatz brauchen Sie unsere Skripte nicht:
- Halten Sie die Fakten, auf denen Ihre Dokumente beruhen, an einem Ort fest.
- Lassen Sie Claude jede Seite in Markdown entwerfen, und zwar nur auf Basis dieser Fakten. Vor dem Hochladen wandelt Claude das Markdown in das Atlassian Document Format um und ergänzt Makros von Capable und Confluence, damit die Seite zu Ihrer Vorlage passt. Karten, Suche, Diagramme, Markdown und Genehmigung sind alles Makros, die Claude einfügen kann.
- Erstellen Sie eine Beispielseite und nutzen Sie sie als Vorlage.
- Veröffentlichen Sie mit einem Skript, das einen Testlauf macht, eine Sicherung anlegt und keine Seite ohne Genehmigungsabschnitt durchlässt. Rovo MCP kann Seiten direkt aus dem Chat erstellen und aktualisieren und holt schnell auf. Bild-Uploads und einige komplexere Vorgänge können aber noch fehlschlagen.
- Aktivieren Sie die Genehmigung mit einem Ablaufdatum, das zu Ihrem Prüfzyklus passt.
- Fügen Sie Karten-Makros für die Übersichtsseiten hinzu und eine Suchtabelle mit einer Spalte für den Genehmigungsstatus. So bleibt keine ungenehmigte Seite unbemerkt.
Capable for Confluence kostenlos im Atlassian Marketplace testen →
Häufig gestellte Fragen
Wie steuern Sie Confluence mit Claude?
Legen Sie die Fakten, die Claude verwenden darf, in einer Datei ab, und lassen Sie Claude jede Seite in Markdown entwerfen. Vor dem Hochladen wandelt Claude das Markdown in das Atlassian Document Format um und ergänzt Makros von Capable und Confluence, damit die Seite zu Ihrer Vorlage passt. Veröffentlichen Sie über die Confluence REST API oder Rovo MCP. Jede neue Seite bleibt ungenehmigt, bis eine Person sie freigibt.
Kann Claude eine Seite direkt in Confluence veröffentlichen?
Ja. Ein Skript, das die Confluence REST API aufruft, kann einen Testlauf machen, die aktuelle Seite sichern und die Veröffentlichung einer Seite ohne Genehmigungsabschnitt verweigern. Auch der Rovo MCP-Server von Atlassian kann Seiten direkt aus dem Chat erstellen und aktualisieren. Er erreicht schnell den Funktionsumfang der API, doch das Hochladen von Bildern und einige komplexere Seitenvorgänge können noch fehlschlagen.
Kann Claude Capable-Makros erstellen?
Ja. Wenn Claude das Markdown in das Atlassian Document Format umwandelt, kann es jedes Capable-Makro und die eigenen Elemente von Confluence einfügen, damit die Seite Ihrer Vorlage entspricht. Dazu gehören Karten, Suchtabellen, Panels, Genehmigungen, Diagramme und Markdown.
Wie verhindern Sie, dass eine erneute Veröffentlichung eine Genehmigung löscht?
Betrachten Sie Confluence als maßgebliche Quelle, sobald dort Seiten genehmigt und bearbeitet werden. Ein Skript, das Seiten anhand des Titels zuordnet und jeweils die übergeordnete Seite festlegt, verschiebt bei einem erneuten Lauf Seiten und setzt Genehmigungen zurück. Deaktivieren Sie es nach der ersten Veröffentlichung.
Muss eine Genehmigung erneuert werden?
Ja, wenn Sie ein Ablaufdatum festlegen. Auf unseren Richtlinienseiten gilt die Genehmigung 12 Monate. Läuft sie ab, wird die Seite als ungenehmigt angezeigt und landet wieder auf der Freigabeliste. Capable Approval speichert den Verlauf jeder Entscheidung auf der Seite.
Atlassian, Confluence und Rovo sind Marken von Atlassian Pty Ltd. Claude ist eine Marke von Anthropic, PBC. Capable Works Limited ist nicht mit Anthropic verbunden.











