Markdown

Für Einsteiger

Bestehendes Projekt übernehmen

Ein Ordner, den du mit Claude Code, Cursor oder Codex gebaut hast, kommt mit einem Prompt auf MainPath, sofern sein Tech-Stack unterstützt wird.

Auf dieser Seite

Eine mit einem KI-Agenten gebaute Anwendung bringt derselbe Agent auf MainPath; ein Hochladen im Browser gibt es nicht.

Was du brauchst

  • Einen Account unter app.application-platform.com/register mit einer Organisation, siehe Dein erstes Projekt anlegen.
  • Die mp CLI. Im Terminal installierst du sie mit curl -fsSL https://www.application-platform.com/install.sh | sh (Windows in PowerShell: irm https://www.application-platform.com/install.ps1 | iex); die MainPath Toolbox bringt sie ebenfalls mit.
  • Claude Code, Cursor oder Codex.
  • Einen unterstützten Tech-Stack, siehe unten.

Ein Terminal öffnen

Die nächsten Befehle gibst du in ein Terminal ein, in Cursor und VS Code über Terminal → Neues Terminal.

Agent-Plugin installieren und anmelden

mp agent install
mp login

Die CLI legt Skills und MCP-Konfiguration bei den installierten Agenten ab und öffnet den Browser für die Anmeldung; danach zeigt mp whoami deinen Account.

Wird mp nicht gefunden, fehlt die CLI; öffnet sich kein Browser, gib mp login erneut ein. Zum Schluss lädst du Cursor über „Fenster neu laden“ neu und startest Claude Code oder Codex neu.

Den Prompt einfügen

Öffne den Projektordner im Agenten, in Cursor über Datei → Ordner öffnen, für Claude Code oder Codex per cd im Terminal und claude oder codex, und füge diesen Prompt ein:

Du holst ein bestehendes lokales Projekt in MainPath.

Voraussetzungen. Sonst sofort abbrechen und sagen, was fehlt:
- MainPath-Account
- MCP-Server "application-platform" verbunden (über die mp CLI angemeldet)

Nur diese Stacks sind erlaubt:
- App: Flutter, React Native (Expo), Next.js, natives iOS, natives Android
- Homepage: Hugo, Astro
- Backend: NestJS, FastAPI, Laravel
- Package nur wenn eindeutig: Dart-Package, Docker-Image, NPM, Go, PyPI, Terraform-Modul/-Provider, VS-Code-Plugin

Steht ein Framework nicht in der Liste (Django, Vue, Express, Symfony, Svelte, Spring, …): STOPP.
Sage klar: "[Name] ist heute nicht im Assistenten (auch wenn es auf der Roadmap steht)."
Keine ähnlichen Stacks vorschlagen, nichts umbiegen.

Nutze das MCP-Werkzeug platform_projects_import_local mit dem Pfad dieses Ordners und einem Projektnamen. Es legt das Projekt an, wartet bis das Setup fertig ist, klont die Repositories in den Workspace, übernimmt die lokalen Dateien und pusht auf main.
Fehlt das Werkzeug: platform_projects_demo_json, platform_projects_create, platform_watch, platform_projects_clone, danach die Dateien übernehmen und pushen.
Wenn Anlegen, Import oder Warten fehlschlägt, melde den Fehler. Kein eigenes git clone oder git remote add als Ausweg.
Generierte CI- und Umgebungsdateien nicht überschreiben. Eigene Werte in die custom-Umgebungsdateien.
Keine Secrets committen.

Kürzer geht es mit dem Slash-Command /import-existing-project des Plugins.

Was der Agent tut

Der Agent bestätigt den Pfad, fragt nach dem Projektnamen und ruft platform_projects_import_local auf, das die Tech-Stacks erkennt, das Projekt anlegt, auf Repositories und Pipelines wartet, sie klont, deine Dateien darüberlegt und alles auf main pusht; .gitlab-ci.yml und env/*.generated.env bleiben erhalten.

Ab jetzt arbeitest du in ~/Documents/MainPath/<organisation>/<projekt>/ mit einem Unterordner pro Repository und local-configuration; der alte Ordner ist nicht mit MainPath verbunden.

Meldet der Agent, dass du nicht angemeldet bist oder der MCP-Server fehlt, hilft Wenn etwas nicht klappt.

Wenn dein Stack nicht unterstützt wird

Unterstützt werden Apps mit Flutter, React Native (Expo), Next.js, nativem iOS und nativem Android, Homepages mit Hugo und Astro, Backends mit NestJS, FastAPI und Laravel sowie eindeutige Packages wie npm-Paket, Dart-Package oder Docker-Image.

Bei anderen Frameworks bricht der Agent ab und legt kein Projekt mit einem anderen Stack an; einen fehlenden Stack meldest du über die Feedback-Seite.

Den CLI-Befehl mp platform projects import-local für Entwickler beschreibt Bestehendes Repository importieren.

Weiter geht es mit Rechner einrichten oder im Browser arbeiten.