Markdown

Für Einsteiger

Mit einem KI-Agenten arbeiten

Claude Code, Cursor und Codex kennen die Regeln von MainPath und sprechen über das Agent-Plugin direkt mit der Plattform.

Auf dieser Seite

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.mainpath.ai/install.sh | sh
mp agent install
mp login

Unter Windows in PowerShell: irm https://www.mainpath.ai/install.ps1 | iex. Der Befehl heißt dort mainpath, weil mp in PowerShell schon ein Alias ist. mainpath login, mainpath 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 zur Programmdatei 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-local aus.

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.

Danke für deine Anfrage

Wir haben deine Anfrage erhalten und melden uns schnellstmöglich bei dir.

Du möchtest direkt mit uns sprechen?

Buche hier einen passenden Termin für ein Erstgespräch mit Robin.

Kalender in einem neuen Tab öffnen