MCP-Server-Dokumentation

Der Biscotti CMP MCP Server ermöglicht es KI-Assistenten, programmgesteuert mit Ihrem Biscotti CMP-Konto zu interagieren. Verwalten Sie Websites, Banner, Compliance-Prüfungen, Einwilligungsanalysen, rechtliche Dokumente und vieles mehr – alles über Befehle in natürlicher Sprache in Ihrer IDE.

Der MCP-Server (Model Context Protocol) fungiert als Brücke zwischen Ihrem KI-Assistenten und der Biscotti CMP-API und stellt eine Reihe von Tools bereit, die direkt aus Ihrer Entwicklungsumgebung aufgerufen werden können.

Voraussetzungen

• Node.js 18 oder höher
• Ein Biscotti-CMP-Konto mit einem „Agency“- oder „LTD Agency“-Tarif
• Ein API-Schlüssel von der Seite „Entwicklereinstellungen“

Schnellstart

Der schnellste Weg, um loszulegen, ist die Verwendung von npx — keine Installation erforderlich:

npx @biscotti-cmp/mcp-server

Führen Sie den MCP-Server direkt aus, ohne ihn global zu installieren. Dies ist für die meisten Benutzer die empfohlene Vorgehensweise:

npx @biscotti-cmp/mcp-server

Wenn Sie den MCP-Server lieber systemweit auf Ihrem Computer installieren möchten:

npm install -g @biscotti-cmp/mcp-server

Nach der Installation können Sie den Server direkt starten:

biscotti-mcp

Um den Biscotti CMP MCP Server mit Claude Desktop zu verwenden, fügen Sie die folgende Konfiguration in Ihre Claude Desktop-Einstellungsdatei ein.

Speicherort der Konfigurationsdatei

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

Konfiguration

Füge Folgendes in deine Konfigurationsdatei ein:

{
  "mcpServers": {
    "biscotti-cmp": {
      "command": "npx",
      "args": ["-y", "@biscotti-cmp/mcp-server"],
      "env": {
        "BISCOTTI_API_KEY": "your-api-key-here"
      }
    }
  }
}

Starten Sie Claude Desktop nach dem Speichern der Konfigurationsdatei neu. Die Biscotti-CMP-Tools werden im Menü „Tools“ angezeigt.

Um den Biscotti CMP MCP Server mit Cursor zu verwenden, fügen Sie die folgende Konfiguration zu Ihren Cursor MCP-Einstellungen hinzu.

Speicherort der Konfigurationsdatei

• Auf Projektebene: .cursor/mcp.json im Stammverzeichnis Ihres Projekts
• Global: ~/.cursor/mcp.json

Konfiguration

{
  "mcpServers": {
    "biscotti-cmp": {
      "command": "npx",
      "args": ["-y", "@biscotti-cmp/mcp-server"],
      "env": {
        "BISCOTTI_API_KEY": "your-api-key-here"
      }
    }
  }
}

Nach dem Speichern erkennt Cursor automatisch den MCP-Server und stellt die Tools im KI-Assistenten zur Verfügung.

Um den Biscotti CMP MCP Server mit Kiro zu verwenden, konfigurieren Sie ihn über die MCP-Einstellungen.

Speicherort der Konfigurationsdatei

• Auf Projektebene: .kiro/settings/mcp.json im Stammverzeichnis Ihres Projekts
• Weltweit: ~/.kiro/settings/mcp.json

Konfiguration

{
  "mcpServers": {
    "biscotti-cmp": {
      "command": "npx",
      "args": ["-y", "@biscotti-cmp/mcp-server"],
      "env": {
        "BISCOTTI_API_KEY": "your-api-key-here"
      }
    }
  }
}

Kiro erkennt die MCP-Serverkonfiguration automatisch und stellt die Biscotti-CMP-Tools zur Verfügung.

Der Biscotti CMP MCP-Server ist mit jedem MCP-kompatiblen Client kompatibel. Verwenden Sie die folgende allgemeine Konfiguration:

Allgemeine Konfiguration

{
  "mcpServers": {
    "biscotti-cmp": {
      "command": "npx",
      "args": ["-y", "@biscotti-cmp/mcp-server"],
      "env": {
        "BISCOTTI_API_KEY": "your-api-key-here"
      }
    }
  }
}

Falls Ihr MCP-Client ein anderes Konfigurationsformat verwendet, lauten die wichtigsten Parameter:

• Befehl: npx
• Argumente: -y @biscotti-cmp/mcp-server
• Umgebungsvariable: BISCOTTI_API_KEY auf Ihren API-Schlüssel setzen

