8.2 KiB
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.debewusst 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):
- „Zeig mir alle offenen Angebote über 10.000 €." Deine KI durchsucht deine Projekte und Pipelines — in Sekunden.
- „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.
- „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)
- Verbinden Ein Klick in deinem KI-Client, Anmeldung über HiveGrid (OAuth). In Minuten verbunden — kein Kopieren von Schlüsseln, kein Techniker nötig.
- 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).
- 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