SETUP – Moran Fleet Control in 10 Minuten

Diese Installation ist ein Clean-Room: kein Founder-Kontext, keine Schlüssel, kein personenbezogener Zustand. Alles entsteht auf deinem Rechner.

1. Voraussetzungen

Node.js 22+ (empfohlen 25) und npm 10+
Für die Desktop-App: Rust (https://rustup.rs) + je Plattform die Tauri-Abhängigkeiten

(Windows: WebView2 ist vorinstalliert · macOS: Xcode-CLI · Linux: webkit2gtk-4.0)

Optional: Vercel-CLI (npm i -g vercel) für Deployments

2. Installation

./setup.sh          # Linux/macOS (Windows: siehe unten)
npm run init        # interaktiver Wizard: Marke, Stripe-Link, Token, Kanäle

Windows (PowerShell): npm install --prefix web, npm install --prefix bridge, npm install --prefix mobil, dann npm run init.

Der Wizard legt an:

.env.local (gitignoriert) – deine Schlüssel und dein Kauflink
memory/ – dein frisches Gedächtnis (Vorlagen ohne Founder-Daten)

3. Schlüssel eintragen

.env.local ist die einzige Konfigurations-Schnittstelle (Vorlage: .env.example). Ohne LLM-Schlüssel antworten Chat und Supervisor als **gekennzeichnete Simulation** – nichts läuft versteckt gegen Kosten.

| Variable | Wofür | |---|---| | NEXT_PUBLIC_ANBIETER / NEXT_PUBLIC_ANSCHRIFT_ZEILE1-3 / NEXT_PUBLIC_KONTAKT_MAIL | Impressum/Datenschutz (Anbieter + ladungsfähige Anschrift; ohne sie zeigt das Impressum ehrlich „noch nicht konfiguriert“) | | NEXT_PUBLIC_STRIPE_KAUFLINK | Stripe-Kauflink (Produkt anlegen, dann hier eintragen) | | MFC_API_TOKEN | Zugang für die öffentliche Web-Fassung (Kostenschutz) | | ANTHROPIC_API_KEY / DEEPSEEK_API_KEY / … | LLM-Anbieter | | REDDIT_* / PRODUCTHUNT_TOKEN | Syndikation (Rate-Limits sind fest eingebaut) |

4. Starten

npm run dev:web        # Dashboard: http://localhost:3000
npm run build:tauri    # Desktop-App bauen (Installer im target-Ordner)
cd bridge && npm start # Bridge-Relay für die Companion-App (Port 4871)

5. Server-Modus (Docker, Selfhost)

MFC kann wie ein Server laufen – auf einem eigenen Rechner oder VPS (Docker/ Coolify, siehe docker/README.md). Dann läuft die autonome Schleife dauerhaft (kein offener Browser nötig) und der Agent führt Aufträge über die Claude-CLI im Image aus.

export MFC_API_TOKEN="ein-langer-zufallswert"   # Pflicht – ohne startet Compose nicht
export ANTHROPIC_API_KEY="sk-ant-..."            # Claude-CLI-Auth (alternativ CLAUDE_CODE_OAUTH_TOKEN)
docker compose up --build

Danach ist MFC unter http://localhost:3000 erreichbar. Der Client sendet den Zugang als Header X-MFC-Token (Schreib-/Ausführ-APIs, sonst 403).

Autonomie einschalten: Dashboard → Einstellungen → „Autonome Schleife“ → „Autonom weiterarbeiten“ an.
Projekte liegen auf dem Server im Datenverzeichnis /data/<projekt> (nicht in ~/Documents).
Der Wecker (60 s) hält die Schleife im Server-Prozess am Laufen; zusätzlich stößt POST /api/wake einen Durchlauf an.
Fail-closed: ohne MFC_API_TOKEN startet Compose gar nicht; ohne Claude-Auth bleibt der Agent ehrlich stehen statt unbefugt zu laufen.

6. Companion koppeln (kostenlose Begleit-App)

1. Dashboard → Mobil → „Paarung erzeugen“ 2. Code + Geheimnis in der Companion-App eingeben (Store-Text: mobil/STORE-COMPANION.md) 3. Nachrichten aus MFC erscheinen als Benachrichtigung auf dem Handy

7. Verkaufen

Stripe-Produkt (einmalig oder Abo) anlegen → Link in .env.local → Kaufknopf erscheint automatisch
Rechtstexte (Impressum/Datenschutz/AGB/Widerruf) auf deine Daten prüfen lassen
Distributions-Build: npm run prepare-dist erzeugt dist/ ohne jeden Founder-Zustand
npm run geheimnisse beweist: keine Schlüssel im Quelltext

8. Wartung

npm test               # alle Test-Suiten (Web, Bridge, Companion)
npm run storeprep      # Store-Bericht mit Test-, Build- und Icon-Nachweis
npm run backlog        # BACKLOG-STAND.md aus dem Gedächtnis