Commencer gratuitementTableau de bord
Documentation

MCP pour les assistants IA

Le Model Context Protocol (MCP) permet à un assistant IA de travailler avec Cookiemark pour vous. Demandez en langage courant quels sites posent problème, ce qui a changé depuis la dernière analyse ou combien de visiteurs ont dit oui, et l’assistant va chercher la réponse. C’est inclus avec chaque site payant.

Ce que vous pouvez demander

  • Lesquels de mes sites déposent des cookies avant l’accord du visiteur, et que dois-je corriger en premier ?
  • Analysez tous les sites clients et faites-moi un court rapport par client pour notre réunion mensuelle.
  • De nouveaux cookies sont-ils apparus sur shop.example.com depuis la dernière analyse ? Qui les dépose ?
  • Combien de visiteurs ont accepté le bandeau sur example.com le mois dernier, et depuis quels pays ?
  • Un visiteur a envoyé l’ID de consentement 1b4e28ba-2fa1-41d2-883f-0016d3cca427. Qu’a-t-il accepté, et quand ?
  • Comparez les taux d’acceptation de tous mes sites et dites-moi quel bandeau obtient le moins bon résultat.
  • Vérifiez le conteneur Tag Manager d’example.com et corrigez les balises qui s’exécutent avant le consentement.

L’assistant consulte vos sites, vos analyses et votre journal des consentements grâce aux outils ci-dessous. Il ne peut lancer une analyse ou publier un site que si vous le lui demandez, et les bons clients MCP vous demandent d’abord confirmation.

Connecter

Il vous faut une clé. Un propriétaire ou un administrateur en crée une sous Paramètres, Clés API. Elle commence par cmk_ ; nous ne l’affichons qu’une fois, copiez-la donc tout de suite. Le serveur se trouve à l’adresse :

https://cookiemark.com/mcp

Claude Code

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

Cursor, Windsurf et les autres clients avec un fichier de configuration

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

Claude Desktop

Ajoutez Cookiemark à claude_desktop_config.json via la petite passerelle mcp-remote, qui nécessite Node.js :

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

Redémarrez Claude Desktop : Cookiemark apparaît parmi ses outils.

Les outils

OutilRôle
list_sitesChaque site, avec l’état de son bandeau (en ligne ou non) et un résumé de sa dernière analyse.Lecture
get_scan_reportLa dernière analyse d’un site : les problèmes et comment les corriger, les contrôles, chaque cookie et les identifiants de suivi trouvés.Lecture
find_new_cookiesLes cookies trouvés par la dernière analyse qui ne figurent pas encore dans la liste des cookies, avec une catégorie suggérée.Lecture
consent_statsLes réponses des visiteurs sur un nombre de jours donné : acceptations, refus, choix personnalisés, le taux d’acceptation et les principaux pays.Lecture
get_consent_logLes choix sur un site, du plus récent au plus ancien, pour la période de votre choix.Lecture
find_consentTous les choix associés à un ID de consentement, pour répondre à un visiteur qui demande ce qu’il a accepté.Lecture
start_scanLance une nouvelle analyse d’un site. Une analyse par site toutes les dix minutes.Modification
publish_siteMet en ligne le brouillon actuel d’un site.Modification
gtm_checkVérifie le consentement dans le conteneur Google Tag Manager du site et liste ce qui ne va pas.Lecture
gtm_prepare_fixPlace la correction dans un nouvel espace de travail Tag Manager que vous pouvez prévisualiser. Rien n’est mis en ligne.Modification
gtm_publish_fixPublie la correction en attente et lance une analyse pour la vérifier.Modification

Chaque outil qui porte sur un site accepte son domaine, comme example.com, ou son ID obtenu avec list_sites.

Clés et sécurité

  • Une clé appartient à une seule organisation et ne voit que ses sites.
  • L’assistant ne peut modifier ni les textes, ni l’apparence, ni la liste des cookies. Cela se fait dans le tableau de bord.
  • Une clé peut effectuer 120 requêtes par minute. Révoquez-la sous Paramètres, Clés API, et l’assistant perd immédiatement l’accès.
  • Traitez la clé comme un mot de passe : quiconque la possède peut lire votre journal des consentements.

Pour les développeurs

Le serveur utilise MCP via Streamable HTTP, sans sessions : envoyez en POST un message JSON-RPC ou un lot de messages à /mcp avec la clé comme jeton Bearer, et chaque requête reçoit une réponse JSON. Il prend en charge les versions de protocole 2025-06-18, 2025-03-26 et 2024-11-05. Les outils de lecture portent readOnlyHint ; publish_site porte destructiveHint.