Dokumentation för MCP-servern

Med Biscotti CMP MCP Server kan AI-assistenter interagera med ditt Biscotti CMP-konto via programmering. Hantera webbplatser, banners, efterlevnadskontroller, analys av samtycken, juridiska dokument och mycket mer – allt genom kommandon på naturligt språk i din IDE.

MCP-servern (Model Context Protocol) fungerar som en brygga mellan din AI-assistent och Biscotti CMP API och tillhandahåller en uppsättning verktyg som kan anropas direkt från din utvecklingsmiljö.

Förutsättningar

• Node.js 18 eller senare
• Ett Biscotti CMP-konto med ett Agency- eller LTD Agency-abonnemang
• En API-nyckel från sidan Utvecklarinställningar

Snabbstart

Det snabbaste sättet att komma igång är att använda npx — ingen installation krävs:

npx @biscotti-cmp/mcp-server

Kör MCP-servern direkt utan att installera den globalt. Detta är den metod som rekommenderas för de flesta användare:

npx @biscotti-cmp/mcp-server

Om du föredrar att installera MCP-servern globalt på ditt system:

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

Efter installation kan du köra servern direkt:

biscotti-mcp

För att använda Biscotti CMP MCP Server tillsammans med Claude Desktop ska du lägga till följande konfiguration i din inställningsfil för Claude Desktop.

Plats för konfigurationsfilen

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

Inställningar

Lägg till följande i din konfigurationsfil:

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

Starta om Claude Desktop efter att du har sparat konfigurationsfilen. Biscotti CMP-verktygen visas då i verktygsmenyn.

För att använda Biscotti CMP MCP-servern med Cursor ska du lägga till följande konfiguration i dina Cursor MCP-inställningar.

Plats för konfigurationsfilen

• På projektnivå: .cursor/mcp.json i projektets rotkatalog
• Globalt: ~/.cursor/mcp.json

Inställningar

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

När du har sparat kommer Cursor automatiskt att upptäcka MCP-servern och göra verktygen tillgängliga i AI-assistenten.

För att använda Biscotti CMP MCP Server tillsammans med Kiro måste du konfigurera den via MCP-inställningarna.

Plats för konfigurationsfilen

• På projektnivå: .kiro/settings/mcp.json i projektets rotkatalog
• Globalt: ~/.kiro/settings/mcp.json

Inställningar

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

Kiro kommer automatiskt att identifiera MCP-serverns konfiguration och göra Biscotti CMP-verktygen tillgängliga.

Biscotti CMP MCP-servern är kompatibel med alla MCP-kompatibla klienter. Använd följande generiska konfiguration:

Allmän konfiguration

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

Om din MCP-klient använder ett annat konfigurationsformat är de viktigaste parametrarna:

• Kommando: npx
• Argument: -y @biscotti-cmp/mcp-server
• Miljövariabel: BISCOTTI_API_KEY ställ in din API-nyckel

Verktyg för hantering av dina webbplatser i Biscotti CMP.

Verktyg för att skapa och hantera samtyckesbanners.

Verktyg för att skanna webbplatser och kontrollera efterlevnadsstatus.

Verktyg för att komma åt samtyckesstatistik och analysdata.

Verktyg för hantering av juridiska dokument, såsom integritetspolicyer, användarvillkor och sidor med utgivningsuppgifter.

Verktyg för att hantera upptäckta tredjepartstjänster och deras samtyckeskategorier.

Verktyg för hantering av webhook-integrationer för realtidsnotifieringar.

Verktyg för byråkontohantering och klientoperationer.

Biscotti CMP MCP-servern tillhandahåller följande resurser som AI-assistenter kan använda för att få sammanhang:

• biscotti://webbplatser — Lista över alla webbplatser i ditt konto
• biscotti://webbplats/{id} — Detaljerad webbplatskonfiguration
• biscotti://compliance/{id} — Aktuell efterlevnadsstatus för en webbplats
• biscotti://banners/{websiteId} — Alla banners för en webbplats

Resurser tillhandahåller skrivskyddad information som hjälper AI-assistenterna att förstå din nuvarande konfiguration innan de gör ändringar.

MCP-servern innehåller inbyggda mallar för vanliga arbetsflöden:

Efterlevnadsgranskning

Genomför en fullständig efterlevnadsgranskning av en webbplats genom att söka efter cookies, kontrollera inställningarna för samtycke och skapa en rapport.

Kör en efterlevnadsgranskning på min webbplats example.com och föreslå förbättringar.

Inställning av banner

Skapa och konfigurera en samtyckesbanner med önskad design och önskade inställningar.

Skapa en GDPR-kompatibel samtyckesbanner för min webbplats med ett mörkt tema och positionering längst ner till vänster.

Upprättande av juridiska dokument

Skapa juridiska dokument utifrån din webbplats konfiguration och den jurisdiktion som gäller.

Generera en integritetspolicy för min tyska webbplats som täcker Google Analytics och Facebook Pixel.

Biscotti CMP MCP-servern kräver en API-nyckel för att kunna autentisera sig mot Biscotti CMP API. Alla förfrågningar som görs av MCP-servern autentiseras med hjälp av din API-nyckel.

Hur autentisering fungerar

1. Du skapar en API-nyckel på sidan ”Utvecklarinställningar” i din Biscotti CMP-kontrollpanel.
2. API-nyckeln anges som BISCOTTI_API_KEY miljövariabel i din MCP-klientkonfiguration.
3. MCP-servern inkluderar denna nyckel som ett Bearer-token i alla API-förfrågningar.
4. Biscotti CMP API validerar nyckeln och returnerar data som är begränsade till ditt konto.

Så här skaffar du en API-nyckel för MCP-servern:

1. Logga in på din Biscotti CMP-kontrollpanel på app.biscotti-cmp.com.
2. Gå till ”Utvecklingsinställningar” i sidomenyn.
3. Klicka på ”Skapa ny nyckel” på fliken API-nycklar.
4. Ge din nyckel ett beskrivande namn (t.ex. ”MCP-server – Utveckling”).
5. Du kan välja att ange ett utgångsdatum för nyckeln.
6. Kopiera den genererade nyckeln omedelbart – den visas bara en gång.

Bästa praxis för nyckelhantering

• Använd separata API-nycklar för utvecklings- och produktionsmiljöer.
• Ange utgångsdatum för nycklar som används tillfälligt.
• Byt ut nycklar regelbundet och återkalla nycklar som inte används.
• Använd funktionen för nyckelrotation för att byta ut nycklar utan driftstopp.