Open Source · SAP Cloud ALM MCP Server · Version 1.0
Verbinden Sie Claude, GitHub Copilot, Cursor oder Microsoft Copilot Studio mit SAP Cloud ALM. Fragen Sie nach Requirements, User Stories, Defects, Tests und Processes in normaler Sprache und lassen Sie Dokumentation, User Stories und Verknüpfungen direkt in Cloud ALM anlegen.
Überblick
calmcp ist ein CALM MCP Server: ein MCP Server für SAP Cloud ALM, kurz CALM. Er übersetzt die Fragen Ihres KI-Assistenten in Aufrufe der offiziellen Cloud ALM APIs und liefert die Antworten strukturiert zurück.
Das Model Context Protocol (MCP) ist der offene Standard, über den KI-Assistenten auf externe Systeme zugreifen. Mit calmcp als Cloud ALM MCP Server wird SAP Cloud ALM zu einer solchen Quelle: Projektleitung, Test-Management und Entwicklung stellen ihre Fragen im Chat, statt Listen zu filtern, Exporte zu bauen und Zahlen von Hand zusammenzutragen.
calmcp läuft lokal auf Ihrem Rechner oder zentral in Ihrem eigenen SAP BTP Subaccount. Es gibt keinen Zwischendienst von Consetto: Ihre Daten gehen direkt von Cloud ALM zu Ihrem KI-Client.
So fühlt es sich an
Sie fragen, wie Sie einen Kollegen fragen würden. calmcp wählt die passende Cloud ALM API, zählt serverseitig und gibt dem Assistenten genau die Daten, die er für die Antwort braucht.
count_only und group_by liefern echte Summen.complete: false, statt eine Teilsumme als Gesamtzahl auszugeben.Beispieldialog mit fiktiven Daten.
Funktionen
Statt Dutzender Einzel-Tools bündelt calmcp die Cloud ALM APIs in sechs klare, absichtsbasierte Werkzeuge. Das hält den Kontext Ihres Assistenten schlank und die Antworten präzise.
calm_list
Tasks, Requirements, User Stories, Defects, Projects, Features, Transports, Documents, Test Cases, Hierarchy Nodes und Library-Objekte. Mit OData-Filtern, Feldauswahl, Sprint-Filter, einheitlichem Paging und Live-Zählung.
calm_get
Holt einen einzelnen Datensatz per ID, ein Feature auch über seine Display ID wie 6-123. Ideal für Rückfragen im Gespräch.
calm_analytics
Fragt die Cloud ALM Analytics Provider (Defects, Tasks, Tests …) ab und aggregiert projektübergreifend. Gezählt werden Datensätze, nicht Analytics-Zeilen.
calm_resources
Katalog aller Ressourcen, Status-, Typ- und Prioritätscodes sowie fertige Rezepte. Der Assistent findet so selbst heraus, wie er eine Frage beantwortet.
calm_create
Optional: legt Documents, Features, Tasks (User Stories, Defects, Requirements), Comments und Library-Einträge an und verknüpft bestehende Objekte: Tasks mit Features, Documents, Processes und anderen Tasks, Test Cases mit User Stories. Bestehende Objekte nennen Sie per Display ID. Nie Löschen.
calm_update
Optional: ändert Felder bestehender Features wie Titel, Beschreibung, Status und Priorität. Wurde das Feature zwischenzeitlich geändert, lehnt calmcp ab, und Bilder in der Beschreibung gehen nie unbemerkt verloren.
stdio · HTTP · BTP
Als Ein-Klick-Erweiterung in Claude Desktop, lokal für Claude Code, Cursor und VS Code, oder zentral auf SAP BTP Cloud Foundry mit Single Sign-on für das ganze Team.
Anwendungsfälle
Kopieren Sie eine Frage, fügen Sie sie in Ihren Assistenten ein und sehen Sie selbst.
Status-Reports, Stand-up-Digests und Lenkungskreis-Vorlagen in Minuten statt Stunden.
Defect-Lage, Testabdeckung und Test Plans auf einen Blick, projektübergreifend.
Vom Geschäftsprozess zur offenen Arbeit darauf, in beide Richtungen.
Requirements verstehen, bevor die erste Zeile Code entsteht, und Entwicklungen sauber inventarisieren.
Mit Schreibzugriff: Spezifikationen als Cloud ALM Document anlegen und mit Tasks und Features verknüpfen.
Wer sitzt wo, in welcher Rolle, über mehrere Projects hinweg.
Klick auf eine Frage kopiert sie in die Zwischenablage.
Installation
Wählen Sie den Weg, der zu Ihnen passt. Alle Varianten nutzen denselben Server und dieselben Tools.
Einen Service Key für die SAP Cloud ALM API aus Ihrem BTP Subaccount (OAuth2 Client Credentials: Tenant, Region, Client ID, Client Secret). Die Region ist z. B. eu10, eu20, us10 oder ap10.
Nutzen Sie die Sandbox des SAP Business Accelerator Hub mit Ihrem persönlichen API Key. Kein eigener Tenant nötig.
Der einfachste Weg für Einzelpersonen. calmcp kommt als Claude Desktop Extension (.mcpb) und läuft auf macOS, Windows und Linux.
calmcp-<version>.mcpb von den GitHub Releases.Schreib- und Änderungszugriff bleiben aus, bis Sie in den Erweiterungseinstellungen Write Access bzw. Update Access einschalten.
Voraussetzung ist Node.js ab Version 22. Einmal bauen, dann in jedem MCP-Client eintragen.
git clone https://github.com/consetto/calmcp.git
cd calmcp && npm install && npm run build
claude mcp add calmcp \
-e CALM_TENANT=<tenant> -e CALM_REGION=eu10 \
-e CALM_CLIENT_ID=<client-id> -e CALM_CLIENT_SECRET=<secret> \
-- node "$PWD/dist/index.js"Cursor, Claude Desktop und andere Clients nutzen dieselbe Konfiguration als JSON (in VS Code heißt der Schlüssel servers statt mcpServers):
{
"mcpServers": {
"calmcp": {
"command": "node",
"args": ["/absoluter/pfad/zu/calmcp/dist/index.js"],
"env": {
"CALM_TENANT": "<tenant>",
"CALM_REGION": "eu10",
"CALM_CLIENT_ID": "<client-id>",
"CALM_CLIENT_SECRET": "<secret>"
}
}
}
}Sandbox statt Tenant: "CALM_SANDBOX": "true" und "CALM_API_KEY": "<key>" setzen.
Für Teams: einmal deployen, alle melden sich mit ihrem BTP-Benutzer an. Das MTA legt XSUAA, Destination Service und Application Logging automatisch an.
git clone https://github.com/consetto/calmcp.git
cd calmcp && npm install
mbt build
cf deploy mta_archives/calmcp_1.0.0.mtarSAP_CALM, Typ HTTP, URL https://<tenant>.<region>.alm.cloud.sap/api, Authentifizierung OAuth2ClientCredentials mit den Daten aus dem Cloud ALM Service Key.CALMCP_Viewer zuweisen, für Anlegen und Ändern CALMCP_Editor.https://<route>/mcp eintragen. Der Login läuft interaktiv über XSUAA, calmcp sieht nie ein Passwort. Beim ersten Login bestätigen Sie den Client einmal.claude mcp add --transport http calmcp https://<route>/mcpIn Claude Desktop: Einstellungen → Connectors → Custom Connector mit der /mcp-URL. Die ausführliche Anleitung steht in der README. Bestehende Installation aktualisieren: vollständiges cf deploy, siehe OAuth Upgrade Guide. Von 0.9 auf 1.0 wurden einige Parameter umbenannt, die Liste steht im Changelog.
Copilot Studio ruft Server-zu-Server auf, deshalb nutzt es statt eines Benutzer-Logins einen API-Key. Basis ist das BTP-Deployment aus dem vorherigen Tab.
cf set-env calmcp-srv CALM_HTTP_API_KEY "$(openssl rand -base64 48)", danach cf restart calmcp-srv.copilot-studio/calmcp-connector.json aus dem Repository importieren und den host auf Ihre Route setzen.Bearer <ihr-key> eintragen.Schritt für Schritt: Copilot Studio Anleitung auf GitHub.
Sicherheit & Vertrauen
Ein KI-Assistent, der Ihr Projektgedächtnis liest, muss sich an klare Regeln halten. calmcp macht diese Regeln zur Voreinstellung.
Ohne ausdrückliche Freigabe liest calmcp nur. Gelöscht wird nie.
Anlegen und Ändern sind getrennte Schalter, nur für Benutzer mit CALMCP_Editor, mit strikter Prüfung gegen die OpenAPI-Spezifikation. Jede Änderung landet im Audit-Log.
XSUAA mit OAuth und Dynamic Client Registration, Freigabe des Clients bei der Anmeldung, Weiterleitung nur an bekannte MCP-Clients, Rollensammlungen CALMCP_Viewer und CALMCP_Editor, alternativ API-Key für Server-Clients.
Bleibt Cloud ALM bei einem Schreibzugriff die Antwort schuldig, wird nichts wiederholt, und calmcp sagt, dass das Ergebnis offen ist. Rich Text wird gegen eine Allowlist geprüft.
Semantic Versioning: Tools, Parameter, Fehlercodes, Scopes und Rollen ändern sich nur mit einer neuen Hauptversion. Jede Änderung steht im Changelog.
Läuft auf Ihrem Rechner oder in Ihrem BTP Subaccount. Kein Consetto-Dienst dazwischen, Quellcode offen unter MIT.
FAQ
calmcp ist ein Open-Source CALM MCP Server, also ein MCP Server für SAP Cloud ALM (kurz CALM). Er stellt die Cloud ALM APIs über das Model Context Protocol bereit, sodass KI-Assistenten wie Claude, GitHub Copilot, Cursor oder Microsoft Copilot Studio Requirements, User Stories, Defects, Tests, Processes und Documents in natürlicher Sprache abfragen können.
Nichts. calmcp steht unter der MIT-Lizenz und ist auf GitHub frei verfügbar. Sie benötigen lediglich einen Zugang zu SAP Cloud ALM und einen KI-Client, der MCP unterstützt.
Gelöscht wird nie. calmcp ist per Default rein lesend. Mit CALM_WRITE_ENABLED=true kann ein Administrator zusätzlich das Anlegen neuer Documents, Features, Tasks, Comments und Library-Einträge sowie das Verknüpfen bestehender Objekte erlauben, mit CALM_UPDATE_ENABLED=true das Ändern von Feldern bestehender Features, geschützt gegen das Überschreiben paralleler Änderungen.
Ja. Mit Version 1.0 folgt calmcp Semantic Versioning: Tool- und Parameternamen, Fehlercodes, das Format von Zählungen und Schreibantworten, Umgebungsvariablen sowie Scopes und Rollensammlungen ändern sich nur mit einer neuen Hauptversion. Alle Änderungen stehen im Changelog.
Mit jedem MCP-fähigen Client, zum Beispiel Claude Desktop, Claude Code, Cursor, VS Code mit GitHub Copilot und Microsoft Copilot Studio. Lokal läuft calmcp über stdio, im Team über Streamable HTTP auf SAP BTP.
Einen SAP Cloud ALM Tenant mit einem Service Key für die Cloud ALM API (OAuth2 Client Credentials) oder zum Ausprobieren einen API Key für die Sandbox des SAP Business Accelerator Hub. Für die lokale Installation aus dem Quellcode wird Node.js ab Version 22 benötigt.
Tasks (inklusive Requirements, User Stories, Defects, Risks und Quality Gates), Projects und Programs, Features, Documents, Process Hierarchy, Process Scopes, Custom Processes, Test Management, Test Plans, Analytics, Status Events, Landscape und die Cross-Library mit Applications, Configurations, Developments und Interfaces.
calmcp läuft auf Ihrem Rechner oder in Ihrem eigenen SAP BTP Subaccount und ruft die Cloud ALM APIs direkt auf. Consetto betreibt keinen Zwischendienst. Welche Daten an ein Sprachmodell gehen, entscheidet der von Ihnen gewählte KI-Client.
Installieren Sie calmcp, geben Sie dem Projekt einen Stern auf GitHub und erzählen Sie uns, was Sie damit bauen. Für den Rollout im Team, BTP-Deployment oder einen Workshop sind wir gerne da.