193 lines
8.2 KiB
Markdown
193 lines
8.2 KiB
Markdown
# 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
|