MCP-serverdokumentation

Med Biscotti CMP MCP Server kan AI-assistenter interagere med din Biscotti CMP-konto via programmering. Administrer hjemmesider, bannere, compliance-scanninger, samtykkeanalyser, juridiske dokumenter og meget mere – alt sammen ved hjælp af kommandoer på naturligt sprog i din IDE.

MCP-serveren (Model Context Protocol) fungerer som en bro mellem din AI-assistent og Biscotti CMP API og stiller et sæt værktøjer til rådighed, som kan kaldes direkte fra dit udviklingsmiljø.

Forudsætninger

• Node.js 18 eller nyere
• En Biscotti CMP-konto med en Agency- eller LTD Agency-pakke
• En API-nøgle fra siden »Udviklerindstillinger«

Hurtig start

Den hurtigste måde at komme i gang på er ved at bruge npx — ingen installation kræves:

npx @biscotti-cmp/mcp-server

Kør MCP-serveren direkte uden at installere den globalt. Dette er den anbefalede fremgangsmåde for de fleste brugere:

npx @biscotti-cmp/mcp-server

Hvis du foretrækker at installere MCP-serveren globalt på dit system:

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

Efter installation kan du køre serveren direkte:

biscotti-mcp

For at bruge Biscotti CMP MCP-serveren sammen med Claude Desktop skal du tilføje følgende konfiguration til din Claude Desktop-indstillingsfil.

Placering af konfigurationsfilen

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

Konfiguration

Indsæt følgende i din konfigurationsfil:

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

Genstart Claude Desktop, når du har gemt konfigurationsfilen. Biscotti CMP-værktøjerne vises nu i værktøjsmenuen.

For at bruge Biscotti CMP MCP-serveren sammen med Cursor skal du tilføje følgende konfiguration til dine Cursor MCP-indstillinger.

Placering af konfigurationsfilen

• På projektniveau: .cursor/mcp.json i din projektmappe
• Global: ~/.cursor/mcp.json

Konfiguration

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

Når du har gemt, registrerer Cursor automatisk MCP-serveren og gør værktøjerne tilgængelige i AI-assistenten.

For at bruge Biscotti CMP MCP-serveren sammen med Kiro skal du konfigurere den via MCP-indstillingerne.

Placering af konfigurationsfilen

• På projektniveau: .kiro/settings/mcp.json i din projektmappe
• Globalt: ~/.kiro/settings/mcp.json

Konfiguration

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

Kiro registrerer automatisk MCP-serverkonfigurationen og gør Biscotti CMP-værktøjerne tilgængelige.

Biscotti CMP MCP-serveren er kompatibel med alle MCP-kompatible klienter. Brug følgende generiske konfiguration:

Generel konfiguration

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

Hvis din MCP-klient bruger et andet konfigurationsformat, er de vigtigste parametre:

• Kommando: npx
• Argumenter: -y @biscotti-cmp/mcp-server
• Miljøvariabel: BISCOTTI_API_KEY indstil til din API-nøgle

Værktøjer til administration af dine hjemmesider i Biscotti CMP.

Værktøjer til oprettelse og administration af samtykkebannere.

Værktøjer til scanning af hjemmesider og tjek af overholdelsesstatus.

Værktøjer til adgang til samtykkestatistik og analyse-data.

Værktøjer til administration af juridiske dokumenter såsom privatlivspolitikker, servicevilkår og sideoplysninger.

Værktøjer til administration af registrerede tredjepartstjenester og deres samtykkekategorier.

Værktøjer til administration af webhook-integrationer til realtidsbegivenhedsnotifikationer.

Værktøjer til bureaukontoadministration og klientdrift.

Biscotti CMP MCP-serveren stiller følgende ressourcer til rådighed, som AI-assistenter kan læse for at få kontekst:

• biscotti://websteder — Liste over alle websteder på din konto
• biscotti://website/{id} — Detaljeret konfiguration af hjemmesiden
• biscotti://compliance/{id} — Aktuel overholdelsesstatus for et websted
• biscotti://banners/{websiteId} — Alle bannere til et websted

Ressourcerne indeholder skrivebeskyttet kontekst, der hjælper AI-assistenter med at forstå din nuværende opsætning, inden der foretages ændringer.

MCP-serveren indeholder indbyggede promptskabeloner til almindelige arbejdsgange:

Overensstemmelsesrevision

Udfør en fuldstændig overensstemmelseskontrol af et websted, hvor der scannes efter cookies, kontrolleres indstillingerne for samtykke og udarbejdes en rapport.

Kør en compliance-audit på mit websted example.com og foreslå forbedringer.

Opsætning af banner

Opret og konfigurer et samtykkebanner med dit foretrukne design og dine foretrukne indstillinger.

Opret et GDPR-kompatibelt samtykkebanner til mit websted med et mørkt tema og nederste venstre position.

Udarbejdelse af juridiske dokumenter

Udarbejd juridiske dokumenter på baggrund af din hjemmesides konfiguration og den relevante jurisdiktion.

Generer en privatlivspolitik for mit tyske websted, der dækker Google Analytics og Facebook Pixel.

Biscotti CMP MCP-serveren kræver en API-nøgle for at kunne godkende adgangen til Biscotti CMP API. Alle anmodninger, der sendes fra MCP-serveren, godkendes ved hjælp af din API-nøgle.

Sådan fungerer godkendelse

1. Du opretter en API-nøgle på siden »Udviklerindstillinger« i dit Biscotti CMP-dashboard.
2. API-nøglen er angivet som BISCOTTI_API_KEY miljøvariabel i din MCP-klientkonfiguration.
3. MCP-serveren inkluderer denne nøgle som et Bearer-token i alle API-anmodninger.
4. Biscotti CMP API'en validerer nøglen og returnerer data, der er begrænset til din konto.

Sådan får du en API-nøgle til MCP-serveren:

1. Log ind på dit Biscotti CMP-kontrolpanel på app.biscotti-cmp.com.
2. Gå til »Udviklerindstillinger« i sidepanelet.
3. Klik på »Generer ny nøgle« under fanen »API-nøgler«.
4. Giv din nøgle et beskrivende navn (f.eks. »MCP-server – Udvikling«).
5. Du kan eventuelt angive en udløbsdato for nøglen.
6. Kopier den genererede nøgle med det samme – den vises kun én gang.

Bedste praksis inden for nøgleadministration

• Brug separate API-nøgler til udviklings- og produktionsmiljøer.
• Angiv udløbsdatoer for nøgler, der kun bruges midlertidigt.
• Skift nøglerne regelmæssigt, og tilbagekald nøgler, der ikke længere er i brug.
• Brug funktionen til nøgleudskiftning til at udskifte nøgler uden driftsafbrydelser.