# 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.

> Source: https://www.mainpath.ai/de/docs/work-with-ai-agents/

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:

```bash
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]({{< relref "cli-and-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]({{< relref "import-existing-project" >}}).
- „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]({{< relref "ai-instructions" >}}).

## 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]({{< relref "save-and-publish" >}}).