# CLI und Agent-Plugin

Die mp CLI ist der Zugang zu MainPath aus dem Terminal, und das Agent-Plugin gibt Cursor, Claude Code und Codex dieselben Funktionen als MCP-Werkzeuge.

> Source: https://www.mainpath.ai/de/docs/cli-and-agent-plugin/

## mp CLI installieren und anmelden

Ein Skript installiert die aktuelle Version nach `~/.local/bin` (Windows: `%LOCALAPPDATA%\ap-cli`) und trägt den Ordner in den PATH ein; die [MainPath Toolbox]({{< relref "/downloads" >}}) bringt die CLI ebenfalls mit, Remote-Workspaces haben sie vorinstalliert.

```bash
# macOS und Linux
curl -fsSL https://www.application-platform.com/install.sh | sh
# Windows (PowerShell)
irm https://www.application-platform.com/install.ps1 | iex
```

Das Skript versteht `--dir`, `--version` und `--no-modify-path` (hinter `sh -s --`); die manuellen Binaries liegen auf der Downloads-Seite. Danach im neuen Terminal:

```bash
mp login             # öffnet den Browser zur Anmeldung
mp whoami            # zeigt Benutzer und Organisation
mp doctor            # prüft, ob Git, Docker, Runtimes und Co. vorhanden sind
mp cli-update check  # prüft auf eine neue CLI-Version
```

`mp cli-update update-now` installiert eine neue Version, `mp logout` löscht die gespeicherte Sitzung, und die Befehle für die Arbeit im Repository stehen unter [Lokal entwickeln]({{< relref "local-development" >}}).

## Agent-Plugin installieren

Skills, Regeln und MCP liegen in der mp CLI, nicht in einem npm-Paket. Nach der CLI-Installation (oder jederzeit später):

```bash
mp agent install
mp login
```

`mp login`, `mp doctor` und `mp cli-update update-now` führen `agent install` mit aus. Die CLI kopiert das Plugin nach `~/.cursor/plugins/local/application-platform` (und zu Claude/Codex, falls vorhanden), legt die Skills unter `~/.cursor/skills`, `~/.claude/skills` und `~/.codex/skills` ab und schreibt den **absoluten Pfad** zu `mp` in die Benutzer-MCP-Datei, damit GUI-Editoren die CLI finden. Danach den Editor neu laden. Schritt für Schritt: [Mit einem KI-Agenten arbeiten]({{< relref "work-with-ai-agents" >}}).

Das Plugin enthält die Skills `setup-and-login`, `create-project`, `import-existing-project`, `run-local`, `git-and-pipelines` und `report-blocker`, passende Slash-Commands, eine Cursor-Rule mit den Plattform-Konventionen und den MCP-Server `application-platform` (`mp mcp serve`). Ein manueller Eintrag in `~/.cursor/mcp.json` braucht denselben absoluten `command`-Pfad, den `mp agent install` setzt — nicht nur `mp` oder `ap` ohne Pfad.

## Die MCP-Werkzeuge

Löschende Werkzeuge verlangen `confirm=true`, und Statusmeldungen zeigen keine internen Infrastrukturbegriffe.

| Bereich | Werkzeuge |
|---|---|
| Identität und Status | `platform_whoami`, `platform_watch`, `platform_status` |
| Organisationen | `platform_organizations_*` mit list, get, create, update, invite und Mitgliederverwaltung |
| Projekte | `platform_projects_*` mit list, get, create, update, delete, demo_json, clone, import_local, status, import_android_keystore und load_tests |
| Server | `platform_servers_*` mit list, get, create, update, delete, monitoring und firewall |
| Netzwerk-Tunnel | `platform_tunnels_*` mit list, get, create, update, delete, test und reconnect; `platform_tunnels_test` kann optional `destHost`/`destPort` setzen; Zuweisung über `configuration.tunnelId` am Server |
| Zugangsdaten | `platform_credentials_create` für Webspace, SMTP, App Store, Play Store, Hetzner und Hostinger sowie `platform_credentials_sentry_projects` |
| Pipelines und Blocker | `platform_pipelines_list`, `platform_pipelines_get`, `platform_pipelines_wait`, `platform_pipelines_job_log`, `platform_agent_report` |
| Workspaces, Rechner, Compliance | `platform_workspaces_*`, `platform_computers_*`, `platform_compliance_*` |

Die Aufrufreihenfolge bei Import und Projektanlage steht unter [Bestehendes Repository importieren]({{< relref "agent-project-import" >}}) und [Neues Projekt anlegen]({{< relref "create-project" >}}).

## Wenn der Agent nicht weiterkommt

Meldet ein Werkzeug `not logged in` oder `session expired`, führst du `mp login` aus und prüfst mit `mp whoami`. Fehlt `mp` im PATH, installierst du die CLI und lädst den Editor neu. Fehlt der Server `application-platform` im Client, fehlt meist `mp agent install` oder der Neustart des Fensters.

Cloud-Agenten ohne lokales `mp` können das stdio-MCP nicht nutzen; Import und Projektanlage brauchen einen lokal laufenden Agenten. Schlägt Create, Import oder Watch fehl, gilt diese Fehlermeldung; der Agent umgeht sie nicht mit einem eigenen `git clone` oder `git remote add`. Nach einem Push wartet der Agent mit `platform_pipelines_wait` auf **diesen** Commit. Kommt er bei Plattform-Fehlern nicht weiter, ruft er `platform_agent_report` auf.