Biscotti CMP | Servidor MCP para Asistentes y Agentes de IA

Documentación del servidor MCP

Primeros pasos

Resumen

El servidor Biscotti CMP MCP permite a los asistentes de IA interactuar con tu cuenta de Biscotti CMP mediante programación. Gestiona sitios web, banners, análisis de cumplimiento normativo, análisis de consentimientos, documentos legales y mucho más, todo ello mediante comandos en lenguaje natural desde tu IDE.

El servidor MCP (Model Context Protocol) actúa como puente entre tu asistente de IA y la API de Biscotti CMP, proporcionando un conjunto de herramientas a las que se puede acceder directamente desde tu entorno de desarrollo.

Requisitos previos

Node.js 18 o posterior
Una cuenta de Biscotti CMP con un plan «Agency» o «LTD Agency»
Una clave API de la página de configuración para desarrolladores

Inicio rápido

La forma más rápida de empezar es utilizando npx — no requiere instalación:

bash

npx @biscotti-cmp/mcp-server

Ejecutar con npx

Ejecuta el servidor MCP directamente sin instalarlo globalmente. Este es el método recomendado para la mayoría de los usuarios:

bash

npx @biscotti-cmp/mcp-server

Éxito

Al utilizar npx, el servidor se descarga y se ejecuta sobre la marcha. La configuración de tu IDE se encargará de esto automáticamente.

Instalación global

Si prefiere instalar el servidor MCP de forma global en su sistema:

bash

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

Después de la instalación, puede ejecutar el servidor directamente:

bash

biscotti-mcp

Éxito

La instalación global es útil si desea tiempos de inicio más rápidos o necesita ejecutar el servidor en entornos sin acceso a Internet.

Configuración de IDE

Claude Desktop

Para utilizar el servidor Biscotti CMP MCP con Claude Desktop, añade la siguiente configuración al archivo de configuración de Claude Desktop.

Ubicación del archivo de configuración

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

Configuración

Añade lo siguiente a tu archivo de configuración:

json

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

Éxito

Sustituye your-api-key-here por tu clave API real de la página de configuración para desarrolladores.

Reinicia Claude Desktop después de guardar el archivo de configuración. Las herramientas de Biscotti CMP aparecerán en el menú de herramientas.

Cursor

Para utilizar el servidor Biscotti CMP MCP con Cursor, añade la siguiente configuración a los ajustes de Cursor MCP.

Ubicación del archivo de configuración

A nivel de proyecto: .cursor/mcp.json en la raíz de tu proyecto
Global: ~/.cursor/mcp.json

Configuración

json

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

Éxito

Sustituye your-api-key-here por tu clave API real de la página de configuración para desarrolladores.

Una vez guardado, Cursor detectará automáticamente el servidor MCP y pondrá las herramientas a disposición en el asistente de IA.

Hola

Para utilizar el servidor Biscotti CMP MCP con Kiro, configúralo a través de los ajustes de MCP.

Ubicación del archivo de configuración

A nivel de proyecto: .kiro/settings/mcp.json en la raíz de tu proyecto
A nivel mundial: ~/.kiro/settings/mcp.json

Configuración

json

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

Éxito

Sustituye your-api-key-here por tu clave API real de la página de configuración para desarrolladores.

Kiro detectará automáticamente la configuración del servidor MCP y pondrá a disposición las herramientas de Biscotti CMP.

Otros clientes de MCP

El servidor Biscotti CMP MCP es compatible con cualquier cliente compatible con MCP. Utilice la siguiente configuración genérica:

Configuración general

json

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

Si tu cliente MCP utiliza un formato de configuración diferente, los parámetros clave son:

Comando: npx
Argumentos: -y @biscotti-cmp/mcp-server
Variable de entorno: BISCOTTI_API_KEY configurada con tu clave API

Éxito

Consulte la documentación del cliente MCP para conocer la ubicación y el formato exactos del archivo de configuración.

Herramientas disponibles

Gestión de sitios web

Herramientas para gestionar sus sitios web en Biscotti CMP.

list_websites

Listar todos los sitios web de su cuenta con su configuración y estado.

get_website

Obtener información detallada sobre un sitio web específico, incluidos los ajustes, los dominios y el estado del escaneo.

create_website

Crear un nuevo sitio web con dominio, nombre y opciones de configuración.

update_website

Actualizar la configuración del sitio web, como el nombre, el dominio o las opciones de configuración.

get_install_script

Obtener el fragmento de instalación de JavaScript para un sitio web, listo para pegar en su HTML.

Gestión de banners

Herramientas para crear y gestionar banners de consentimiento.

list_banners

Lista todos los banners de consentimiento para un sitio web.

get_banner

Obtén la configuración detallada del banner, incluyendo colores, textos y posicionamiento.

create_banner

Crea un nuevo banner de consentimiento con diseño personalizable y ajustes de comportamiento.

update_banner

Actualiza el diseño, los textos o la configuración del comportamiento de un banner existente.

delete_banner

Elimina un banner de consentimiento.

get_banner_embed

Obtén el código de inserción para un banner específico.

Análisis de cumplimiento

Herramientas para escanear sitios web y comprobar el estado de cumplimiento.

trigger_scan

Iniciar un nuevo escaneo de cumplimiento para un sitio web para detectar cookies, rastreadores y servicios de terceros.

list_scans

Listar escaneos de un sitio web, incluyendo las cookies y servicios detectados.

