Bedengan Apps MCP

Der einzige Weg, Apps im Bedengan App Hub (https://apps.wisatabedengan.com) zu veröffentlichen oder zu aktualisieren — über AI-Coding-Tools (z. B. Antigravity), nicht mehr über die Webseite.

Kurz gesagt für den täglichen Gebrauch: Nach der Installation (einmalig, siehe unten) genügt es, die KI zu bitten "bitte lade diesen Ordner als neue App hoch" oder "aktualisiere App X mit dem neuesten Code". Den Rest — Projekt prüfen, Fehlendes korrigieren und dann senden — erledigt sie automatisch. Es gibt keine manuelle Freigabe mehr: Sobald die Prüfung bestanden ist, ist die App sofort live.

Dies ist kein neuer Weg zum VPS. Dieser Server ruft nur dieselbe Hub-API über das eigene Konto-Token auf — er berührt Docker oder den Server nie direkt.

Einmal auf dem Laptop installieren

1. Laden Sie diesen Ordner herunter. Falls Sie mit git clone nicht vertraut sind, klicken Sie einfach auf den grünen Button "Code" → "Download ZIP" auf der GitHub-Seite dieses Repos und entpacken Sie ihn in einen beliebigen Ordner auf Ihrem Laptop (z. B. Documents/bedengan-apps-mcp).

2. Fordern Sie ein API-Token vom Admin an, oder erstellen Sie selbst eines, wenn Sie bereits ein Konto haben: Gehen Sie zu https://apps.wisatabedengan.com → Button "Token API" → Buat / Perbarui Token API. Der angezeigte Code wird nur einmal angezeigt — notieren Sie ihn, bevor Sie das Fenster schließen.

3. Öffnen Sie ein Terminal im entpackten Ordner und führen Sie aus:

npm install
npm run build
npm run init

npm run init fragt nach der Hub-URL (Enter drücken, um die Standard-URL https://apps.wisatabedengan.com zu verwenden) und dem Token aus Schritt 2. Gespeichert wird es in ~/.bedengan-apps/config.json auf Ihrem eigenen Laptop — es wird niemals in ein Projekt gezippt und darf nicht mit anderen geteilt werden.

Related MCP server: Citizen Deployment MCP Server

Mit Antigravity verbinden

Fügen Sie es zu den MCP-Server-Einstellungen von Antigravity hinzu (suchen Sie im Menü nach "MCP Servers"):

{
  "mcpServers": {
    "bedengan-apps": {
      "command": "node",
      "args": ["/path/absolut/ke/folder-hasil-ekstrak/dist/index.js"]
    }
  }
}

Ersetzen Sie den Pfad oben durch den Speicherort von dist/index.js in dem Ordner, in den Sie es entpackt/installiert haben (Schritt 1 oben) — vollständiger Pfad, nicht relativ. Nach dem Speichern Antigravity neu starten — die KI kann jetzt die untenstehenden Tools verwenden.

Was passiert, wenn "diesen Ordner hochladen" angefordert wird

1. Die KI prüft das Projekt (validate_project) — prüft, ob der App-Typ erkannt wird, keine geheimen Dateien (.env, API-Schlüssel) mitgezippt werden und die Struktur vollständig ist.

2. Falls etwas korrigiert werden muss, korrigiert die KI nur diesen Teil im Code und prüft erneut — wiederholt, bis alles sauber ist. Sie müssen nicht eingreifen, außer die KI ist wirklich verwirrt.

3. Nach der Bereinigung wird es tatsächlich gesendet (submit_app für neue Apps, update_app zum Aktualisieren bereits live geschalteter Apps).

4. Niemand muss genehmigen. Innerhalb kurzer Zeit ist die App unter https://<subdomain-pilihan>.apps.wisatabedengan.com erreichbar.

Verfügbare Tools

Wenn das verwendete AI-Coding-Tool "MCP-Prompts" unterstützt, gibt es auch einen gebrauchsfertigen Ablauf namens siapkan_dan_terbitkan, der die Schritte 1-4 oben in einem einzigen Befehl zusammenfasst. Falls nicht unterstützt, kein Problem — die KI kennt die richtige Reihenfolge trotzdem aus den Beschreibungen der einzelnen Tools.

Bei Ablehnung

Ablehnungsmeldungen nennen immer, was behoben werden muss, zum Beispiel:

• "Automatisch abgelehnt -- Hinweis auf mit hochgeladene Geheimnisse: .env-Datei wurde mitgezippt" → .env aus dem gesendeten Projekt entfernen/ausschließen (siehe Abschnitt "Automatisch ausgeschlossene Dateien" unten) und erneut versuchen.

• "App-Typ nicht erkannt" → Meistens liegt die Hauptdatei nicht am erwarteten Ort (z. B. index.html/app.py/package.json nicht im äußersten Ordner) oder es fehlt ein start-Skript. Lassen Sie die KI die Struktur korrigieren: Statische Web-Apps benötigen index.html im Stammverzeichnis, Python benötigt app.py + requirements.txt, Node benötigt package.json mit einem "start"-Skript, das process.env.PORT liest und auf 0.0.0.0 lauscht.

• "Ihr Python/Node-App-Kontingent ist voll" → Löschen Sie zuerst eine alte, nicht mehr verwendete App über das Web-Dashboard und versuchen Sie es dann erneut.

Daten speichern, die erhalten bleiben müssen (Datenbanken, Benutzer-Uploads usw.)

Wenn die App eigene Daten speichert (z. B. Lohnabrechnungsdatenbank, Benutzer-Uploads, Eingabeergebnisse) und diese Daten auch nach einem update_app erhalten bleiben müssen, speichern Sie alles im Ordner ./data/ im Projektstamm (relativ zum Ordner, in dem sich package.json/app.py/index.html befinden). Dieser Ordner ist der einzige Teil der App, der bei einem Update NICHT ersetzt wird — andere Teile (Code, node_modules usw.) werden bei jedem erfolgreichen submit_app/update_app vollständig ersetzt.

Wenn das Projekt beim ersten Hochladen bereits echte Daten im Ordner ./data/ hat (z. B. ein Kollege eine bereits verwendete App von seinem eigenen Laptop überträgt, komplett mit Inhalt) — diese Daten werden mitgenommen und sind von Anfang an auf dem Server vorhanden, kein manuelles Verschieben nötig.

Automatisch ausgeschlossene Dateien beim ZIP-Erstellen

node_modules, .git, __pycache__, .venv/venv, .DS_Store, .next, .cache. Um weitere auszuschließen, erstellen Sie eine Datei .bedenganignore im Stammverzeichnis des Projektordners — ein relativer Ordner-/Dateiname pro Zeile (kein vollständiger Glob wie bei .gitignore, nur der exakte Name).

Wenn das Token leakt

Ziehen Sie es selbst über das Web-Dashboard zurück (Button "Token API" → "Cabut Token API") oder bitten Sie den Admin, es über das Admin-Panel zu widerrufen — Login-Passwort und Websitzungen bleiben unberührt. Neues Token erstellen und npm run init erneut ausführen.