Files

193 lines
8.2 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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