Documentatie voor de MCP-server

Met de Biscotti CMP MCP Server kunnen AI-assistenten programmatisch communiceren met uw Biscotti CMP-account. Beheer websites, banners, nalevingscontroles, analyses van toestemmingsgegevens, juridische documenten en nog veel meer — allemaal via natuurlijke taalopdrachten in uw IDE.

De MCP-server (Model Context Protocol) fungeert als een brug tussen uw AI-assistent en de Biscotti CMP API en biedt een reeks tools die rechtstreeks vanuit uw ontwikkelomgeving kunnen worden aangeroepen.

Vereisten

• Node.js 18 of hoger
• Een Biscotti CMP-account met een Agency- of LTD Agency-abonnement
• Een API-sleutel van de pagina ‘Ontwikkelaarsinstellingen’

Snel aan de slag

De snelste manier om aan de slag te gaan is door gebruik te maken van npx — geen installatie nodig:

npx @biscotti-cmp/mcp-server

Start de MCP-server rechtstreeks, zonder deze globaal te installeren. Dit is de aanbevolen werkwijze voor de meeste gebruikers:

npx @biscotti-cmp/mcp-server

Als u de voorkeur geeft aan een globale installatie van de MCP Server op uw systeem:

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

Na de installatie kunt u de server rechtstreeks uitvoeren:

biscotti-mcp

Om de Biscotti CMP MCP-server met Claude Desktop te gebruiken, voegt u de volgende configuratie toe aan uw instellingenbestand voor Claude Desktop.

Locatie van het configuratiebestand

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

Configuratie

Voeg het volgende toe aan je configuratiebestand:

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

Start Claude Desktop opnieuw op nadat u het configuratiebestand hebt opgeslagen. De Biscotti CMP-tools verschijnen dan in het menu ‘Tools’.

Om de Biscotti CMP MCP-server met Cursor te gebruiken, voegt u de volgende configuratie toe aan uw Cursor MCP-instellingen.

Locatie van het configuratiebestand

• Op projectniveau: .cursor/mcp.json in de hoofdmap van je project
• Wereldwijd: ~/.cursor/mcp.json

Configuratie

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

Na het opslaan zal Cursor automatisch de MCP-server detecteren en de tools beschikbaar maken in de AI-assistent.

Om de Biscotti CMP MCP-server met Kiro te gebruiken, moet u deze via de MCP-instellingen configureren.

Locatie van het configuratiebestand

• Op projectniveau: .kiro/settings/mcp.json in de hoofdmap van je project
• Wereldwijd: ~/.kiro/settings/mcp.json

Configuratie

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

Kiro detecteert automatisch de configuratie van de MCP-server en stelt de Biscotti CMP-tools beschikbaar.

De Biscotti CMP MCP-server is compatibel met elke MCP-compatibele client. Gebruik de volgende algemene configuratie:

Algemene configuratie

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

Als uw MCP-client een ander configuratieformaat gebruikt, zijn de belangrijkste parameters:

• Commando: npx
• Argumenten: -y @biscotti-cmp/mcp-server
• Omgevingsvariabele: BISCOTTI_API_KEY stel in op uw API-sleutel

Tools voor het beheren van uw websites in Biscotti CMP.

Hulpmiddelen voor het maken en beheren van toestemmingsbanners.

Tools voor het scannen van websites en het controleren van de compliance-status.

Tools voor toegang tot consent-statistieken en analytics-gegevens.

Hulpmiddelen voor het beheren van juridische documenten, zoals privacyverklaringen, gebruiksvoorwaarden en colofonpagina’s.

Tools voor het beheren van gedetecteerde diensten van derden en hun toestemmingscategorieën.

Tools voor het beheren van webhook-integraties voor real-time gebeurtenismeldingen.

Tools voor het beheer van agency-accounts en client-activiteiten.

De Biscotti CMP MCP-server stelt de volgende bronnen beschikbaar die AI-assistenten kunnen raadplegen voor context:

• biscotti://websites — Lijst met alle websites in je account
• biscotti://website/{id} — Gedetailleerde websiteconfiguratie
• biscotti://compliance/{id} — Huidige nalevingsstatus van een website
• biscotti://banners/{websiteId} — Alle banners voor een website

Deze bronnen bieden een alleen-lezen overzicht waarmee AI-assistenten inzicht krijgen in je huidige configuratie voordat ze wijzigingen doorvoeren.

De MCP-server bevat ingebouwde prompt-sjablonen voor veelvoorkomende workflows:

Nalevingscontrole

Voer een volledige nalevingscontrole uit op een website, waarbij je scant op cookies, de instellingen voor toestemming controleert en een rapport genereert.

Voer een compliance audit uit op mijn website example.com en stel verbeteringen voor.

Banner instellen

Maak een toestemmingsbanner aan en stel deze in volgens uw eigen ontwerp- en gedragsvoorkeuren.

Creëer een GDPR-conforme toestemmingsbanner voor mijn website met een donker thema en een positie linksonder.

Het opstellen van juridische documenten

Maak juridische documenten aan op basis van de configuratie van uw website en het land waarvoor ze bestemd zijn.

Genereer een privacybeleid voor mijn Duitse website dat Google Analytics en Facebook Pixel behandelt.

De Biscotti CMP MCP-server heeft een API-sleutel nodig om zich te authenticeren bij de Biscotti CMP API. Alle verzoeken die door de MCP-server worden verzonden, worden geauthenticeerd met behulp van uw API-sleutel.

Hoe authenticatie werkt

1. Je genereert een API-sleutel op de pagina ‘Developer Settings’ van je Biscotti CMP-dashboard.
2. De API-sleutel is ingesteld als de BISCOTTI_API_KEY omgevingsvariabele in de configuratie van je MCP-client.
3. De MCP-server neemt deze sleutel als Bearer-token op in alle API-verzoeken.
4. De Biscotti CMP API controleert de geldigheid van de sleutel en retourneert gegevens die specifiek betrekking hebben op uw account.

Om een API-sleutel voor de MCP-server te verkrijgen:

1. Log in op uw Biscotti CMP-dashboard via app.biscotti-cmp.com.
2. Ga in de zijbalk naar 'Ontwikkelaarsinstellingen'.
3. Klik op 'Nieuwe sleutel genereren' op het tabblad 'API-sleutels'.
4. Geef uw sleutel een beschrijvende naam (bijvoorbeeld "MCP-server - Ontwikkeling").
5. Stel desgewenst een vervaldatum voor de sleutel in.
6. Kopieer de gegenereerde sleutel meteen — deze wordt maar één keer weergegeven.

Beste praktijken voor sleutelbeheer

• Gebruik aparte API-sleutels voor de ontwikkel- en productieomgeving.
• Stel een vervaldatum in voor sleutels die tijdelijk worden gebruikt.
• Wissel sleutels regelmatig af en trek ongebruikte sleutels in.
• Gebruik de functie voor sleutelrotatie om sleutels te vervangen zonder dat dit tot uitval leidt.