In einem Plattform-Projekt befolgt ein KI-Agent wie Claude Code, Cursor oder Codex die Regeln aus dem Agent-Plugin und spricht über MCP mit MainPath. Öffne ihn immer im übergeordneten Projektordner ~/Documents/MainPath/<organisation>/<projekt>/, damit er alle Repositories sieht.
Das Agent-Plugin installieren
Skills, Regeln und MCP liegen in der mp CLI, nicht in einem npm-Paket. Voraussetzung ist nur die CLI:
curl -fsSL https://www.application-platform.com/install.sh | sh
mp agent install
mp login
Unter Windows in PowerShell: irm https://www.application-platform.com/install.ps1 | iex. mp login, mp doctor und eine CLI-Aktualisierung führen agent install mit aus. Die CLI legt das Plugin bei Cursor, Claude Code und Codex ab und schreibt den absoluten Pfad zu mp in die Benutzer-MCP-Datei. Danach lädst du den Editor neu oder startest den Agenten neu.
Das Plugin bringt die Skills setup-and-login, create-project, import-existing-project, run-local, git-and-pipelines und report-blocker, Slash-Commands wie /create-project sowie den MCP-Server application-platform über mp mcp serve. Details stehen unter CLI und Agent-Plugin.
Worum du den Agenten bitten kannst
- „Importiere dieses Projekt in meinen MainPath-Account.“ Der Agent erkennt den Stack, legt das Projekt an und pusht deinen Code, siehe Bestehendes Projekt übernehmen.
- „Lege ein neues MainPath-Projekt mit einer Next.js-App und einem NestJS-Backend an und klone es.“ Der Agent legt das Projekt aus einer Vorlage an, wartet auf die Einrichtung und klont es.
- „Starte das Backend lokal.“ Der Agent führt im Backend-Repository
mp run-localaus.
Welche Regeln der Agent befolgt
Das Plugin verlangt, Anwendungen mit mp run-local zu starten, .gitlab-ci.yml und env/*.generated.env nie von Hand zu ändern, eigene Werte in env/*.custom.env zu schreiben, keine Geheimnisse zu committen oder auszugeben, im Anwendungs-Repository statt in local-configuration zu arbeiten, Laufzeiten aus .tool-versions zu nehmen und Backend-Uploads unter ./upload abzulegen.
Nach abgeschlossener Arbeit committet und pusht der Agent auf main oder einem Feature-Branch (feat/…, fix/…, chore/…) und wartet mit platform_pipelines_wait auf die Pipeline dieses Commits.
Eigene Regeln ergänzen
Projekt-eigene Regeln, etwa bevorzugte Bibliotheken, gehören in eine AGENTS.md im Anwendungs-Repository, nicht in die von MainPath erzeugte local-configuration. Siehe Eigene Regeln für KI-Agenten.
Grenzen
Der MCP-Server läuft lokal über die mp CLI, deshalb können Cloud-Agenten ihn nicht nutzen; meldet der Agent, dass du nicht angemeldet bist, gib mp login ein. Schlägt das Anlegen oder Importieren fehl, umgeht der Agent den Fehler nicht mit eigenen Git-Befehlen. Kommt er bei Plattform-Fehlern nicht weiter, ruft er platform_agent_report auf.
Änderungen des Agenten sicherst und veröffentlichst du.