Model Context Protocol (MCP) Integration

Das Model Context Protocol (MCP) ist ein offener Standard von Anthropic, der es großen Sprachmodellen (LLMs), KI-gestützten Entwicklungsumgebungen (wie Cursor, Windsurf) und autonomen Programmieragenten ermöglicht, sicher mit externen Werkzeugen, Datenbanken und Betriebs-APIs zu interagieren.

HashEntry bietet offizielle Streamable-HTTP MCP-Server, mit denen Entwickler und Datenschutzbeauftragte Cookie-Scans automatisieren, Einwilligungs-Banner konfigurieren, Datenschutzrichtlinien entwerfen und DSGVO-Konformitätsstatistiken direkt in natürlicher Sprache abfragen können.

---

Architektur und Zugriffsebenen

HashEntry stellt drei dedizierte MCP-Serverendpunkte bereit, die auf unterschiedliche Sicherheits- und Berechtigungsstufen abgestimmt sind:

Endpunkt	Zugriffsebene	Authentifizierung	Fähigkeiten
https://system.hashentry.com/mcp/public	Öffentlich (Public)	Keine (Anonym)	Durchführung von Website-CMP-Scans, Cookie-Lexikon abfragen, Pakete und Wissensdatenbank einsehen.
https://system.hashentry.com/mcp/tenant	Mandant (Tenant)	Bearer Token (he_mcp_...)	Websites verwalten, Cookie-Audits starten, Banner-Design anpassen, juristische Texte entwerfen und veröffentlichen, Zustimmungsstatistiken analysieren.
https://system.hashentry.com/mcp/reseller	Wiederverkäufer (Reseller)	Bearer Token (he_mcp_...)	Mandantenportfolio verwalten, Unterkonten erstellen, Provisionsguthaben einsehen und Reseller-Supporttickets verwalten.

---

Authentifizierung und Token-Erstellung

Für Tenant- und Reseller-Server muss jeder Aufruf einen persönlichen Zugriffsschlüssel (Personal Access Token — he_mcp_...) enthalten.

Token-Erstellung über das HashEntry Web-Dashboard

1. Melden Sie sich im HashEntry App Dashboard an.
2. Navigieren Sie zu Einstellungen → KI & MCP-Tokens.
3. Klicken Sie auf Neues MCP-Token erstellen, geben Sie einen Namen und die Gültigkeitsdauer an.
4. Kopieren Sie den generierten he_mcp_...-Schlüssel und bewahren Sie ihn sicher auf.

---

Konfiguration der KI-Clients

1. Cursor IDE Konfiguration

Erstellen oder aktualisieren Sie .cursor/mcp.json im Wurzelverzeichnis Ihres Projekts:

{
  "mcpServers": {
    "hashentry-public": {
      "url": "https://system.hashentry.com/mcp/public"
    },
    "hashentry-tenant": {
      "url": "https://system.hashentry.com/mcp/tenant",
      "headers": {
        "Authorization": "Bearer he_mcp_IHR_TOKEN_HIER"
      }
    }
  }
}

2. Claude Desktop Konfiguration

Öffnen Sie Ihre claude_desktop_config.json:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Fügen Sie die Serverkonfiguration ein:

{
  "mcpServers": {
    "hashentry": {
      "url": "https://system.hashentry.com/mcp/tenant",
      "headers": {
        "Authorization": "Bearer he_mcp_IHR_TOKEN_HIER"
      }
    }
  }
}

---

Verfügbare MCP-Werkzeuge (Tools)

1. Öffentliche Werkzeuge (/mcp/public)

Ohne Anmeldung nutzbar:

• start_cmp_scan: Startet eine vollständige Cookie- und DSGVO-Prüfung für jede beliebige Webadresse.
• get_cmp_scan_status: Fragt den aktuellen Verarbeitungsstatus eines laufenden Scans ab.
• get_cmp_scan_report: Liefert den fertigen Prüfbericht mit kategorisierten Cookies und Konformitätsbewertung.
• search_cookie_definitions: Durchsucht das globale HashEntry-Verzeichnis nach Cookie-Zwecken, Anbietern und Speicherdauern.
• get_pricing_plans: Zeigt verfügbare Tarife und Kontingentgrenzen an.
• search_knowledge_base: Durchsucht offizielle Dokumentationen und rechtliche Leitfäden.

2. Mandanten-Werkzeuge (/mcp/tenant)

Erfordert ein Mandantenkonto und ein gültiges Token:

• list_sites: Listet alle registrierten Websites Ihres Kontos auf.
• get_site: Ruft Details, API-Schlüssel und Einstellungen einer Website ab.
• create_site: Erstellt einen neuen Website-Eintrag auf der Plattform.
• trigger_site_cookie_scan: Startet ein automatisiertes Cookie-Audit für eine registrierte Website.
• list_site_cookies: Zeigt alle erkannten Cookies und deren Kategoriezuordnungen.
• get_banner_config: Ruft Layout-, Farb-, Text- und Rechtsmodus-Einstellungen des Banners ab.
• update_banner_config: Aktualisiert Erscheinungsbild und Verhaltensparameter des Banners.
• list_documents: Listet Rechtstexte (Cookie-Richtlinie, Datenschutzerklärung) auf.
• get_document: Lädt den vollständigen Inhalt eines juristischen Dokuments herunter.
• save_document_draft: Speichert von der KI überarbeitete Textpassagen als Entwurf ab.
• publish_document: Veröffentlicht ein freigegebenes Dokument mit neuer Versionsnummer.
• get_consent_stats: Gibt Zustimmungs-, Ablehnungs- und Kategorie-Akzeptanzraten aus.
• list_tickets & create_ticket: Ermöglicht das Einsehen und Erstellen von Support-Tickets.
• get_quota_usage: Zeigt die aktuelle Auslastung von Scans, Seiten und API-Aufrufen an.

3. Reseller-Werkzeuge (/mcp/reseller)

Erfordert Wiederverkäufer-Berechtigung:

• get_reseller_dashboard: Liefert Kundenübersicht, Provisionsguthaben und Auszahlungsdaten.
• list_reseller_tenants: Listet alle betreuten Kundenmandanten auf.
• create_reseller_tenant: Legt eine neue Kundenorganisation an.
• list_commissions: Zeigt die Abrechnungshistorie der Provisionen an.
• list_reseller_tickets & create_reseller_ticket: Prioritärer Partnersupport-Kanal.