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 bringt die CLI ebenfalls mit, Remote-Workspaces haben sie vorinstalliert.
# macOS und Linux
curl -fsSL https://www.mainpath.ai/install.sh | sh
# Windows (PowerShell)
irm https://www.mainpath.ai/install.ps1 | iex
Das Skript versteht --dir, --version und --no-modify-path (hinter sh -s --); die manuellen Binaries liegen auf der Downloads-Seite. Unter Windows legt das Skript mainpath.exe ab. In PowerShell ist mp bereits ein Alias, der Befehl dort heißt mainpath. ap funktioniert auf allen Systemen. Danach im neuen Terminal:
mp login # macOS und Linux. Windows: mainpath login
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.
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):
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.
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.
Weitere Coding Agenten verbinden
GitHub Copilot, Gemini CLI, OpenCode, Windsurf, Cline und Antigravity lassen sich über ihren lokalen MCP-Anschluss verbinden. Die automatische Plugin-Installation oben gilt für Cursor, Claude Code und Codex. Bei den weiteren Tools ergänzt du den Server in den MCP-Einstellungen nach der jeweiligen Tool-Dokumentation:
- Transport: lokaler stdio-Server
- Name:
application-platform - Command: der absolute Pfad zu
mp(Windows:mainpath.exe) - Argumente:
["mcp", "serve"]
Melde dich zuerst mit mp login an (Windows: mainpath login). Ermittle den absoluten Pfad mit command -v mp (Windows PowerShell: (Get-Command mainpath).Source), erhalte vorhandene MCP-Einträge und lade den Agenten nach dem Ergänzen neu. Die JSON-Struktur und der Speicherort unterscheiden sich je nach Tool. Diese Verbindung stellt die MCP-Werkzeuge bereit; sie installiert keine toolspezifischen Skills oder Slash-Commands.
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, load_tests und export_email |
| 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 und Neues Projekt anlegen.
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.