Documentation du serveur MCP

Le serveur Biscotti CMP MCP permet aux assistants IA d'interagir avec votre compte Biscotti CMP par programmation. Gérez des sites web, des bannières, des analyses de conformité, des statistiques sur les consentements, des documents juridiques et bien plus encore, le tout à l'aide de commandes en langage naturel depuis votre IDE.

Le serveur MCP (Model Context Protocol) sert de passerelle entre votre assistant IA et l'API Biscotti CMP, en fournissant un ensemble d'outils pouvant être appelés directement depuis votre environnement de développement.

Conditions préalables

• Node.js 18 ou version ultérieure
• Un compte Biscotti CMP avec une formule « Agence » ou « Agence LTD »
• Une clé API accessible depuis la page « Paramètres du développeur »

Démarrage rapide

Le moyen le plus rapide de commencer est d'utiliser npx — aucune installation requise :

npx @biscotti-cmp/mcp-server

Exécutez le serveur MCP directement sans l'installer globalement. C'est la méthode recommandée pour la plupart des utilisateurs :

npx @biscotti-cmp/mcp-server

Si vous préférez installer le serveur MCP globalement sur votre système :

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

Après l'installation, vous pouvez lancer le serveur directement :

biscotti-mcp

Pour utiliser le serveur Biscotti CMP MCP avec Claude Desktop, ajoutez la configuration suivante à votre fichier de paramètres Claude Desktop.

Emplacement du fichier de configuration

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

Configuration

Ajoutez ce qui suit à votre fichier de configuration :

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

Redémarrez Claude Desktop après avoir enregistré le fichier de configuration. Les outils Biscotti CMP apparaîtront dans le menu Outils.

Pour utiliser le serveur Biscotti CMP MCP avec Cursor, ajoutez la configuration suivante à vos paramètres Cursor MCP.

Emplacement du fichier de configuration

• Au niveau du projet : .cursor/mcp.json à la racine de votre projet
• Global : ~/.cursor/mcp.json

Configuration

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

Une fois l'enregistrement effectué, Cursor détectera automatiquement le serveur MCP et mettra les outils à disposition dans l'assistant IA.

Pour utiliser le serveur Biscotti CMP MCP avec Kiro, configurez-le via les paramètres MCP.

Emplacement du fichier de configuration

• Au niveau du projet : .kiro/settings/mcp.json à la racine de votre projet
• Dans le monde : ~/.kiro/settings/mcp.json

Configuration

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

Kiro détectera automatiquement la configuration du serveur MCP et mettra à disposition les outils Biscotti CMP.

Le serveur Biscotti CMP MCP est compatible avec tout client conforme à la norme MCP. Utilisez la configuration générique suivante :

Configuration générale

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

Si votre client MCP utilise un format de configuration différent, les paramètres clés sont les suivants :

• Commande : npx
• Arguments : -y @biscotti-cmp/mcp-server
• Variable d'environnement : BISCOTTI_API_KEY définissez-la avec votre clé API

Outils pour gérer vos sites web dans Biscotti CMP.

Outils permettant de créer et de gérer les bannières de consentement.

Outils pour scanner les sites web et vérifier le statut de conformité.

Outils pour accéder aux statistiques de consentement et aux données d'analyse.

Outils permettant de gérer les documents juridiques tels que les politiques de confidentialité, les conditions d'utilisation et les mentions légales.

Outils pour gérer les services tiers détectés et leurs catégories de consentement.

Outils pour gérer les intégrations de webhooks pour les notifications d'événements en temps réel.

Outils pour la gestion des comptes d'agence et les opérations clients.

Le serveur Biscotti CMP MCP met à disposition les ressources suivantes, que les assistants IA peuvent consulter pour obtenir le contexte :

• biscotti://sites web — Liste de tous les sites web de votre compte
• biscotti://website/{id} — Configuration détaillée du site web
• biscotti://compliance/{id} — État actuel de conformité d'un site web
• biscotti://banners/{websiteId} — Toutes les bannières d'un site web

Les ressources fournissent un contexte en lecture seule qui aide les assistants IA à comprendre votre configuration actuelle avant d'effectuer des modifications.

Le serveur MCP intègre des modèles d'invite prédéfinis pour les flux de travail courants :

Audit de conformité

Effectuer un audit de conformité complet d'un site web, en recherchant les cookies, en vérifiant la configuration des consentements et en générant un rapport.

Exécutez un audit de conformité sur mon site web example.com et suggérez des améliorations.

Configuration de la bannière

Créez et configurez une bannière de consentement en choisissant le design et les paramètres de fonctionnement qui vous conviennent.

Créez une bannière de consentement conforme au RGPD pour mon site web avec un thème sombre et une position en bas à gauche.

Création de documents juridiques

Générez des documents juridiques en fonction de la configuration de votre site web et de la juridiction concernée.

Générez une politique de confidentialité pour mon site web allemand qui couvre Google Analytics et Facebook Pixel.

Le serveur MCP de Biscotti CMP nécessite une clé API pour s'authentifier auprès de l'API Biscotti CMP. Toutes les requêtes effectuées par le serveur MCP sont authentifiées à l'aide de votre clé API.

Comment fonctionne l'authentification

1. Vous générez une clé API dans la page « Paramètres développeur » de votre tableau de bord Biscotti CMP.
2. La clé API est définie comme BISCOTTI_API_KEY dans la configuration de votre client MCP.
3. Le serveur MCP inclut cette clé sous forme de jeton « Bearer » dans toutes les requêtes API.
4. L'API Biscotti CMP valide la clé et renvoie des données spécifiques à votre compte.

Pour obtenir une clé API pour le serveur MCP :

1. Connectez-vous à votre tableau de bord Biscotti CMP sur app.biscotti-cmp.com.
2. Accédez à la section « Paramètres de développement » dans la barre latérale.
3. Cliquez sur « Générer une nouvelle clé » dans l'onglet « Clés API ».
4. Donnez à votre clé un nom descriptif (par exemple, « Serveur MCP - Développement »).
5. Vous pouvez, si vous le souhaitez, définir une date d'expiration pour la clé.
6. Copiez immédiatement la clé générée : elle ne s'affichera qu'une seule fois.

Meilleures pratiques en matière de gestion des clés

• Utilisez des clés API distinctes pour les environnements de développement et de production.
• Définissez des dates d'expiration pour les clés utilisées temporairement.
• Renouvelez régulièrement les clés et révoquez celles qui ne sont plus utilisées.
• Utilisez la fonctionnalité de rotation des clés pour remplacer les clés sans interruption de service.