Documentación do servidor MCP

O servidor Biscotti CMP MCP permite que os asistentes de IA interactúen coa túa conta de Biscotti CMP de forma programática. Xestiona sitios web, banners, análises de cumprimento, análise de consentimento, documentos legais e moito máis, todo a través de comandos de linguaxe natural no teu IDE.

O servidor MCP (Model Context Protocol) actúa como unha ponte entre o teu asistente de IA e a API de Biscotti CMP, proporcionando un conxunto de ferramentas que se poden chamar directamente desde o teu contorno de desenvolvemento.

Prerequisites

• Node.js 18 or later
• Unha conta de Biscotti CMP cun plan Agency ou LTD Agency
• Unha clave API da páxina de configuracións de desenvolvedor

Quick Start

A forma máis rápida de comezar é usar npx; non se require instalación:

npx @biscotti-cmp/mcp-server

Executa o servidor MCP directamente sen instalalo globalmente. Este é o enfoque recomendado para a maioría dos usuarios:

npx @biscotti-cmp/mcp-server

Se prefire instalar o servidor MCP globalmente no seu sistema:

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

Tras a instalación, pode executar o servidor directamente:

biscotti-mcp

Para usar o servidor Biscotti CMP MCP con Claude Desktop, engade a seguinte configuración ao teu ficheiro de configuración de Claude Desktop.

Localización do ficheiro de configuración

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

Configuration

Engade o seguinte ao teu ficheiro de configuración:

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

Reinicia Claude Desktop despois de gardar o ficheiro de configuración. As ferramentas de Biscotti CMP aparecerán no menú de ferramentas.

Para usar o servidor Biscotti CMP MCP con Cursor, engade a seguinte configuración á túa configuración de Cursor MCP.

Localización do ficheiro de configuración

• Nivel de proxecto: .cursor/mcp.json no directorio raíz do teu proxecto
• Global: ~/.cursor/mcp.json

Configuration

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

Despois de gardar, Cursor detectará automaticamente o servidor MCP e fará que as ferramentas estean dispoñibles no asistente de IA.

Para usar o servidor Biscotti CMP MCP con Kiro, configúrao a través da configuración MCP.

Localización do ficheiro de configuración

• Nivel de proxecto: .kiro/settings/mcp.json no directorio raíz do teu proxecto
• 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á automaticamente a configuración do servidor MCP e fará que as ferramentas Biscotti CMP estean dispoñibles.

O servidor Biscotti CMP MCP é compatible con calquera cliente compatible con MCP. Use a seguinte configuración xenérica:

Configuración xenérica

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

Se o teu cliente MCP usa un formato de configuración diferente, os parámetros clave son:

• Comando: npx
• Argumentos: -y @biscotti-cmp/mcp-server
• Variable de contorno: BISCOTTI_API_KEY definida coa túa clave API

Ferramentas para xestionar os seus sitios web en Biscotti CMP.

Ferramentas para crear e xestionar banners de consentimento.

Ferramentas para escanear sitios web e comprobar o estado de conformidade.

Ferramentas para acceder ás estatísticas e os datos analíticos de consentimento.

Ferramentas para xestionar documentos legais como políticas de privacidade, termos de servizo e páxinas de aviso legal.

Ferramentas para xestionar os servizos de terceiros detectados e as súas categorías de consentimento.

Ferramentas para xestionar as integracións de webhook para notificacións de eventos en tempo real.

Ferramentas para a xestión de contas de clientes e as operacións da axencia.

O servidor MCP de Biscotti CMP expón os seguintes recursos que os asistentes de IA poden ler para obter contexto:

• biscotti://websites — Lista de todos os sitios web na túa conta
• biscotti://website/{id} — Configuración detallada do sitio web
• biscotti://compliance/{id} — Estado actual de cumprimento dun sitio web
• biscotti://banners/{websiteId} — Todos os banners dun sitio web

Os recursos proporcionan un contexto de só lectura que axuda aos asistentes de IA a comprender a túa configuración actual antes de realizar cambios.

O servidor MCP inclúe modelos de instrucións integrados para fluxos de traballo comúns:

Compliance Audit

Executa unha auditoría de cumprimento completa nun sitio web, buscando cookies, comprobando a configuración do consentimento e xerando un informe.

Executa unha auditoría de cumprimento no meu sitio web example.com e suxire melloras.

Banner Setup

Crea e configura un banner de consentimento co teu deseño e configuración de comportamento preferidos.

Crea un banner de consentimento compatible co GDPR para o meu sitio web cun tema escuro e unha posición inferior esquerda.

Xeración de documentos legais

Xera documentos legais baseados na configuración do teu sitio web e na xurisdición de destino.

Xera unha política de privacidade para o meu sitio web alemán que cobre Google Analytics e Facebook Pixel.

O servidor MCP de Biscotti CMP require unha clave API para autenticarse coa API de Biscotti CMP. Todas as solicitudes realizadas polo servidor MCP autentícanse mediante a túa clave API.

Como funciona a autenticación

1. Xeras unha clave API na páxina de Configuración de desenvolvedor do panel de control de Biscotti CMP.
2. A clave API está definida como a variable de entorno BISCOTTI_API_KEY na configuración do teu cliente MCP.
3. O servidor MCP inclúe esta clave como un token Bearer en todas as solicitudes da API.
4. A API de Biscotti CMP valida a clave e devolve datos limitados á túa conta.

Para obter unha clave API para o servidor MCP:

1. Inicia sesión no teu panel de control de Biscotti CMP en app.biscotti-cmp.com.
2. Navega a Configuración de desenvolvedor na barra lateral.
3. Fai clic en Xerar nova clave na pestana Claves API.
4. Dálle á túa clave un nome descritivo (por exemplo, "Servidor MCP - Desenvolvemento").
5. Opcionalmente, establece unha data de caducidade para a clave.
6. Copia a clave xerada inmediatamente; só se mostrará unha vez.

Prácticas recomendadas de xestión de claves

• Usa claves API separadas para os contornos de desenvolvemento e produción.
• Establece datas de caducidade nas claves que se usan temporalmente.
• Rota as claves regularmente e revoga as claves non utilizadas.
• Usa a función de rotación de claves para substituír as claves sen tempo de inactividade.