Documentació del servidor MCP

El servidor MCP de Biscotti CMP permet als assistents d'IA interactuar amb el vostre compte de Biscotti CMP de manera programàtica. Gestioneu llocs web, bàners, escanejos de compliment, anàlisi de consentiment, documents legals i molt més, tot mitjançant ordres en llenguatge natural al vostre IDE.

El servidor MCP (Model Context Protocol) actua com a pont entre el vostre assistent d'IA i l'API de Biscotti CMP, proporcionant un conjunt d'eines que es poden cridar directament des del vostre entorn de desenvolupament.

Prerequisites

• Node.js 18 or later
• Un compte de Biscotti CMP amb un pla Agency o LTD Agency
• Una clau API de la pàgina de configuració per a desenvolupadors (Developer Settings)

Quick Start

La manera més ràpida de començar és utilitzar npx; no cal instal·lar-lo:

npx @biscotti-cmp/mcp-server

Executeu el servidor MCP directament sense instal·lar-lo globalment. Aquest és l'enfocament recomanat per a la majoria dels usuaris:

npx @biscotti-cmp/mcp-server

Si preferiu instal·lar el servidor MCP globalment al vostre sistema:

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

Després de la instal·lació, podeu executar el servidor directament:

biscotti-mcp

Per utilitzar el servidor MCP de Biscotti CMP amb Claude Desktop, afegiu la configuració següent al fitxer de configuració de Claude Desktop.

Ubicació del fitxer de configuració

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

Configuration

Afegiu el següent al vostre fitxer de configuració:

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

Reinicieu Claude Desktop després de desar el fitxer de configuració. Les eines de Biscotti CMP apareixeran al menú d'eines.

Per utilitzar el Biscotti CMP MCP Server amb Cursor, afegiu la configuració següent a la configuració del Cursor MCP.

Ubicació del fitxer de configuració

• A nivell de projecte: .cursor/mcp.json a l'arrel del vostre projecte
• Global: ~/.cursor/mcp.json

Configuration

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

Després de desar, Cursor detectarà automàticament el servidor MCP i posarà les eines a disposició a l'assistent d'IA.

Per utilitzar el Biscotti CMP MCP Server amb Kiro, configureu-lo a través de la configuració MCP.

Ubicació del fitxer de configuració

• A nivell de projecte: .kiro/settings/mcp.json a l'arrel del vostre projecte
• Global: ~/.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 detectarà automàticament la configuració del servidor MCP i posarà a disposició les eines de Biscotti CMP.

El Biscotti CMP MCP Server és compatible amb qualsevol client compatible amb MCP. Utilitzeu la següent configuració genèrica:

Configuració genèrica

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

Si el vostre client MCP utilitza un format de configuració diferent, els paràmetres clau són:

• Ordre: npx
• Arguments: -y @biscotti-cmp/mcp-server
• Variable d'entorn: BISCOTTI_API_KEY establerta a la vostra clau API

Eines per gestionar els vostres llocs web a Biscotti CMP.

Eines per crear i gestionar banners de consentiment.

Eines per escanejar llocs web i comprovar l'estat de compliment.

Eines per accedir a estadístiques de consentiment i dades d'anàlisi.

Eines per gestionar documents legals com ara polítiques de privadesa, termes del servei i pàgines d'avís legal.

Eines per gestionar els serveis de tercers detectats i les seves categories de consentiment.

Eines per gestionar les integracions de webhook per a notificacions d'esdeveniments en temps real.

Eines per a la gestió de comptes de clients i operacions d'agència.

El servidor MCP de Biscotti CMP exposa els següents recursos que els assistents d'IA poden llegir per obtenir context:

• biscotti://websites — Llista de tots els llocs web al teu compte
• biscotti://website/{id} — Configuració detallada del lloc web
• biscotti://compliance/{id} — Estat actual de compliment d'un lloc web
• biscotti://banners/{websiteId} — Tots els bàners per a un lloc web

Els recursos proporcionen un context de només lectura que ajuda els assistents d'IA a comprendre la teva configuració actual abans de fer canvis.

El servidor MCP inclou plantilles d'indicacions integrades per a fluxos de treball comuns:

Compliance Audit

Executa una auditoria de compliment completa en un lloc web, escanejant les cookies, comprovant la configuració del consentiment i generant un informe.

Executa una auditoria de compliment al meu lloc web example.com i suggereix millores.

Banner Setup

Crea i configura un bàner de consentiment amb la teva configuració de disseny i comportament preferida.

Crea un bàner de consentiment compatible amb el GDPR per al meu lloc web amb un tema fosc i una posició inferior esquerra.

Generació de documents legals

Genera documents legals basats en la configuració del teu lloc web i la jurisdicció objectiu.

Genera una política de privadesa per al meu lloc web alemany que cobreixi Google Analytics i Facebook Pixel.

El servidor MCP de Biscotti CMP requereix una clau API per autenticar-se amb l'API de Biscotti CMP. Totes les sol·licituds fetes pel servidor MCP s'autentiquen amb la teva clau API.

Com funciona l'autenticació

1. Generes una clau API a la pàgina de configuració de desenvolupador del tauler de control de Biscotti CMP.
2. La clau API s'estableix com la variable d'entorn BISCOTTI_API_KEY a la configuració del teu client MCP.
3. El servidor MCP inclou aquesta clau com un token Bearer en totes les sol·licituds d'API.
4. L'API de Biscotti CMP valida la clau i retorna les dades limitades al teu compte.

Per obtenir una clau API per al servidor MCP:

1. Inicia sessió al teu tauler de control de Biscotti CMP a app.biscotti-cmp.com.
2. Navega fins a Configuració de desenvolupador a la barra lateral.
3. Fes clic a Genera una clau nova a la pestanya de claus API.
4. Dona a la teva clau un nom descriptiu (per exemple, "Servidor MCP - Desenvolupament").
5. Opcionalment, defineix una data de caducitat per a la clau.
6. Copia la clau generada immediatament — només es mostrarà una vegada.

Pràctiques recomanades de gestió de claus

• Utilitza claus API separades per a entorns de desenvolupament i producció.
• Defineix dates de caducitat per a les claus que s'utilitzen temporalment.
• Rota les claus regularment i revoca les claus que no s'utilitzen.
• Utilitza la funció de rotació de claus per reemplaçar les claus sense temps d'inactivitat.