Intégration du Model Context Protocol (MCP)

Le Model Context Protocol (MCP) est un standard ouvert initié par Anthropic permettant aux grands modèles de langage (LLM), aux IDE assistés par IA (comme Cursor, Windsurf) et aux agents autonomes d’interagir de manière sécurisée avec des outils externes, des bases de données et des API opérationnelles.

HashEntry propose des serveurs MCP officiels en mode Streamable-HTTP, permettant aux développeurs et aux délégués à la protection des données d’automatiser les audits de traceurs, de configurer les bandeaux de consentement, de rédiger des chartes de confidentialité et de consulter les statistiques de conformité RGPD directement en langage naturel.

---

Architecture et Niveaux d’Accès

HashEntry propose trois serveurs MCP distincts selon les privilèges et la sécurité requis :

Point de terminaison (Endpoint)	Niveau d’accès	Authentification	Fonctionnalités
https://system.hashentry.com/mcp/public	Public	Aucune (Anonyme)	Analyse instantanée de cookies, consultation de la bibliothèque de cookies, forfaits et base de connaissances.
https://system.hashentry.com/mcp/tenant	Client (Tenant)	Jeton Bearer (he_mcp_...)	Gestion des sites, déclenchement d’audits de traceurs, personnalisation du bandeau, rédaction et publication de politiques juridiques, statistiques de consentement.
https://system.hashentry.com/mcp/reseller	Revendeur (Reseller)	Jeton Bearer (he_mcp_...)	Gestion du portefeuille d’organisations clientes, suivi des commissions, solde et tickets d’assistance revendeur.

---

Authentification et Génération de Jetons MCP

Pour les serveurs Tenant et Reseller, les requêtes doivent obligatoirement comporter un Jeton d’Accès Personnel (he_mcp_...).

Génération de jetons via le tableau de bord HashEntry

1. Connectez-vous à votre Tableau de bord HashEntry.
2. Rendez-vous dans Paramètres → Jetons IA & MCP.
3. Cliquez sur Créer un nouveau jeton MCP, attribuez-lui un nom explicite et une période de validité.
4. Copiez la clé he_mcp_... générée et conservez-la en lieu sûr.

---

Configuration des Clients d’IA

1. Configuration pour Cursor IDE

Créez ou modifiez le fichier .cursor/mcp.json à la racine de votre projet :

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

2. Configuration pour Claude Desktop

Ouvrez le fichier claude_desktop_config.json :

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

Ajoutez la section suivante :

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

---

Liste des Outils MCP Disponibles

1. Outils Publics (/mcp/public)

Accessibles sans compte :

• start_cmp_scan : Lance une analyse complète des cookies et du respect de la vie privée sur une URL.
• get_cmp_scan_status : Consulte l’état d’avancement d’un audit en cours.
• get_cmp_scan_report : Récupère le rapport final détaillant les traceurs détectés et la note de conformité.
• search_cookie_definitions : Recherche des traceurs dans la base globale HashEntry (fournisseur, catégorie, durée).
• get_pricing_plans : Liste les forfaits d’abonnement et quotas disponibles.
• search_knowledge_base : Recherche dans la documentation technique et les guides juridiques officiels.

2. Outils Client (/mcp/tenant)

Nécessite un jeton client valide :

• list_sites : Répertorie tous les sites web rattachés à votre compte.
• get_site : Récupère les métadonnées, clés d’API et paramètres d’un site.
• create_site : Ajoute un nouveau site web à la plateforme.
• trigger_site_cookie_scan : Lance un scan périodique de cookies sur un site enregistré.
• list_site_cookies : Liste tous les cookies répertoriés et leurs catégories de consentement.
• get_banner_config : Récupère la charte graphique, les textes et les règles du bandeau.
• update_banner_config : Met à jour l’apparence et le comportement du bandeau de consentement.
• list_documents : Liste les chartes juridiques (Politique de Cookies, Politique de Confidentialité).
• get_document : Télécharge le texte intégral d’un document légal au format markdown ou HTML.
• save_document_draft : Enregistre les modifications ou nouveaux articles rédigés par l’IA en tant que brouillon.
• publish_document : Publie officiellement une version validée d’un texte juridique.
• get_consent_stats : Fournit les taux d’acceptation, de refus et de choix par catégorie.
• list_tickets & create_ticket : Gère les demandes d’assistance et soumet de nouveaux tickets.
• get_quota_usage : Visualise la consommation courante des quotas (audits, sites, requêtes API).

3. Outils Revendeur (/mcp/reseller)

Nécessite les privilèges d’agence partenaire :

• get_reseller_dashboard : Consultez les statistiques globales, le solde des commissions et les règlements.
• list_reseller_tenants : Liste l’ensemble des comptes clients sous votre gestion d’agence.
• create_reseller_tenant : Crée une nouvelle organisation cliente.
• list_commissions : Historique détaillé des commissions acquises.
• list_reseller_tickets & create_reseller_ticket : Canal d’assistance prioritaire pour partenaires.