Dokumentasjon for MCP-serveren

Biscotti CMP MCP-serveren gjør det mulig for AI-assistenter å kommunere med Biscotti CMP-kontoen din via programmering. Administrer nettsteder, bannere, samsvarssjekker, samtykkeanalyser, juridiske dokumenter og mye mer – alt ved hjelp av kommandoer i naturlig språk i utviklingsmiljøet ditt.

MCP-serveren (Model Context Protocol) fungerer som en bro mellom AI-assistenten din og Biscotti CMP API, og tilbyr et sett med verktøy som kan påkalles direkte fra utviklingsmiljøet ditt.

Forutsetninger

• Node.js 18 eller nyere
• En Biscotti CMP-konto med en Agency- eller LTD Agency-plan
• En API-nøkkel fra siden «Utviklerinnstillinger»

Hurtigstart

Den raskeste måten å komme i gang på er å bruke npx — ingen installasjon nødvendig:

npx @biscotti-cmp/mcp-server

Kjør MCP-serveren direkte uten å installere den globalt. Dette er den anbefalte fremgangsmåten for de fleste brukere:

npx @biscotti-cmp/mcp-server

Hvis du foretrekker å installere MCP-serveren globalt på systemet ditt:

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

Etter installasjon kan du kjøre serveren direkte:

biscotti-mcp

For å bruke Biscotti CMP MCP Server sammen med Claude Desktop, må du legge til følgende konfigurasjon i innstillingsfilen til Claude Desktop.

Plassering av konfigurasjonsfilen

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

Konfigurasjon

Legg til følgende i konfigurasjonsfilen din:

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

Start Claude Desktop på nytt etter at du har lagret konfigurasjonsfilen. Biscotti CMP-verktøyene vises da i verktøymenyen.

For å bruke Biscotti CMP MCP-serveren sammen med Cursor, må du legge til følgende konfigurasjon i Cursor MCP-innstillingene.

Plassering av konfigurasjonsfilen

• På prosjektnivå: .cursor/mcp.json i prosjektets rotkatalog
• Globalt: ~/.cursor/mcp.json

Konfigurasjon

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

Etter at du har lagret, vil Cursor automatisk oppdage MCP-serveren og gjøre verktøyene tilgjengelige i AI-assistenten.

For å bruke Biscotti CMP MCP-serveren sammen med Kiro, må du konfigurere den via MCP-innstillingene.

Plassering av konfigurasjonsfilen

• På prosjektnivå: .kiro/settings/mcp.json i prosjektets rotkatalog
• Globalt: ~/.kiro/settings/mcp.json

Konfigurasjon

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

Kiro vil automatisk oppdage MCP-serverkonfigurasjonen og gjøre Biscotti CMP-verktøyene tilgjengelige.

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

Generell konfigurasjon

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

Hvis MCP-klienten din bruker et annet konfigurasjonsformat, er de viktigste parametrene:

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

Verktøy for administrering av nettsidene dine i Biscotti CMP.

Verktøy for å opprette og administrere samtykkebannere.

Verktøy for skanning av nettsider og sjekk av overholdelse av personvern.

Verktøy for tilgang til samtykkestatistikk og analyse data.

Verktøy for håndtering av juridiske dokumenter som personvernerklæringer, bruksvilkår og sideinformasjon.

Verktøy for å administrere oppdagede tredjepartstjenester og deres samtykkekategorier.

Verktøy for administrering av webhook-integrasjoner for sanntidsvarsling om hendelser.

Verktøy for byråkontoadministrasjon og kundeoperasjoner.

Biscotti CMP MCP-serveren stiller følgende ressurser til rådighet, som AI-assistenter kan lese for å få kontekst:

• biscotti://websites — Liste over alle nettsteder i kontoen din
• biscotti://website/{id} — Detaljert konfigurasjon av nettstedet
• biscotti://compliance/{id} — Gjeldende samsvarsstatus for et nettsted
• biscotti://banners/{websiteId} — Alle bannere for et nettsted

Ressursene gir skrivebeskyttet informasjon som hjelper AI-assistenter med å forstå ditt nåværende oppsett før de foretar endringer.

MCP-serveren inneholder innebygde maler for kommandolinjeprompter til vanlige arbeidsflyter:

Overholdelsesrevisjon

Gjennomfør en fullstendig samsvarsrevisjon av et nettsted, der du søker etter informasjonskapsler, kontrollerer innstillingene for samtykke og genererer en rapport.

Kjør en samsvarsrevisjon på mitt nettsted example.com og foreslå forbedringer.

Konfigurering av banner

Opprett og konfigurer et samtykkebanner med dine foretrukne innstillinger for utseende og funksjonalitet.

Opprett et GDPR-kompatibelt samtykkebanner for mitt nettsted med et mørkt tema og plassering nederst til venstre.

Utarbeidelse av juridiske dokumenter

Generer juridiske dokumenter basert på konfigurasjonen av nettstedet ditt og den aktuelle jurisdiksjonen.

Generer en personvernerklæring for mitt tyske nettsted som dekker Google Analytics og Facebook Pixel.

Biscotti CMP MCP-serveren krever en API-nøkkel for å autentisere seg mot Biscotti CMP-API-et. Alle forespørsler fra MCP-serveren autentiseres ved hjelp av din API-nøkkel.

Slik fungerer autentisering

1. Du oppretter en API-nøkkel på siden «Utviklerinnstillinger» i Biscotti CMP-dashbordet.
2. API-nøkkelen er angitt som BISCOTTI_API_KEY miljøvariabel i MCP-klientkonfigurasjonen din.
3. MCP-serveren inkluderer denne nøkkelen som et Bearer-token i alle API-forespørsler.
4. Biscotti CMP API-et validerer nøkkelen og returnerer data som er knyttet til din konto.

Slik skaffer du deg en API-nøkkel for MCP-serveren:

1. Logg inn på Biscotti CMP-dashbordet ditt på app.biscotti-cmp.com.
2. Gå til «Utviklerinnstillinger» i sidepanelet.
3. Klikk på «Generer ny nøkkel» i fanen «API-nøkler».
4. Gi nøkkelen et beskrivende navn (f.eks. «MCP-server – Utvikling»).
5. Du kan eventuelt angi en utløpsdato for nøkkelen.
6. Kopier den genererte nøkkelen med en gang – den vises bare én gang.

Beste praksis for nøkkelhåndtering

• Bruk separate API-nøkler for utviklings- og produksjonsmiljøer.
• Angi utløpsdatoer for nøkler som brukes midlertidig.
• Bytt ut nøkler regelmessig og inndra nøkler som ikke er i bruk.
• Bruk funksjonen for nøkkelrotasjon til å bytte ut nøkler uten driftsavbrudd.