generate_compliance_report

Generar un informe de conformidad para un sitio web.

Análisis del consentimiento

Herramientas para acceder a estadísticas de consentimiento y datos analíticos.

get_consent_stats

Obtener estadísticas de consentimiento, incluidas las tasas de opt-in, la distribución del consentimiento y las tendencias a lo largo del tiempo.

export_consent_logs

Exportar registros de consentimiento detallados para auditorías e informes de conformidad. Utilice lookup_consent para buscar un registro de consentimiento único por su ID de consentimiento.

Documentos legales

Herramientas para gestionar documentos legales, como políticas de privacidad, condiciones de uso y avisos legales.

list_legal_documents

Enumera todos los documentos legales de un sitio web.

get_legal_document

Obtén el contenido y la configuración de un documento legal específico.

generate_legal_document

Genera un nuevo documento legal basado en la configuración y jurisdicción de tu sitio web.

Servicios

Herramientas para gestionar los servicios de terceros detectados y sus categorías de consentimiento.

list_services

Listar todos los servicios de terceros detectados para un sitio web.

update_service_category

Actualizar la categoría de consentimiento o la configuración de bloqueo de un servicio.

Webhooks

Herramientas para gestionar las integraciones de webhooks para notificaciones de eventos en tiempo real.

list_webhooks

Listar todos los webhooks configurados para su cuenta.

create_webhook

Crear un nuevo endpoint de webhook para recibir eventos de consentimiento (consent.granted, consent.revoked).

delete_webhook

Eliminar un endpoint de webhook.

test_webhook

Enviar un evento de prueba a un endpoint de webhook para verificar la conectividad.

Agencia

Herramientas para la gestión de cuentas de agencia y operaciones de clientes.

list_agency_clients

Listar todas las cuentas de clientes gestionadas por su agencia.

get_agency_usage

Obtener un informe de uso de todas las cuentas de clientes, incluidos los recuentos de sesiones y el uso de funciones.

create_agency_client

Crear una nueva cuenta de cliente bajo su agencia.

Recursos y sugerencias

Recursos de MCP

El servidor Biscotti CMP MCP pone a disposición los siguientes recursos que los asistentes de IA pueden consultar para obtener contexto:

biscotti://sitios web — Lista de todos los sitios web de tu cuenta
biscotti://website/{id} — Configuración detallada del sitio web
biscotti://compliance/{id} — Estado actual de cumplimiento de un sitio web
biscotti://banners/{websiteId} — Todos los banners de un sitio web

Los recursos proporcionan información de solo lectura que ayuda a los asistentes de IA a comprender tu configuración actual antes de realizar cambios.

Plantillas de indicaciones

El servidor MCP incluye plantillas de mensajes integradas para flujos de trabajo habituales:

Auditoría de cumplimiento

Realizar una auditoría de cumplimiento completa de un sitio web, analizando las cookies, comprobando la configuración del consentimiento y generando un informe.

text

Realiza una auditoría de cumplimiento en mi sitio web ejemplo.com y sugiere mejoras.

Configuración del banner

Crea y configura un banner de consentimiento con el diseño y los ajustes de comportamiento que prefieras.

text

Crea un banner de consentimiento compatible con el GDPR para mi sitio web con un tema oscuro y una posición inferior izquierda.

Elaboración de documentos jurídicos

Genera documentos legales en función de la configuración de tu sitio web y la jurisdicción de destino.

text

Genera una política de privacidad para mi sitio web alemán que cubra Google Analytics y Facebook Pixel.

Autenticación

Requisitos de la clave API

El servidor MCP de Biscotti CMP requiere una clave API para autenticarse en la API de Biscotti CMP. Todas las solicitudes realizadas por el servidor MCP se autentican mediante tu clave API.

Cómo funciona la autenticación

Puedes generar una clave API en la página «Configuración del desarrollador» del panel de control de Biscotti CMP.
La clave API se configura como la BISCOTTI_API_KEY en la configuración de tu cliente MCP.
El servidor MCP incluye esta clave como token Bearer en todas las solicitudes de API.
La API de Biscotti CMP valida la clave y devuelve datos específicos de tu cuenta.

Advertencia

Mantén tu clave API en secreto. No la incluyas en el control de versiones ni la compartas públicamente. Si se ve comprometida, cambia la clave inmediatamente desde la página de configuración del desarrollador.

Cómo obtener una clave API

Para obtener una clave API para el servidor MCP:

Inicia sesión en tu panel de control de Biscotti CMP en app.biscotti-cmp.com.
Ve a «Configuración para desarrolladores» en la barra lateral.
Haz clic en «Generar nueva clave» en la pestaña «Claves de API».
Asigna a tu clave un nombre descriptivo (por ejemplo, «Servidor MCP - Desarrollo»).
Si lo desea, establezca una fecha de caducidad para la clave.
Copia la clave generada inmediatamente; solo se mostrará una vez.

Éxito

Las claves API están disponibles en los planes Agency y LTD Agency. Si no ves la página de configuración para desarrolladores, es posible que tengas que cambiar a un plan superior.

Buenas prácticas clave en la gestión

Utiliza claves API distintas para los entornos de desarrollo y de producción.
Establece fechas de caducidad para las claves que se utilizan de forma temporal.
Renueve las claves periódicamente y revoque las que no se utilicen.
Utilice la función de rotación de llaves para sustituir las llaves sin interrumpir el servicio.