Dieser Guide erklärt, wie du Claude Code als externen App-Building-Agent für Simplifier-Projekte einrichtest. Jedes Projekt bzw. jede Anwendung sollte in einem eigenen Verzeichnis mit eigener MCP-Konfiguration liegen, geklont aus dem Simplifier App Editor.
Voraussetzungen
Bevor du beginnst, stelle sicher, dass Folgendes auf deinem Rechner installiert und verfügbar ist:
- Node.js (LTS-Version, enthält npx)
- Einguss
- Claude Code CLI — Installation über:
npm install -g @anthropic-ai/claude-code - Ein Anthropic-Konto mit Zugriff auf die Modelle Claude Opus und Claude Sonnet
- Zugriff auf deinen Simplifier App Editor (um das Git-Repository des Projekts zu klonen)
- Ein gültiger Simplifier Token aus deiner Simplifier-Instanz (siehe Schritt 3.2 unten)
- Für das Spec Kit (optional, Schritt 7): uv (oder pipx), um das specify-CLI zu installieren
Schritt 1 — Erstelle ein neues Projektverzeichnis
Erstelle für jedes Projekt oder jede Anwendung ein eigenes Verzeichnis auf deinem Rechner. Dies hält MCPs, Konfiguration und Git-Historie pro App isoliert.
mkdir ~/simplifier-projects/<your-app-name>
cd ~/simplifier-projects/<your-app-name>Wichtig: Mische nicht mehrere Simplifier-Apps im selben Verzeichnis. Jede App braucht ihren eigenen Ordner, damit MCPs und der Claude-Code-Kontext sauber bleiben.
Schritt 2 — Klone das Projekt-Git-Repository aus dem Simplifier App Editor
- Öffne deine App im Simplifier App Editor.
- Erstelle eine neue App mit Version 2.
- Öffne das Git-Panel und kopiere die Repository-URL deiner Anwendung.
- Klone in deinem Terminal das Repository in das Verzeichnis, das du gerade erstellt hast:
git clone <simplifier-app-git-url> .Das nachgestellte
.klont das Repo in das aktuelle Verzeichnis. - Überprüfe den Klonvorgang:
git status
Schritt 3 — Wechsle in das Projektverzeichnis und füge MCPs hinzu
Alle MCP-Server müssen aus dem Projekt-Git-Ordner heraus hinzugefügt werden, damit sie nur für diese App gelten. Verwende den claude mcp add-CLI-Befehl.
3.1 — Claude Code im Projektordner starten (einmalig, zum Initialisieren)
cd ~/simplifier-projects/<your-app-name>
claudeBeende es danach wieder mit /exit, sobald es initialisiert ist.
3.2 — Die benötigten MCP-Server per CLI hinzufügen
Führe die folgenden Befehle im Projektverzeichnis aus:
Simplifier MCP — Konnektoren, Business Objekte, Datentypen, SAP-Systeme
Referenz: https://github.com/simplifier-ag/simplifier-mcp
Du benötigst zwei Werte:
SIMPLIFIER_BASE_URL— z. B.https://<yourinstance>-dev.simplifier.cloud(On-Premise-Nutzer verwenden ihre eigene Dev-URL).SIMPLIFIER_TOKEN— dein aktueller SimplifierToken aus der angemeldeten Simplifier-Sitzung.
Installation über npx:
claude mcp add simplifier npx @simplifierag/simplifier-mcp@latest
--env SIMPLIFIER_TOKEN=<your-current-simplifier-token>
--env SIMPLIFIER_BASE_URL=https://<yourinstance>-dev.simplifier.cloudAlternative — via Docker:
claude mcp add simplifier-docker docker -- run --rm -i
--env SIMPLIFIER_TOKEN=<your-current-simplifier-token>
--env SIMPLIFIER_BASE_URL=https://<yourinstance>-dev.simplifier.cloud
simplifierag/simplifier-mcp:latestToken-Rotation: Jedes Mal, wenn du dich bei Simplifier anmeldest, ändert sich dein
SIMPLIFIER_TOKEN. Nach jeder Neuanmeldung musst du:
- Claude Code beenden
- MCP entfernen:
claude mcp remove simplifier- Mit dem neuen Token wieder hinzufügen (Befehl oben)
- Claude Code neu starten
Falls der Simplifier MCP beim Start keine Verbindung herstellen kann, öffnet sich in deinem Browser eine Fehlerseite mit Details und Lösungsvorschlägen.
Fiori MCP Server — SAP Fiori Anwendungs-Scaffolding & -Modifikation
claude mcp add fiori-mcp-server -- npx -y @sap/fiori-mcp-server@latestUI5 MCP Server — SAPUI5 / OpenUI5 Entwicklung, Linting, API-Referenz
claude mcp add ui5-mcp-server -- npx -y @ui5/mcp-server@latestPlaywright MCP — Browser-Automatisierung & End-to-End-Tests
claude mcp add playwright -- npx -y @playwright/mcp@latest3.3 — Überprüfe die MCP-Registrierung
claude mcp listDu solltest alle hinzugefügten MCPs mit dem Status connected sehen:
simplifier(odersimplifier-docker)fiori-mcp-serverui5-mcp-serverplaywright
Schritt 4 — Initialisiere das Simplifier-Projekt
Führe den Init-Befehl in Claude Code aus:
/init-simplifierDieser Befehl führt dich durch:
- Festlegen der Basis-URL der Simplifier-Instanz in
.env - Ausführen von
pnpm install, um UI5-Tooling abzurufen - Starten des Dev-Servers mit
pnpm run start(App verfügbar unterhttp://localhost:12345/index.html) - Registrieren der Simplifier-, Playwright- und UI5-MCPs, auf dieses Projekt begrenzt
- Dokumentieren der MCP-Nutzung in
CLAUDE.md/AGENTS.md
Der Befehl
/init-simplifierliegt im Projekt-Repo unter.claude/commands/init-simplifier.md.
Schritt 5 — Der Zwei-Modi-Workflow: Erst planen, dann bauen
Claude Code bietet zwei Betriebsmodi. Beginne immer im Plan-Modus. Wechsle erst in den Build-Modus, nachdem die Spezifikation geprüft und genehmigt wurde.
5.1 — Plan-Modus (verwende Claude Opus 5)
Der Plan-Modus ist schreibgeschützt: Der Agent analysiert, entwirft und schlägt vor — aber er verändert keine Dateien.
- Empfohlenes Modell:
claude-opus-5(höchste Argumentationsqualität) - Wann zu verwenden: IMMER zu Beginn einer Aufgabe, mit oder ohne Spec Kit
- Ziel: Erstellung einer klaren, geprüften Spezifikation oder eines Implementierungsplans
Plan Mode in Claude Code aktivieren:
Drücke Shift+Tab, um in den plan mode zu wechseln, oder starte Claude Code mit dem Flag:
claude --permission-mode planWähle das Modell aus:
/model claude-opus-5Beschreibe nun, was du bauen möchtest. Prüfe das Ergebnis sorgfältig:
- Entspricht es deiner Absicht?
- Sind alle Entitäten, Konnektoren und Business Objekte korrekt identifiziert?
- Sind Sonderfälle abgedeckt?
- Lassen sich externe Anforderungen (Excel/PDF/Jira) 1:1 in der Spezifikation nachverfolgen?
5.2 — Build-Modus (verwende Claude Sonnet 5)
Sobald die Spezifikation oder der Plan steht, wechsle für die eigentliche Implementierung in den Build-Modus. Sonnet ist schneller und kostengünstiger und für die Ausführung eines gut definierten Plans völlig ausreichend.
- Empfohlenes Modell:
claude-sonnet-5(kosteneffizient, schnell) - Wann zu verwenden: NUR nachdem der Plan/die Spezifikation geprüft und genehmigt wurde
In den Build Mode wechseln:
Drücke Shift+Tab erneut, um den Plan Mode zu verlassen (zurück zum Standard-/accept-edits-Modus).
Wähle das Modell aus:
/model claude-sonnet-5Weise den Agenten nun an, den genehmigten Plan auszuführen. Er wird Dateien erstellen, Befehle ausführen und Änderungen committen.
Schritt 6 — Abhängigkeiten synchronisieren, installieren und deployen
Führen Sie vor dem Push /sync-dependencies aus, damit der Simplifier-Transport die referenzierten Connectoren und Business Objects erfasst. Verwenden Sie Install, um Abhängigkeiten zu installieren; nach Deploy läuft die App auf Simplifier.
Schritt 7 — (Optional, empfohlen für größere Projekte) GitHub Spec Kit integrieren
Für größere Anwendungen empfehlen wir dringend die Verwendung des GitHub Spec Kit Frameworks. Das Spec Kit treibt die spezifikationsgetriebene Entwicklung voran: Du schreibst zuerst eine präzise Spezifikation und lässt sie dann vom Agenten implementieren.
Führe
/init-simplifier(Schritt 4) aus und wechsle in den Plan-Modus (Schritt 5), BEVOR du Spec-Kit-Befehle nutzt.
7.1 — Installiere das Specify-CLI (einmalig, systemweit)
Das Spec Kit wird als specify CLI ausgeliefert. Installiere es einmalig über uv (empfohlen) oder pipx:
# Recommended — using uv
uv tool install specify-cli --from git+https://github.com/github/spec-kit.git
# Alternative — using pipx
pipx install git+https://github.com/github/spec-kit.gitÜberprüfen:
specify version
specify checkFalls
command not found: uv→ installiere zuerst uv oder verwende diepipx-Zeile oben.
7.2 — Initialisiere das Spec Kit in deinem Projekt
Aus deinem Projektverzeichnis heraus (der Simplifier-Git-Clone aus Schritt 2):
cd ~/simplifier-projects/<your-app-name>
# Initialize in the current folder for Claude Code
specify init . --integration claude
# or, equivalent
specify init --here --integration claudeDadurch wird der Ordner .specify/ mit Templates erstellt, plus Claude-Code-Slash-Commands unter .claude/commands/.
7.3 — Projektprinzipien festlegen (Constitution)
Führe in Claude Code aus:
/speckit.constitution Create principles focused on code quality, Simplifier best practices, BusinessObject testing, naming conventions for connectors, and UI consistency for SAPUI5/Fiori screens.7.4 — Erstelle die Spezifikation
Schreibe die Spezifikation für ein kleines/internes Projekt direkt:
/speckit.specify Build a Simplifier app that lets warehouse managers scan barcodes, look up stock levels via the SAP RFC connector, and post goods movements. The UI is a Fiori list-detail layout.7.4.a — Externe Anforderungen integrieren (Excel, Word, PDF, Jira-Export)
Wenn du Anforderungen bereits in einem Excel-Sheet mit User Stories, einer Word-/PDF-Spezifikation, einem Jira-Export oder einem anderen externen Dokument hast, tippe sie nicht erneut ab. Lege die Datei(en) in den Projektordner (z. B. in einen docs/-Unterordner) und lass Claude Code sie lesen.
mkdir docs
cp ~/Downloads/UserStories.xlsx docs/
cp ~/Downloads/RequirementsSpec.pdf docs/Dann nutze in Claude Code (Plan Mode + Opus 5) einen Prompt wie:
Prompt-Beispiel — Excel mit User Stories:
Read the file docs/UserStories.xlsx. Each row is a user story with columns:
ID, Role, Goal, Reason (As a / I want / So that), Acceptance Criteria, Priority, Epic.
Consolidate the stories into a coherent specification grouped by Epic.
Identify all entities, Simplifier Connectors, BusinessObjects and screens implied
by the stories. Then call /speckit.specify with the consolidated text so that
spec.md is created. Preserve the original Story IDs as references in the spec
so we can trace every requirement back to the Excel.Prompt-Beispiel — PDF / Word-Spezifikation:
Read docs/RequirementsSpec.pdf. Extract:
- functional requirements (numbered FR-x)
- non-functional requirements (NFR-x)
- data entities and their fields
- external systems / integrations
Then run /speckit.specify with a structured summary that keeps the FR/NFR IDs
as traceability anchors. Flag anything ambiguous and ask me before finalizing.Prompt-Beispiel — Jira / Azure DevOps CSV-Export:
Read docs/jira-export.csv. Each row is an issue (Story or Task) with key,
summary, description, acceptance criteria, labels, epic link.
Group by Epic Link, deduplicate, and produce a single spec input. Then call
/speckit.specify. Keep Jira keys (e.g. PROJ-123) as references next to each
requirement so we can sync back to Jira later.Claude Code kann lesen
.xlsx,.csv,.docx,.md,.txtdirekt lesen. Bei sehr großen Dateien bitte den Agenten, diese zuerst Kapitel für Kapitel zusammenzufassen und dann die konsolidierte Spezifikation zu erstellen.
Nachdem /speckit.specify ausgeführt wurde, prüfe spec.md und verfeinere es mit /speckit.clarify, falls etwas unzureichend spezifiziert ist.
7.5 — Planen, aufteilen, implementieren
/speckit.plan Use the Simplifier platform: REST/SAP-RFC connectors, server-side BusinessObjects for business logic, and a Fiori-style SAPUI5 frontend. Persist app artifacts via the Simplifier Git integration.
/speckit.tasks
/speckit.analyze # optional — cross-artifact consistency check before implement
/speckit.implement/speckit.constitution |
Projektweite Leitprinzipien |
/speckit.specify |
Definiere, was gebaut werden soll (funktionale Spezifikation) |
/speckit.clarify |
Kläre unzureichend spezifizierte Bereiche (vor /speckit.plan ausführen) |
/speckit.plan |
Definiere, wie es gebaut werden soll (Tech-Stack, Architektur) |
/speckit.tasks |
Erstelle die ausführbare Aufgabenliste |
/speckit.analyze |
Prüfung der Konsistenz und Abdeckung über alle Artefakte hinweg |
/speckit.implement |
Führe alle Aufgaben aus |
Zusammenfassung des empfohlenen Workflows
| Schritt | Aktion | Modell | Modus |
|---|---|---|---|
| 1 | Projektverzeichnis erstellen | — | — |
| 2 | git clone aus dem Simplifier App Editor |
— | — |
| 3 | MCPs via claude mcp add hinzufügen (Simplifier, Fiori, UI5, Playwright) |
— | — |
| 4 | /init-simplifier ausführen |
— | — |
| 5 | Plan Mode aktivieren + Opus 5 auswählen | Opus 5 | Plan |
| 6 | Run /sync-dependencies → Install → Deploy |
Sonnet 5 | Build |
| 7 | (Große Projekte) specify init + /speckit.constitution → /speckit.specify → /speckit.clarify → /speckit.plan |
Opus 5 | Plan |
| 8 | Plan + Spezifikation prüfen und genehmigen | Opus 5 | Plan |
| 9 | In den Build-Modus + Sonnet 4.5 wechseln; /speckit.tasks → /speckit.analyze → /speckit.implement |
Sonnet 5 | Erstellen |
| 10 | Commit und Push zum Simplifier Git | Sonnet 5 | Build |
Tipps & Best Practices
- Ein Projekt = ein Ordner = ein Satz MCPs. Teile MCP-Konfigurationen niemals zwischen nicht zusammenhängenden Apps.
- Beginne immer im Plan-Modus. Die Kosten für einen schlechten Plan sind weitaus höher als die Kosten für Opus-Token.
- Wechsle für die Ausführung zu Sonnet. Das Bauen auf Basis eines klaren Plans erfordert keine Argumentation auf Opus-Niveau.
- Aktualisiere deinen Simplifier Token nach jedem Login. Entferne den
simplifier-MCP und füge ihn erneut hinzu — sonst schlagen Aufrufe mit Auth-Fehlern fehl. - Lege externe Anforderungen in
docs/ab. Excel, PDF, Word, CSV — lass den Agenten sie lesen; kopiere Inhalte niemals manuell per Copy-and-Paste. - Bewahre externe IDs. Story-IDs (Jira-Keys, Excel-Zeilen-IDs, FR-/NFR-Nummern) gehören zur Rückverfolgbarkeit in die Spezifikation.
- Committe oft. Nutze das geklonte Simplifier-Git-Repository als „Source of Truth“ — pushe die Änderungen zurück in den App Editor, wenn die Arbeit erledigt ist.
- Nutze das Spec Kit für alles, was nicht trivial ist. Selbst eine einzige
spec.mdverbessert die Ergebnisse des Agenten drastisch. - Halte MCPs aktuell. Führe
claude mcp listregelmäßig erneut aus, um die Konnektivität zu prüfen.
Fehlerbehebung
| Symptom | Lösung |
|---|---|
claude mcp list zeigt MCP als disconnected |
Führe den Befehl claude mcp add erneut aus; prüfe Netzwerk/Proxy |
| Simplifier MCP zeigt Auth-/401-Fehler | Dein SIMPLIFIER_TOKEN ist nach dem erneuten Login abgelaufen → claude mcp remove simplifier und mit dem neuen Token wieder hinzufügen |
| Simplifier MCP öffnet beim Start eine Fehlerseite im Browser | Lies die Seite — sie beschreibt das Verbindungsproblem (falsche URL, ungültiger Token, Netzwerk) und wie es behoben werden kann |
| Agent kennt die Simplifier-APIs nicht | Prüfe, ob simplifier im aktuellen Projektordner hinzugefügt ist, nicht global |
| Agent bearbeitet Dateien im Plan Mode | Du bist nicht im Plan Mode — drücke Shift+Tab, bis die untere Leiste plan mode on anzeigt |
| Opus 4.5 zu langsam / zu teuer für kleine Änderungen | Wechsle mit /model claude-sonnet-5 zu Sonnet 4.5, nachdem der Plan feststeht |
| Playwright MCP kann den Browser nicht starten | Führe npx playwright install einmalig aus, um die Browser-Binärdateien zu installieren |
specify: command not found |
Installiere über uv tool install specify-cli --from git+https://github.com/github/spec-kit.git (oder pipx) |
/speckit.*-Befehle in Claude Code nicht sichtbar |
Führe specify init . --integration claude im Projektordner erneut aus, dann starte Claude Code neu |
| Excel/PDF-Anforderungen werden vom Agenten ignoriert | Lege die Dateien in docs/ ab und referenziere den Pfad explizit in deinem Prompt (z. B. docs/UserStories.xlsx) |
