@prontosite/mcp 0.9.2 → 0.10.1

package/CHANGELOG.md

@@ -3,6 +3,28 @@
 Alle nennenswerten Änderungen am MCP-Server für ProntoSite. Der Server ist ein dünner Client um die
 ProntoSite Deploy-API; die eigentliche Logik lebt serverseitig.
 
+## 0.10.1 – 2026-10-03
+
+- **Fix:** In der `account_create`-Beschreibung beendeten gerade Anführungszeichen (`"`) innerhalb der
+  deutschen Quotes `„…"` den JS-String vorzeitig → `SyntaxError` beim Start (0.10.0 war nicht ladbar).
+  Alle Tool-Beschreibungen auf typografische `„…“` umgestellt.
+- **Schutz gegen Wiederholung:** `prepublishOnly` (= `npm run check` + `npm run smoke`) prüft vor jedem
+  Publish `node --check index.mjs api.mjs` **und** einen echten Import-Smoke (`smoke.mjs` lädt `index.mjs`
+  komplett – alle `server.tool`-Registrierungen laufen – ohne den stdio-Server zu starten, Dummy-Env).
+  Derselbe Smoke läuft in `npm test` des Hauptprojekts. `index.mjs` startet den Server jetzt nur noch bei
+  Direktausführung (Main-Guard), damit der Import nicht blockiert.
+
+## 0.10.0 – 2026-10-03
+
+- **Neu: `account_create`** (schreibend, nur mit Betreuer-Token: admin/partner/agentur) – legt ein neues
+  Kundenkonto an (Dashboard-Weg „Kunde anlegen"). Mit `email` → eingeladenes Login-Konto (Invite-Mail),
+  ohne `email` → verwaltetes Konto (ohne Login). Partner/Agentur: Konto wird dem Betreuer zugeordnet,
+  Agentur-Kunden erhalten automatisch den Agentur-Plan (`agentur-kunde`/`billing_offline`). Antwort nennt die
+  neue Konto-ID (k-…) + den Hinweis, die erste Website per `site_deploy` mit `site="<k-id>:new"` zu importieren.
+  Schutz: Namens-/E-Mail-Dublette → Warnung mit vorhandener Konto-ID statt Doppelanlage (`override:true`
+  erzwingt die Namensdublette; eine vergebene E-Mail ist nicht erzwingbar), Rate-Limit 10 Konten/Stunde je Token.
+  Die Beschreibung lenkt den Assistenten dorthin, wenn es für einen Kunden noch KEIN Konto gibt (statt `site=new`).
+
 ## 0.9.2 – 2026-10-01
 
 - **Pflicht-Marker in den Tool-Beschreibungen** (`site_deploy`, `site_legal_options`) + README: Rechtsseiten

package/README.md

@@ -82,6 +82,7 @@ sichern: `cp ~/.prontosite.json ~/.prontosite.json.bak`).
 | Tool | Wirkung |
 |------|---------|
 | `sites_list` | Alle erreichbaren Websites (Slug, Plan, letzte Änderung, Publish-Bedarf). **Lesend.** |
