Lokale Instanzen

Nutzen Sie einen eigenen Klon zur Erprobung mit Node.js 24, pnpm 10.28.0, Git, Supabase CLI und laufendem Docker-Daemon.

Beginnen Sie mit dem Installationsassistenten. Dieser Artikel bietet technische Details und zusätzliche Prüfungen.

Installation starten

Eine lokale Instanz aus der Desktop-App starten

Nutzen Sie einen eigenen Klon zur Erprobung mit Node.js 24, pnpm 10.28.0, Git, Supabase CLI und laufendem Docker-Daemon. Planen Sie mindestens 4 GB freien RAM, zwei CPU-Kerne und 10 GB freien SSD-Speicher ein; empfohlen sind 8 GB, vier Kerne und 20 GB. Installieren Sie zuerst die signierte Desktop-App von der Downloadseite. Windows verwendet den Microsoft Store; macOS und Linux haben eigene Downloads. Wählen Sie im Klon die zu erprobende Version, bevor Sie Abhängigkeiten installieren.

Bash

git clone https://github.com/mangue-dev/minddy.git
cd minddy
git checkout v0.20.0
corepack enable
corepack prepare pnpm@10.28.0 --activate
pnpm install --frozen-lockfile

Desktop-App wählt den Klon

Loopback-Anwendung: Port 6463

Minimales Supabase und dauerhafte Daten

Beenden stoppt App und Backend

Die Desktop-App steuert die lokalen Dienste des gewählten Klons, während ihre Daten dauerhaft gespeichert bleiben.

Wählen Sie die persönliche Installation, wenn die Desktop-App die lokalen Dienste verwalten soll.

Neue lokale Installationen verschlüsseln Inhalte des Arbeitsbereichs standardmäßig. Um eine ausdrückliche Wahl festzuhalten, führen Sie im Klon pnpm bootstrap:supabase -- --minimal --app-url http://localhost:6463 --encryption enabled (oder --encryption disabled) aus, bevor Sie ihn in der App öffnen; spätere Starts behalten die gespeicherte Wahl bei. Siehe Arbeitsbereichsverschlüsselung.

Lokale Dienste durch die App steuern

Öffnen Sie das native Menü minddy. Unter Windows und Linux blendet Alt die Menüleiste ein; macOS verwendet die globale Menüleiste. Öffnen Sie den Serververbindungsdialog, wählen Sie dort die lokale Instanz und den Stammordner des Klons. Die App startet self-host:local --no-open, bereitet minimales Supabase vor, führt Migrationen und Storage-Konfiguration aus, erstellt bei Bedarf den Build und wartet auf /api/health, bevor sie die Registrierung öffnet. Sie lauscht ausschließlich auf Loopback-Port 6463, merkt sich den Ordner und steuert Start und Beenden beider Dienste.

MCP-Verfügbarkeit und Netzwerkzugriff

MCP ist in selbst gehostetem minddy enthalten und startet mit der Anwendung. Es funktioniert sofort unter /api/mcp an der mit MINDDY_PUBLIC_APP_URL konfigurierten Instanzadresse. OAuth-Erkennung und dynamische Client-Registrierung sind enthalten: Ein separater MCP-Server, eine eigene OAuth-Anwendung oder ein minddy-Cloud-Proxy ist nicht erforderlich. Verbinden Sie Ihren MCP-Client mit dem Endpunkt Ihrer Instanz, melden Sie sich an und erteilen Sie den Zugriff im Browser.

Die Verfügbarkeit des Dienstes garantiert keine Erreichbarkeit im Netzwerk. Sowohl der MCP-Client als auch der Browser für die Autorisierung müssen die bekannt gegebenen MCP- und OAuth-URLs erreichen können. Wenn Sie OAUTH_ISSUER ausdrücklich überschreiben, muss auch diese Adresse erreichbar sein. Der Client muss die Verbindung, den OAuth-Ablauf und den gewählten Netzwerkweg unterstützen; manche Clients verlangen auch in privaten Netzwerken HTTPS.

Dieses von der Desktop-App verwaltete Profil bindet nur an die Loopback-Schnittstelle. Ein kompatibler MCP-Client auf demselben Computer kann http://localhost:6463/api/mcp verwenden; localhost und 127.0.0.1 bezeichnen den Computer, der die Verbindung aufbaut. Ein anderer Computer oder ein gehosteter Cloud-Agent kann dieses Profil nicht direkt erreichen. Nutzen Sie für LAN/VPN-Zugriff eine Serverinstallation mit erreichbarer konfigurierter Adresse, etwa http://192.168.1.50, und erlauben Sie den Anwendungsport über Bindungsadresse, Firewall und Routing. Außerhalb dieses Netzwerks benötigt der Client eine erreichbare HTTPS-Adresse wie https://tickets.example.com oder einen anderen unterstützten Netzwerkweg. Eine lokale Installation ermöglicht nicht automatisch den Zugriff aus dem Internet.

Lesen Sie die Hinweise zum MCP-Netzwerkzugriff, bevor Sie einen entfernten Client verbinden.

Fehler beheben

Wenn Sie ein Fenster schließen, läuft die Desktop-App weiter; verwenden Sie den Befehl zum Beenden der Anwendung, um auch die lokalen Dienste zu stoppen. Prüfen Sie Docker, CLI, freien Speicher und andere Prozesse auf Port 6463. pnpm self-host:local ist eine Diagnosealternative im Terminal. Beenden Sie sie mit Strg+C, bevor die App übernimmt; sie beansprucht keinen fremden Prozess. Beim Beenden der App stoppt normalerweise auch Supabase. --keep-backend ändert dies ausdrücklich. Verwenden Sie supabase db reset --local niemals zur Wiederherstellung: Es löscht Erprobungsdaten. Prüfen Sie neues Konto, Projekt, Ticket und Anhang, bevor Sie sich auf die Instanz verlassen.