Files
HiveGrid-Wireframes/03 Quellen und Referenzen/hivegrid-website/MCP-SUBPAGE-CONTENT.md
T

8.2 KiB
Raw Blame History

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