calmcp 0.9.3: Features in Cloud ALM anlegen und ändern

Bisher hat calmcp in SAP Cloud ALM gelesen, gezählt und auf Wunsch neue Dokumente angelegt. Mit Version 0.9.3 geht der CALM MCP Server einen Schritt weiter: Ihr KI-Assistent kann jetzt Features anlegen und bestehende Features ändern. Weil Ändern mehr Risiko birgt als Anlegen, haben wir dafür ein eigenes Tool mit eigenen Schutzmechanismen gebaut.

Warum Ändern anders ist als Anlegen

Ein neu angelegtes Objekt kann nichts kaputt machen, was vorher da war. Eine Änderung schon: Sie kann eine Bearbeitung überschreiben, die eine Kollegin eine Minute vorher in der Cloud ALM Oberfläche gespeichert hat, oder Bilder aus einer Rich-Text-Beschreibung entfernen. Die Cloud ALM APIs bieten dagegen keinen Schutz, es gibt weder ETag noch If-Match. calmcp übernimmt diese Prüfungen deshalb selbst.

Features anlegen mit calm_create

Das bekannte Tool calm_create legt neben Dokumenten und Library-Einträgen jetzt auch Features an: mit Titel, HTML-Beschreibung, Status, Priorität und den übrigen bearbeitbaren Feldern. Wie bisher gilt: Nur Anlegen, nie Löschen. Ein zweiter Aufruf erzeugt ein zweites Feature.

Neu: calm_update

calm_update ändert Felder eines bestehenden Features. Erlaubt sind genau diese Felder: Titel, Beschreibung (HTML), Status, Priorität, Scope, Verantwortlicher, Release und Workstream. Alles andere, etwa die Projektzuordnung, lehnt calmcp ab. Jeder Aufruf durchläuft dieselben Prüfungen:

• Änderungsprüfung: Der Aufruf enthält den Zeitstempel modifiedAt, den das Modell gelesen hat. calmcp liest das Feature direkt vor dem Schreiben erneut und lehnt mit CONFLICT ab, wenn es sich inzwischen geändert hat.
• Nur echte Änderungen: Felder, die schon den gewünschten Wert haben, werden nicht gesendet.
• Bildschutz: Würde eine neue Beschreibung ein Bild entfernen, lehnt calmcp ab und nennt das Bild. Nur wenn der Aufruf genau dieses Bild ausdrücklich freigibt, nachdem der Benutzer zugestimmt hat, darf es wegfallen.
• Kein aktiver Inhalt: Skripte, Event-Handler, javascript:-Links und Bilder von fremden Servern werden abgewiesen. calmcp liest Texte, die andere geschrieben haben. Ohne diese Prüfung könnte eine eingeschleuste Anweisung in einem Objekt das Modell dazu bringen, ein Tracking-Pixel in ein anderes zu schreiben. Die Prüfung gilt auch für calm_create.
• PATCH, nie wiederholt: calmcp sendet nur die geänderten Felder und wiederholt eine fehlgeschlagene Änderung nie. Bleibt Cloud ALM die Antwort schuldig, sagt das Ergebnis, dass die Änderung vielleicht angekommen ist, und wie man es prüft.
• Vorher und nachher: Die Antwort zeigt jedes geänderte Feld mit altem und neuem Wert.

Nachvollziehbar: das Audit-Log

Cloud ALM vermerkt bei Änderungen über die API nur den technischen Benutzer der Destination. Damit trotzdem klar ist, wer was geändert hat, protokolliert calmcp jede angelegte und jede geänderte Entität: mit dem angemeldeten BTP-Benutzer, dem Objekt, den alten und neuen Werten und den Zeitstempeln. So lässt sich eine Änderung im Zweifel auch von Hand zurücknehmen.

Weitere Neuerungen

• Projekt per Name: calm_list akzeptiert jetzt project_name statt einer UUID. Groß- und Kleinschreibung spielen keine Rolle; ist der Name unbekannt oder mehrdeutig, nennt calmcp die Kandidaten.
• Fehlende Bilder in Dokumenten: Die Documents API liefert Inhalte ohne Bilder. calmcp markiert solche Dokumente mit imagesOmitted: true, damit das Modell nicht glaubt, es habe den vollständigen Text.

So schalten Sie es ein

Anlegen und Ändern sind getrennte Schalter, beide sind standardmäßig aus:

• CALM_WRITE_ENABLED=true aktiviert calm_create, CALM_UPDATE_ENABLED=true aktiviert calm_update. In Claude Desktop heißen die Schalter Write Access und Update Access.
• Auf SAP BTP sehen nur Benutzer mit der Rollensammlung CALMCP_Editor die beiden Tools.
• Der OAuth-Client für die Cloud ALM API braucht zusätzlich den Scope calm-api.features.write.

Danach genügt eine Bitte wie: „Setze Feature 6-123 auf In Test und erhöhe die Priorität.“ Der Assistent liest das Feature, ruft calm_update auf und zeigt Ihnen, was sich geändert hat.

Installation, Konfiguration und alle Funktionen: auf der Produktseite calmcp – der CALM MCP Server und im GitHub-Repository.