Documentazione del server MCP

Il server Biscotti CMP MCP consente agli assistenti AI di interagire con il tuo account Biscotti CMP in modo programmatico. Gestisci siti web, banner, controlli di conformità, analisi dei consensi, documenti legali e molto altro ancora, il tutto tramite comandi in linguaggio naturale direttamente dal tuo IDE.

Il server MCP (Model Context Protocol) funge da ponte tra il tuo assistente IA e l'API Biscotti CMP, fornendo una serie di strumenti che possono essere richiamati direttamente dal tuo ambiente di sviluppo.

Prerequisiti

• Node.js 18 o versioni successive
• Un account Biscotti CMP con un piano "Agency" o "LTD Agency"
• Una chiave API dalla pagina Impostazioni sviluppatore

Guida rapida

Il modo più veloce per iniziare è utilizzare npx — non è richiesta alcuna installazione:

npx @biscotti-cmp/mcp-server

Esegui il server MCP direttamente senza installarlo a livello di sistema. Questo è l'approccio consigliato per la maggior parte degli utenti:

npx @biscotti-cmp/mcp-server

Se preferisci installare MCP Server a livello globale sul tuo sistema:

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

Una volta completata l'installazione, è possibile avviare direttamente il server:

biscotti-mcp

Per utilizzare il server Biscotti CMP MCP con Claude Desktop, aggiungi la seguente configurazione al file delle impostazioni di Claude Desktop.

Percorso del file di configurazione

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

Configurazione

Aggiungi quanto segue al tuo file di configurazione:

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

Riavvia Claude Desktop dopo aver salvato il file di configurazione. Gli strumenti Biscotti CMP appariranno nel menu Strumenti.

Per utilizzare il server Biscotti CMP MCP con Cursor, aggiungi la seguente configurazione alle impostazioni di Cursor MCP.

Percorso del file di configurazione

• A livello di progetto: .cursor/mcp.json nella directory principale del progetto
• ~/.cursor/mcp.json

Configurazione

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

Una volta salvato, Cursor rileverà automaticamente il server MCP e renderà disponibili gli strumenti nell'assistente AI.

Per utilizzare il server Biscotti CMP MCP con Kiro, configurarlo tramite le impostazioni MCP.

Percorso del file di configurazione

• A livello di progetto: .kiro/settings/mcp.json nella directory principale del progetto
• A livello globale: ~/.kiro/settings/mcp.json

Configurazione

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

Kiro rileverà automaticamente la configurazione del server MCP e renderà disponibili gli strumenti Biscotti CMP.

Il server Biscotti CMP MCP è compatibile con qualsiasi client conforme allo standard MCP. Utilizzare la seguente configurazione generica:

Configurazione generale

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

Se il tuo client MCP utilizza un formato di configurazione diverso, i parametri chiave sono:

• Comando: npx
• Argomenti: -y @biscotti-cmp/mcp-server
• Variabile d'ambiente: BISCOTTI_API_KEY impostare con la propria chiave API

Strumenti per la gestione dei tuoi siti web in Biscotti CMP.

Strumenti per la creazione e la gestione dei banner di consenso.

Strumenti per l'analisi dei siti web e la verifica dello stato di conformità.

Strumenti per accedere alle statistiche sul consenso e ai dati analitici.

Strumenti per la gestione di documenti legali quali informative sulla privacy, condizioni di servizio e note legali.

Strumenti per la gestione dei servizi di terze parti rilevati e delle loro categorie di consenso.

Strumenti per la gestione delle integrazioni webhook per le notifiche in tempo reale degli eventi.

Strumenti per la gestione dei conti delle agenzie e delle operazioni relative ai clienti.

Il server Biscotti CMP MCP mette a disposizione le seguenti risorse che gli assistenti AI possono consultare per contestualizzare:

• biscotti://siti web — Elenco di tutti i siti web presenti nel tuo account
• biscotti://website/{id} — Configurazione dettagliata del sito web
• biscotti://compliance/{id} — Stato attuale della conformità di un sito web
• biscotti://banners/{websiteId} — Tutti i banner di un sito web

Le risorse forniscono un contesto di sola lettura che aiuta gli assistenti AI a comprendere la configurazione attuale prima di apportare modifiche.

Il server MCP include modelli di prompt integrati per i flussi di lavoro più comuni:

Verifica di conformità

Esegui una verifica completa della conformità di un sito web, individuando i cookie, controllando le impostazioni relative al consenso e generando un rapporto.

Esegui un audit di conformità sul mio sito web example.com e suggerisci miglioramenti.

Configurazione del banner

Crea e configura un banner di consenso con il design e le impostazioni di funzionamento che preferisci.

Crea un banner di consenso conforme al GDPR per il mio sito web con un tema scuro e una posizione in basso a sinistra.

Generazione di documenti legali

Genera documenti legali in base alla configurazione del tuo sito web e alla giurisdizione di riferimento.

Genera una politica sulla privacy per il mio sito web tedesco che copra Google Analytics e Facebook Pixel.

Il server MCP di Biscotti CMP richiede una chiave API per l'autenticazione con l'API di Biscotti CMP. Tutte le richieste effettuate dal server MCP vengono autenticate utilizzando la tua chiave API.

Come funziona l'autenticazione

1. Puoi generare una chiave API nella pagina "Impostazioni sviluppatore" della tua dashboard Biscotti CMP.
2. La chiave API è impostata come BISCOTTI_API_KEY nella configurazione del client MCP.
3. Il server MCP include questa chiave come token Bearer in tutte le richieste API.
4. L'API Biscotti CMP verifica la validità della chiave e restituisce i dati relativi al tuo account.

Per ottenere una chiave API per il server MCP:

1. Accedi alla tua dashboard di Biscotti CMP all'indirizzo app.biscotti-cmp.com.
2. Accedi alle Impostazioni sviluppatore nella barra laterale.
3. Fai clic su "Genera nuova chiave" nella scheda "Chiavi API".
4. Assegna alla tua chiave un nome descrittivo (ad es. "Server MCP - Sviluppo").
5. Se lo si desidera, è possibile impostare una data di scadenza per la chiave.
6. Copia subito la chiave generata: verrà visualizzata una sola volta.

Migliori pratiche per la gestione delle chiavi

• Utilizza chiavi API distinte per gli ambienti di sviluppo e di produzione.
• Imposta delle date di scadenza per le chiavi utilizzate temporaneamente.
• Sostituire periodicamente le chiavi e revocare quelle non utilizzate.
• Utilizza la funzione di rotazione delle chiavi per sostituire le chiavi senza tempi di inattività.