Tools zur Verwaltung Ihrer Websites in Biscotti CMP.

Tools zum Erstellen und Verwalten von Einwilligungsbannern.

Tools zum Scannen von Websites und zur Überprüfung des Konformitätsstatus.

Tools für den Zugriff auf Einwilligungsstatistiken und Analysedaten.

Tools zur Verwaltung von Rechtsdokumenten wie Datenschutzerklärungen, Nutzungsbedingungen und Impressumsseiten.

Tools zur Verwaltung erkannter Dienste von Drittanbietern und ihrer Einwilligungskategorien.

Tools zur Verwaltung von Webhook-Integrationen für Ereignisbenachrichtigungen in Echtzeit.

Tools für die Agentur-Kundenbetreuung und das Kundenmanagement.

Der Biscotti CMP MCP Server stellt die folgenden Ressourcen bereit, die KI-Assistenten zur Kontextanalyse abrufen können:

• biscotti://websites – Liste aller Websites in deinem Konto
• biscotti://website/{id} — Detaillierte Website-Konfiguration
• biscotti://compliance/{id} — Aktueller Konformitätsstatus einer Website
• biscotti://banners/{websiteId} — Alle Banner für eine Website

Ressourcen bieten einen schreibgeschützten Kontext, der KI-Assistenten dabei hilft, Ihre aktuelle Konfiguration zu verstehen, bevor Änderungen vorgenommen werden.

Der MCP-Server enthält integrierte Eingabeaufforderungsvorlagen für gängige Arbeitsabläufe:

Compliance-Prüfung

Führen Sie eine umfassende Compliance-Prüfung einer Website durch, suchen Sie nach Cookies, überprüfen Sie die Einwilligungseinstellungen und erstellen Sie einen Bericht.

Führen Sie ein Compliance-Audit auf meiner Website example.com durch und schlagen Sie Verbesserungen vor.

Einrichtung des Banners

Erstellen und konfigurieren Sie ein Einwilligungsbanner mit Ihrem bevorzugten Design und Ihren bevorzugten Einstellungen.

Erstellen Sie ein GDPR-konformes Consent-Banner für meine Website mit einem dunklen Design und einer Position unten links.

Erstellung von Rechtsdokumenten

Erstellen Sie Rechtsdokumente auf der Grundlage Ihrer Website-Konfiguration und der für Sie maßgeblichen Rechtsordnung.

Generieren Sie eine Datenschutzerklärung für meine deutsche Website, die Google Analytics und Facebook Pixel abdeckt.

Der Biscotti CMP MCP-Server benötigt einen API-Schlüssel zur Authentifizierung bei der Biscotti CMP-API. Alle vom MCP-Server gesendeten Anfragen werden anhand Ihres API-Schlüssels authentifiziert.

So funktioniert die Authentifizierung

1. Sie erstellen einen API-Schlüssel auf der Seite „Entwicklereinstellungen“ Ihres Biscotti CMP-Dashboards.
2. Der API-Schlüssel wird als BISCOTTI_API_KEY Umgebungsvariable in Ihrer MCP-Client-Konfiguration festgelegt.
3. Der MCP-Server fügt diesen Schlüssel als Bearer-Token in alle API-Anfragen ein.
4. Die Biscotti-CMP-API überprüft den Schlüssel und gibt Daten zurück, die auf Ihr Konto beschränkt sind.

So erhalten Sie einen API-Schlüssel für den MCP-Server:

1. Melden Sie sich bei Ihrem Biscotti CMP-Dashboard unter app.biscotti-cmp.com an.
2. Gehen Sie in der Seitenleiste zu den Entwicklereinstellungen.
3. Klicken Sie auf der Registerkarte „API-Schlüssel“ auf „Neuen Schlüssel generieren“.
4. Geben Sie Ihrem Schlüssel einen aussagekräftigen Namen (z. B. „MCP-Server – Entwicklung“).
5. Legen Sie optional ein Ablaufdatum für den Schlüssel fest.
6. Kopieren Sie den generierten Schlüssel sofort – er wird nur einmal angezeigt.

Bewährte Verfahren für die Schlüsselverwaltung

• Verwenden Sie für Entwicklungs- und Produktionsumgebungen separate API-Schlüssel.
• Legen Sie Ablaufdaten für Schlüssel fest, die nur vorübergehend verwendet werden.
• Wechseln Sie die Schlüssel regelmäßig aus und widerrufen Sie nicht mehr verwendete Schlüssel.
• Nutzen Sie die Funktion zur Schlüsselrotation, um Schlüssel ohne Betriebsunterbrechung auszutauschen.