# CLI und Agent-Plugin

Die ap CLI ist der Zugang zur Plattform aus dem Terminal, und das Agent-Plugin gibt Cursor, Claude Code und Codex dieselben Funktionen als MCP-Werkzeuge.

> Source: https://www.application-platform.com/de/docs/cli-and-agent-plugin/

## ap 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 [Setup-App]({{< relref "/downloads" >}}) bringt die CLI ebenfalls mit, Remote-Workspaces haben sie vorinstalliert.

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

```bash
ap login             # öffnet den Browser zur Anmeldung
ap whoami            # zeigt Benutzer und Organisation
ap doctor            # prüft, ob Git, Docker, Runtimes und Co. vorhanden sind
ap cli-update check  # prüft auf eine neue CLI-Version
```

`ap cli-update update-now` installiert eine neue Version, `ap logout` löscht die gespeicherte Sitzung, und die Befehle für die Arbeit im Repository stehen unter [Lokal entwickeln]({{< relref "local-development" >}}).

## Agent-Plugin installieren

Das MIT-lizenzierte Plugin unter [doppelt-digital/application-platform-plugin](https://github.com/doppelt-digital/application-platform-plugin) braucht Node.js 18 oder neuer sowie die ap CLI; ein Kommando erkennt die installierten Agent-Tools, legt Skills und MCP-Konfiguration an, startet `ap login` und prüft die Anmeldung mit `ap whoami`:

```bash
npx --yes github:doppelt-digital/application-platform-plugin
```

Wer die Anmeldung getrennt ausführen will, installiert nur das Plugin:

```bash
npx plugins add doppelt-digital/application-platform-plugin -s user -y
ap login
```

Claude Code und Codex haben eigene Marketplaces, und Tools ohne MCP-Unterstützung bekommen nur die Skills:

```bash
# Claude Code
claude plugin marketplace add doppelt-digital/application-platform-plugin
claude plugin install application-platform@application-platform --scope user

# Codex, danach in /plugins installieren
codex plugin marketplace add doppelt-digital/application-platform-plugin

# Nur Skills ohne MCP (OpenCode, Windsurf, Continue)
npx skills add doppelt-digital/application-platform-plugin -g -y
```

In Cursor öffnest du **Customize → Plugins** oder nutzt `npx plugins add` von oben; der Installer legt das Plugin unter `~/.cursor/plugins/local/application-platform` ab, und nach jeder Variante lädst du den Editor neu. Dieselbe Installation Schritt für Schritt steht unter [Mit einem KI-Agenten arbeiten]({{< relref "work-with-ai-agents" >}}).

Das Plugin enthält die Skills `setup-and-login`, `create-project`, `import-existing-project` und `run-local`, die Slash-Commands `/setup-and-login`, `/create-project` und `/import-existing-project`, eine Cursor-Rule mit den Plattform-Konventionen und die MCP-Konfiguration für den Server `application-platform`, der `ap mcp serve` über stdio startet. Für einen eigenen Eintrag in `.cursor/mcp.json` oder `.mcp.json` reicht dieser Block:

```json
{
  "mcpServers": {
    "application-platform": {
      "command": "ap",
      "args": ["mcp", "serve"]
    }
  }
}
```

## 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 und monitoring |
| Zugangsdaten | `platform_credentials_create` für Webspace, SMTP, App Store, Play Store, Hetzner und Hostinger sowie `platform_credentials_sentry_projects` |
| Workspaces, Rechner, Compliance | `platform_workspaces_*`, `platform_computers_*`, `platform_compliance_*` |

Die Aufrufreihenfolge bei Import und Projektanlage steht unter [Bestehendes Repository importieren]({{< relref "agent-project-import" >}}) und [Neues Projekt anlegen]({{< relref "create-project" >}}).

## Wenn der Agent nicht weiterkommt

Meldet ein Werkzeug `not logged in` oder `session expired`, führst du `ap login` aus und prüfst mit `ap whoami`. Fehlt `ap` im PATH, installierst du die CLI und lädst den Editor neu. Fehlt der Server `application-platform` im Client, fehlt meist das Plugin oder der Neustart des Fensters.

Cloud-Agenten ohne lokales `ap` 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`.