+| `account_create({ name, email?, plan?, note?, override? })` | **Nur mit Betreuer-Token.** Legt ein neues Kundenkonto an (Dashboard-Weg „Kunde anlegen"). Mit `email` → eingeladenes Login-Konto (Invite-Mail), ohne → verwaltetes Konto. Partner/Agentur: Konto wird dem Betreuer zugeordnet (Agentur-Kunden automatisch `agentur-kunde`). Antwort nennt die neue Konto-ID (k-…) → danach `site_deploy({ site: "<k-id>:new", zipPath })`. Namens-/E-Mail-Dublette → Warnung mit vorhandener k-ID (`override:true` erzwingt die Namensdublette). **Schreibend.** |
 | `site_status({ site? })` | Plan, Slug, Live-URL, Publish-Bedarf. **Lesend.** |
 | `site_export({ site?, which, outDir })` | ZIP (`published`\|`draft`\|`original`) lokal speichern. **Lesend.** |
 | `site_deploy({ site?, zipPath, publish?, resetOverlay?, legal?, company?, siteOverride? })` | ZIP importieren, optional live; optional Firmendaten im selben Aufruf setzen. Beim lokalen Bauen Bausteine im HTML per `data-ps` markieren (`formular:kontakt`, `impressum`/`datenschutz`, `link-impressum`/`link-datenschutz`) → [Marker-Syntax](https://prontosite.io/docs/marker-shortcodes). **Schreibend.** |
@@ -142,6 +143,11 @@ Admin/Partner-Bereich (Panel „Betreuer-Token"). Config dann einfach:
 zugeordnet ist – keine Config-Pflege). Website je Aufruf per Slug **oder stabiler Site-ID** angeben (kein
 `"active"` – es sind mehrere Konten). Erst-Import: `site_deploy({ site: "new", customer: "k-…" })`.
 
+**Neuen Kunden anlegen** (es gibt noch KEIN Konto): zuerst `account_create({ name, email? })` – das Konto wird
+dem Betreuer zugeordnet (Agentur-Kunden automatisch `agentur-kunde`). Die Antwort nennt die Konto-ID (k-…);
+danach die erste Website per `site_deploy({ site: "<k-id>:new", zipPath })` importieren. Also **nicht** `site=new`
+raten, solange die Konto-ID unbekannt ist – erst `account_create`.
+
 Sicherheit: der Zugriff wird bei JEDEM Aufruf serverseitig geprüft (`assertCanManage` – nur betreute Konten,
 Rollenentzug wirkt sofort); nur Deploy/Status/Export/Veröffentlichen, kein Konto-/Zahlungszugriff; optionaler
 Ablauf (Default 90 Tage) und optionale IP-Bindung; Widerruf sperrt alle betreuten Sites auf einmal.

package/api.mjs

@@ -159,6 +159,22 @@ export async function apiDeploy(cfg, { site, customer = null, slug: wishSlug = n
   return out;
 }
 
+/** POST /api/account – Kundenkonto per BETREUER-Token anlegen (Dashboard-Weg „Kunde anlegen"). Mit email →
+ *  eingeladenes Login-Konto (Invite-Mail), ohne email → verwaltetes Konto (ohne Login). Nutzt das Top-Level-
+ *  Betreuer-Token (nicht die sites-Map – ein Betreuer-Token gilt konto-übergreifend). */
+export async function apiAccountCreate(cfg, { name, email = null, plan = null, note = null, override = false } = {}, fetchImpl = fetch) {
+  if (!name || !String(name).trim()) throw new Error("name ist Pflicht (Anzeigename des Kunden).");
+  const token = needToken(cfg.token, "Betreuer-Token");
+  const body = { name: String(name).trim() };
+  if (email) body.email = String(email).trim();
+  if (plan) body.plan = String(plan).trim();
+  if (note) body.note = String(note).trim();
+  if (override === true) body.override = true;
+  const res = await fetchImpl(`${baseUrl(cfg)}/account`, {
+    method: "POST", headers: { ...authHeaders(token), "content-type": "application/json" }, body: JSON.stringify(body) });
+  return asJson(res);
+}
+
 /** POST /api/publish/<site> – erneut veröffentlichen (ohne ZIP). force=true = „trotzdem veröffentlichen"
  *  (auch ohne erkannte Änderung), analog zum Dashboard-Menüpunkt „Erneut veröffentlichen". */
 export async function apiPublish(cfg, { site, force = false } = {}, fetchImpl = fetch) {

package/index.mjs

@@ -8,16 +8,18 @@
  * Multi-Site (Betreuer): trägt die Config eine `sites`-Map, adressiert jedes Tool per `site`-Parameter die
  * jeweilige Website (eigenes Token je Site). Arbeitsweise: EIN Chat je Kunde. `sites_list` zeigt alle Sites.
  */
+import { fileURLToPath } from "node:url";
+import { realpathSync } from "node:fs";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { z } from "zod";
-import { loadConfig, apiStatus, apiExport, apiDeploy, apiPublish, sitesList, apiCompanyGet, apiCompanySet, apiLegalOptions, apiDomainStatus, apiDomainConnect, apiEmbeds, apiEmbedConsent, apiWidgets, apiWidgetSet } from "./api.mjs";
+import { loadConfig, apiStatus, apiExport, apiDeploy, apiPublish, sitesList, apiAccountCreate, apiCompanyGet, apiCompanySet, apiLegalOptions, apiDomainStatus, apiDomainConnect, apiEmbeds, apiEmbedConsent, apiWidgets, apiWidgetSet } from "./api.mjs";
 
 const cfg = loadConfig();
 // Deutliche Startwarnung bei ambiger Konfiguration (Top-Level-Token NEBEN sites-Map). Nach stderr, damit
 // es im MCP-Log/Terminal auffällt; die endgültige Auflösung (Betreuer-Token-Vorrang vs. Map) klärt sites_list.
 for (const w of (cfg.warnings || [])) process.stderr.write("[prontosite-mcp] ⚠ " + w + "\n");
-const server = new McpServer({ name: "prontosite", version: "0.9.1" });
+const server = new McpServer({ name: "prontosite", version: "0.10.0" });
 const asText = obj => ({ content: [{ type: "text", text: JSON.stringify(obj, null, 2) }] });
 const asError = e => ({ isError: true, content: [{ type: "text", text: "Fehler: " + (e?.message || String(e)) }] });
 const SITE_DESC = "Website-Slug (z. B. 'mas-monti'). Ohne Angabe die Standard-Site der Config. Bei Betreuer-"
@@ -54,6 +56,29 @@ server.tool(
   async () => { try { return asText(await sitesList(cfg)); } catch (e) { return asError(e); } }
 );
 
+server.tool(
+  "account_create",
+  "SCHREIBEND (nur mit Betreuer-Token: admin/partner/agentur): Legt ein NEUES Kundenkonto an – der Dashboard-"
+    + "Weg „Kunde anlegen“. Nutze dieses Tool, BEVOR du eine Website importierst, wenn es für den Kunden noch "
+    + "KEIN Konto gibt (z. B. sites_list zeigt den Kunden nicht, oder der Nutzer sagt „für Kunde X gibt es noch "
+    + "kein Konto“). Erst Konto anlegen, dann mit der zurückgegebenen Konto-ID (k-…) per site_deploy und "
+    + "site=\"<k-id>:new\" die erste Website importieren. Richte KEIN site=new/Erst-Import ein, solange die "
+    + "Konto-ID unbekannt ist – dann zuerst dieses Tool. Mit email wird ein Login-Konto angelegt und eine "
+    + "Einladungs-Mail verschickt; ohne email ein verwaltetes Konto (ohne Login, Betrieb über den Betreuer). "
+    + "Partner/Agentur: das Konto wird DIR zugeordnet; Agentur-Kunden erhalten automatisch den Agentur-Plan "
+    + "(Abrechnung über die Agentur). Schutz: bei gleichem Namen/gleicher E-Mail kommt eine Warnung mit der "
+    + "bereits vorhandenen Konto-ID statt einer Doppelanlage – mit override:true trotzdem anlegen. "
+    + "Bitte VOR dem Aufruf bestätigen lassen (es wird ggf. eine Mail an den Kunden gesendet).",
+  { name: z.string().describe("Pflicht: Anzeigename des Kunden (z. B. Firmenname)."),
+    email: z.string().optional().describe("Optional: E-Mail des Kunden. Gesetzt → eingeladenes Login-Konto (Invite-Mail); weggelassen → verwaltetes Konto ohne Login."),
+    plan: z.enum(["free", "agentur-kunde"]).optional().describe("Optional. Standard richtet sich nach dem Betreuer-Konto (Agentur → agentur-kunde, sonst free). Nur angeben, wenn du den Standard bestätigen willst."),
+    note: z.string().optional().describe("Optionale interne Notiz – erscheint im Konto-Verlauf des neuen Kontos."),
+    override: z.boolean().default(false).describe("true = eine Namensdublette-Warnung übergehen und trotzdem ein weiteres Konto anlegen. Eine bereits vergebene E-Mail lässt sich NICHT erzwingen.") },
+  async ({ name, email, plan, note, override }) => {
+    try { return asText(await apiAccountCreate(cfg, { name, email, plan, note, override })); } catch (e) { return asError(e); }
+  }
+);
+
 server.tool(
   "site_status",
   "Status einer ProntoSite-Website: Plan, Slug, Live-URL, letzte Änderungen und offener Veröffentlichungs"
@@ -248,5 +273,13 @@ server.tool(
   }
 );
 
-const transport = new StdioServerTransport();
-await server.connect(transport);
+// Den stdio-Server NUR starten, wenn diese Datei direkt ausgeführt wird (als MCP-Server / bin).
+// Beim bloßen Importieren (Smoke-Test / Tests) NICHT verbinden – sonst würde der Import auf stdin blockieren.
+// So lädt der Import die Datei komplett (inkl. aller server.tool-Registrierungen → fängt Syntax-/Beschreibungs-
+// fehler) ohne den Server zu starten.
+let isMain = false;
+try { isMain = !!process.argv[1] && realpathSync(process.argv[1]) === fileURLToPath(import.meta.url); } catch { /* argv[1] fehlt (node -e) → kein Main */ }
+if (isMain) {
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+}

package/package.json

@@ -1,12 +1,17 @@
 {
   "name": "@prontosite/mcp",
-  "version": "0.9.2",
+  "version": "0.10.1",
   "description": "MCP-Server für ProntoSite – Website-Status, Export, Deploy und Veröffentlichen direkt aus einem KI-Assistenten (Claude Desktop). Dünner Client um die ProntoSite Deploy-API.",
   "type": "module",
   "bin": {
     "prontosite-mcp": "index.mjs"
   },
   "main": "index.mjs",
+  "scripts": {
+    "check": "node --check index.mjs && node --check api.mjs",
+    "smoke": "node smoke.mjs",
+    "prepublishOnly": "npm run check && npm run smoke"
+  },
   "files": [
     "index.mjs",
     "api.mjs",