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

> Source: https://www.mainpath.ai/de/docs/import-existing-project/

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](https://app.application-platform.com/register) mit einer Organisation, siehe [Dein erstes Projekt anlegen]({{< relref "getting-started" >}}).
- 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]({{< relref "/downloads" >}}) 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

```bash
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:

{{< agent-import-prompt >}}

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]({{< relref "get-help" >}}).

## 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]({{< relref "/feedback" >}}).

Den CLI-Befehl `mp platform projects import-local` für Entwickler beschreibt [Bestehendes Repository importieren]({{< relref "agent-project-import" >}}).

Weiter geht es mit [Rechner einrichten oder im Browser arbeiten]({{< relref "setup-your-computer" >}}).