# MCP-Subpage — Content-Deck (Entwurf) Copy-Grundlage für die geplante MCP-Subpage (eigener Nav-Punkt). Basiert auf dem Produkt-Repo `HiveGrid-Cloud` (`apps/mcp`, Tickets `VR-MCP`/`VD-MCP`, Entscheidung `AD-26`, Vertriebs-Doc `PRODUKTFEATURES.md`). **Framing (Annahme, mit Dejan zu bestätigen):** - **Status:** „In Kürze / Early Access" — Feature voll zeigen, aber ehrlich als kommend markieren. Grund: Prod-Rollout auf `mcp.hivegrid.de` bewusst noch offen; interne Vertriebsregel = „als Pilot zeigen, nicht als sofort produktiv zusagen". - **Zielgruppe:** Hybrid — oben Nutzen für den SHK-Betrieb, unten technischer Vertrauensblock. - **Voice:** Du (wie Rest der Website). **Route:** `/mcp` (oder `/ki-anbindung`) · **Nav-Label:** „KI-Anbindung" oder „MCP" → Naming noch offen (siehe unten). --- ## Section 1 · Hero **Badge:** `In Kürze` (Amber-Pill, wie Pricing-Buttons-Farbwelt) **Headline:** > Deine KI. Dein Betrieb. Endlich verbunden. **Alt-Headlines (zur Auswahl):** - Bring deine eigene KI mit. - HiveGrid spricht jetzt mit deiner KI. - Verknüpfen statt ersetzen — auch bei KI. **Subline:** > Verbinde Claude, ChatGPT oder Cursor direkt mit HiveGrid. Deine KI liest > Aufträge, Kontakte und Projekte und erledigt Aufgaben für dich — sicher, > DSGVO-konform und nur mit den Rechten, die du vergibst. **CTA primär:** `Früh dabei sein` (führt zu Demo/Kontakt mit Interesse-Vermerk) **CTA sekundär:** `Wie es funktioniert` (Anchor nach unten) --- ## Section 2 · Das Prinzip (Nutzen, kein Tech) **Kicker:** Verknüpfen statt ersetzen **Text:** > Du nutzt vielleicht schon eine KI — Claude, ChatGPT oder etwas anderes. > HiveGrid ersetzt sie nicht. Es gibt ihr einen sicheren Zugang zu deinem Betrieb. > > **Die KI läuft weiterhin bei dir bzw. deinem Anbieter — HiveGrid liefert nur > die Daten und führt die Aktionen aus, die du freigibst.** Kein zusätzliches > KI-Abo bei uns, kein Daten-Umzug, kein Lock-in. **3 Nutzen-Kacheln (Alltagsbeispiele):** 1. **„Zeig mir alle offenen Angebote über 10.000 €."** Deine KI durchsucht deine Projekte und Pipelines — in Sekunden. 2. **„Leg einen Lead für Familie Meyer an und häng die Notiz vom Telefonat dran."** Deine KI erstellt Lead und Aktivität — mit deiner Bestätigung. 3. **„Verschieb das Projekt Bad-Sanierung in die Phase ‚Angebot raus'."** Deine KI bewegt das Projekt in der Pipeline — sauber protokolliert. --- ## Section 3 · So funktioniert es (3 Schritte) 1. **Verbinden** Ein Klick in deinem KI-Client, Anmeldung über HiveGrid (OAuth). In Minuten verbunden — kein Kopieren von Schlüsseln, kein Techniker nötig. 2. **Freigeben** Du entscheidest, was die KI darf: Presets von „Nur lesen" bis „Lesen + schreiben", oder feingranular je Bereich (Leads, Kontakte, Projekte, Pipelines, Aktivitäten, Aufgaben). 3. **Nutzen** Sprich mit deiner KI wie gewohnt. Sie liest aus HiveGrid und handelt darin — jede Schreibaktion nur mit Bestätigung und im Audit-Protokoll. --- ## Section 4 · Was deine KI kann (Tool-Fläche) **Einleitung:** 15 abgesicherte Werkzeuge über sechs Bereiche deines Betriebs. **Lesen (10):** - **Leads** — suchen & Details abrufen - **Kontakte** — Privatpersonen & Organisationen suchen & abrufen - **Projekte** — nach Nummer, Titel, Pipeline, Phase, Verantwortlichem finden - **Pipelines** — Pipelines und aktive Phasen auflisten - **Aktivitäten** — Verlauf zu Kontakt, Projekt, Lead, Aufgabe - **Aufgaben** — nach Status, Priorität, Zuständigem, Frist suchen & abrufen **Handeln (5 — je mit ausdrücklicher Bestätigung):** - **Lead anlegen** - **Projekt in andere Phase verschieben** - **Aktivität / Notiz hinzufügen** - **Aufgabe anlegen** (zugewiesen & verknüpft) - **Aufgaben-Status ändern** > Jede schreibende Aktion verlangt eine Bestätigung und landet automatisch im > Audit-Protokoll und im Aktivitätenverlauf — nachvollziehbar, wer/welche KI > wann was getan hat. --- ## Section 5 · Kompatible KI-Clients Logos + Labels (Honeycomb-Style wie Integrations-Feld denkbar): - **Claude** (Desktop / Code) - **ChatGPT** - **Cursor** - **VS Code** / weitere MCP-fähige Clients **Untertext:** > HiveGrid nutzt den offenen Standard **MCP (Model Context Protocol)** — jeder > MCP-fähige KI-Client kann sich verbinden. Kein proprietärer Lock-in. --- ## Section 6 · Sicherheit & DSGVO (Vertrauensblock) **Kicker:** Sicherheit ist kein Zusatz, sondern die Grundlage. | Punkt | Aussage | |---|---| | **Mandantentrennung** | Deine KI sieht ausschließlich die Daten deines Betriebs — technisch erzwungen über das Login-Token, nicht über KI-Eingaben. Zweite Absicherung direkt in der Datenbank (RLS). | | **Du vergibst die Rechte** | Feingranulare Freigaben je Bereich, jederzeit widerrufbar. Nichts passiert ohne deine Zustimmung. | | **Bestätigung bei Aktionen** | Schreibende Aktionen brauchen ein explizites „Ja". | | **Vollständiges Audit** | Jeder KI-Zugriff wird protokolliert (wer, welcher Client, welches Tool, wann). | | **Sichere Anmeldung** | OAuth 2.1 mit kurzlebigen Tokens und Widerruf — keine dauerhaften Schlüssel im KI-Client. | | **Missbrauchsschutz** | Rate-Limits pro Betrieb, begrenzte Ausgabemengen. | | **Deine Daten sind Daten** | HiveGrid behandelt Kundendaten nie als Anweisungen an die KI (Schutz vor Prompt-Injection). | | **Hosting in Deutschland** | DSGVO-konform, Serverstandort DE. | --- ## Section 7 · Klare Grenzen (Ehrlichkeit / Erwartungsmanagement) **Kicker:** Was HiveGrid bewusst NICHT ist - **Kein eingebauter Chatbot.** HiveGrid ist kein KI-Assistent — du bringst deinen mit. - **Kein autonomer Agent.** Die KI handelt nur auf deine Anweisung, mit deinen Rechten. - **Keine eigene KI/Transkription.** Die Rechenleistung (Inferenz) liegt bei deinem KI-Client, nicht bei HiveGrid — dadurch kein zusätzliches KI-Abo, keine Daten, die zwangsweise durch fremde Modelle laufen. > Wir bauen keine weitere KI-Blackbox. Wir öffnen deinen Betrieb sicher für die > KI, der du bereits vertraust. --- ## Section 8 · Technischer Steckbrief (Dev-Block, unten) Für IT-affine Entscheider / Integratoren — kompakter Fakten-Block: - **Protokoll:** Model Context Protocol (MCP), offizielles `@modelcontextprotocol/sdk` - **Transport:** Streamable HTTP (stateless) - **Endpoint:** `https://mcp.hivegrid.de` (eigener Dienst, getrennt von App & Public-API) - **Auth:** OAuth 2.1 Authorization Code + PKCE · Protected-Resource-Metadata (RFC 9728) · Authorization-Server-Metadata (RFC 8414) · Resource/Audience-Bindung · Consent · kurzlebige Access-Tokens + rotierende Refresh-Tokens + Widerruf · API-Key-Bearer als Fallback/Operator-Pfad - **Tools:** 15 (10 Read / 5 Write), Zod-validiert, Cursor-Pagination - **Scopes:** Presets `mcp:read` / `mcp:write` + granular je Domäne (`mcp:lead:read`, `mcp:lead:create`, `mcp:contact:read`, `mcp:project:read/write`, `mcp:pipeline:read`, `mcp:activity:read/write`, `mcp:task:read/write`) - **Isolation:** Tenant aus dem Token → `withTenantScope()` + Row-Level-Security - **Governance:** `withPermission()`-Guards, Client-Confirmation für Writes, Audit-Event + Aktivitätslog pro Aktion, Rate-Limits, Output-Truncation, Prompt-Injection-Härtung --- ## Section 9 · Abschluss-CTA **Headline:** Sei früh dabei. **Text:** Die KI-Anbindung ist aktuell im Pilot. Sag uns Bescheid, wenn dein Betrieb sie als Erster nutzen soll. **CTA:** `Early Access anfragen` / `Demo buchen` --- ## Offene Punkte / Entscheidungen - [ ] **Framing bestätigen:** „In Kürze/Early Access" vs. live vs. vage (aktuell: Early Access) - [ ] **Naming/Route:** `/mcp` + Nav „MCP" (klar, aber technisch) vs. `/ki-anbindung` + Nav „KI-Anbindung" (verständlicher). Empfehlung: **Nav „KI-Anbindung", Route `/ki-anbindung`**, MCP als Begriff erst im Fließtext erklären. - [ ] **Headline final** (siehe Alternativen Section 1) - [ ] **Client-Logos** beschaffen (Claude/ChatGPT/Cursor/VS Code) — analog Honeycomb-Tool-Logos - [ ] **Verhältnis zum Honeycomb-Integrationsfeld** klären: eigene Seite + Verweis aus dem Honeycomb, oder Honeycomb-Abschnitt verlinkt hierher - [ ] **Text-Review mit Haris** (Teil des großen Text-Reviews) - [ ] **Bauhow & weitere Drittanbieter** — separates Integrations-Thema, hier nur querverweisen