Markdown

Für Entwickler

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.

Auf dieser Seite

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

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.

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.

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