MCP-server voor AI-assistenten

Wat je kunt vragen

Welke van mijn sites plaatsen cookies voordat een bezoeker toestemming geeft, en wat moet ik als eerste oplossen?
Scan alle klantsites en geef me per klant een kort rapport, voor ons maandelijkse overleg.
Zijn er sinds de vorige scan nieuwe cookies opgedoken op shop.example.com? Wie plaatst ze?
Hoeveel bezoekers hebben vorige maand de banner op example.com geaccepteerd, en uit welke landen?
Een bezoeker heeft consent-ID 1b4e28ba-2fa1-41d2-883f-0016d3cca427 gestuurd. Waarmee heeft die ingestemd, en wanneer?
Vergelijk de acceptatiepercentages van al mijn sites en vertel me welke banner het slechtst scoort.
Controleer de Tag Manager-container van example.com en corrigeer de tags die vóór toestemming draaien.

De assistent leest je sites, scans en consentlog via de tools hieronder. Hij kan alleen een scan starten of een site publiceren als je daarom vraagt, en goede clients vragen je eerst om bevestiging.

Koppelen

Je hebt een sleutel nodig. Een eigenaar of beheerder maakt die aan onder Instellingen, API-sleutels. Hij begint met cmk_; we tonen hem één keer, dus kopieer hem meteen. De server staat op:

https://cookiemark.com/mcp

Claude Code

claude mcp add --transport http cookiemark https://cookiemark.com/mcp \
  --header "Authorization: Bearer cmk_..."

Cursor, Windsurf en andere clients met een instellingenbestand

{
  "mcpServers": {
    "cookiemark": {
      "url": "https://cookiemark.com/mcp",
      "headers": { "Authorization": "Bearer cmk_..." }
    }
  }
}

Claude Desktop

Voeg Cookiemark toe aan claude_desktop_config.json via de kleine brug mcp-remote, die Node.js nodig heeft:

{
  "mcpServers": {
    "cookiemark": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://cookiemark.com/mcp", "--header", "Authorization: Bearer cmk_..."]
    }
  }
}

Start Claude Desktop opnieuw, dan staat Cookiemark tussen de tools.

De tools

Tool	Wat het doet
`list_sites`	Elke site, met of de banner live staat en een samenvatting van de laatste scan.	Leest
`get_scan_report`	De laatste scan van een site: problemen en hoe je ze oplost, de controles, elke cookie en de gevonden tracking-ID's.	Leest
`find_new_cookies`	Cookies die de laatste scan heeft gevonden en die nog niet op de cookielijst staan, met een voorgestelde categorie.	Leest
`consent_stats`	Hoe bezoekers over een aantal dagen hebben geantwoord: geaccepteerd, geweigerd, eigen keuze, het acceptatiepercentage en de belangrijkste landen.	Leest
`get_consent_log`	De keuzes op een site, de nieuwste eerst, over een periode die je kiest.	Leest
`find_consent`	Elke keuze onder één consent-ID, om een bezoeker te antwoorden die wil weten waarmee hij heeft ingestemd.	Leest
`start_scan`	Start een nieuwe scan van een site. Eén scan per site per tien minuten.	Wijzigt
`publish_site`	Zet het huidige concept van een site live.	Wijzigt
`gtm_check`	Controleert de toestemming in de Google Tag Manager-container van de site en somt op wat er mis is.	Leest
`gtm_prepare_fix`	Zet de correctie in een nieuwe werkruimte in Tag Manager die je kunt bekijken. Er gaat niets live.	Wijzigt
`gtm_publish_fix`	Publiceert de correctie die klaarstaat en start een scan om die te controleren.	Wijzigt

Elke tool die een site nodig heeft, accepteert het domein, zoals example.com, of het ID uit list_sites.

Sleutels en veiligheid

Een sleutel hoort bij één organisatie en ziet alleen de sites daarvan.
De assistent kan geen teksten, ontwerp of cookielijst wijzigen. Dat doe je in het dashboard.
Een sleutel mag 120 verzoeken per minuut doen. Trek hem in onder Instellingen, API-sleutels, en de assistent verliest meteen zijn toegang.
Behandel de sleutel als een wachtwoord: iedereen die hem heeft, kan je consentlog lezen.

Voor ontwikkelaars

De server spreekt MCP over Streamable HTTP zonder sessies: stuur met POST één JSON-RPC-bericht of een batch naar /mcp met de sleutel als Bearer-token, en elk verzoek krijgt een antwoord in JSON. De server ondersteunt de protocolversies 2025-06-18, 2025-03-26 en 2024-11-05. Tools die lezen, hebben readOnlyHint; publish_site heeft destructiveHint.