# Schnellstart

In vier Schritten auf MainPath: mp CLI installieren, Agent-Plugin hinzufügen, Projekt importieren oder anlegen, starten und veröffentlichen.

> Source: https://www.mainpath.ai/de/docs/quickstart/

MainPath legt für dein Projekt Repositories, Pipelines und Deployments an. Du brauchst dafür die mp CLI und, wenn du mit Claude Code, Cursor oder Codex arbeitest, das Agent-Plugin.

**Prompt für deinen Agenten**

```text
Richte mich auf MainPath ein: 1. Prüfe mit `mp --version`, ob die mp CLI installiert ist; falls nicht, installiere sie mit `curl -fsSL https://www.application-platform.com/install.sh | sh` (Windows: `irm https://www.application-platform.com/install.ps1 | iex`). 2. Installiere das Agent-Plugin mit `mp agent install` und melde mich mit `mp login` an. 3. Liegt in diesem Ordner schon Code, importiere ihn mit platform_projects_import_local; sonst lege ein neues Projekt an (platform_projects_demo_json, platform_projects_create, platform_watch, platform_projects_clone). 4. Starte die Anwendung mit `mp run-local` und sage mir, wo der Arbeitsordner liegt.
```

## Voraussetzungen

- Ein [Account](https://app.application-platform.com/register) mit einer Organisation

## 1. mp CLI installieren und anmelden

macOS und Linux:

```bash
curl -fsSL https://www.application-platform.com/install.sh | sh
```

Windows (PowerShell):

```powershell
irm https://www.application-platform.com/install.ps1 | iex
```

Das Skript legt `ap` auf deinen PATH; öffne danach ein neues Terminal und melde dich an:

```bash
mp login
```

Wer den Rechner komplett einrichten lassen will (Runtimes, Editoren, Projekte), nimmt stattdessen die [MainPath Toolbox]({{< relref "/downloads" >}}), die die CLI mitbringt.

## 2. Agent-Plugin installieren

```bash
mp agent install
```

Die CLI legt Skills, Regeln und den MCP-Server bei Cursor, Claude Code und Codex ab und schreibt den absoluten Pfad zu `mp` in die Benutzer-MCP-Datei. `mp login` und `mp doctor` führen denselben Schritt mit aus. Danach lädst du den Editor neu. Alle Wege stehen unter [CLI und Agent-Plugin]({{< relref "cli-and-agent-plugin" >}}).

## 3. Projekt importieren oder anlegen

**Bestehender Ordner**: Sag dem Agenten „Importiere dieses Projekt in meinen MainPath-Account.“ oder nutze die CLI im Projektordner:

```bash
mp platform projects import-local . "Mein Projekt"
```

Unterstützt werden Flutter, React Native (Expo), Next.js, natives iOS und Android, Hugo, Astro, NestJS, FastAPI und Laravel. Details: [Bestehendes Repository importieren]({{< relref "agent-project-import" >}}).

**Neues Projekt**: Sag dem Agenten „Lege ein neues Projekt mit einer Next.js-App und einem NestJS-Backend an und klone es.“ oder nutze die CLI:

```bash
mp platform projects demo-json --minimal -o project.json
mp platform projects create --from-json project.json --watch
mp platform projects clone <projekt-slug>
```

Ohne CLI legst du das Projekt im Assistenten unter **Projekte** in der [Web-Oberfläche](https://app.application-platform.com) an. Details: [Neues Projekt anlegen]({{< relref "create-project" >}}).

In beiden Fällen liegt das Projekt danach unter `~/Documents/MainPath/<organisation>/<projekt>/` mit einem Ordner pro Repository.

## 4. Starten und veröffentlichen

```bash
cd ~/Documents/MainPath/<organisation>/<projekt>/<repository>
mp run-local
```

Ein Push auf `main` startet die Pipeline und rollt auf Dev aus; Produktion gibst du in GitLab per Klick frei. Dafür braucht das Projekt einen [Server]({{< relref "servers" >}}) und für die eigene Adresse eine [Domain]({{< relref "domain" >}}). Den Ablauf beschreibt [Git-Workflow und Deployment]({{< relref "git-workflow" >}}).

## Wie es weitergeht

- Neu bei Git, Terminal und Servern: [Was ist MainPath?]({{< relref "what-is-the-platform" >}}) beginnt den Einsteiger-Pfad.
- Erfahren: [Überblick in fünf Minuten]({{< relref "developer-overview" >}}) und [Lokal entwickeln]({{< relref "local-development" >}}).
- Fertige Software wie WordPress oder n8n betreiben: [Docker Apps aus dem Katalog]({{< relref "hosted-apps" >}}).

