MCP Server Dokumentacija

Biscotti CMP MCP Server omogućuje AI asistentima interakciju s vašim Biscotti CMP računom programski. Upravljajte web stranicama, bannerima, skeniranjima usklađenosti, analitikom pristanka, pravnim dokumentima i više - sve putem naredbi prirodnog jezika u vašem IDE-u.

MCP (Model Context Protocol) Server djeluje kao most između vašeg AI asistenta i Biscotti CMP API-ja, pružajući skup alata koji se mogu pozvati izravno iz vašeg razvojnog okruženja.

Prerequisites

• Node.js 18 or later
• Biscotti CMP račun s Agency ili LTD Agency planom
• API ključ sa stranice Developer Settings

Quick Start

Najbrži način za početak je korištenje npx - nije potrebna instalacija:

npx @biscotti-cmp/mcp-server

Pokrenite MCP Server izravno bez globalne instalacije. Ovo je preporučeni pristup za većinu korisnika:

npx @biscotti-cmp/mcp-server

Ako preferirate globalnu instalaciju MCP Server-a na svom sistemu:

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

Nakon instalacije, možete direktno pokrenuti server:

biscotti-mcp

Da biste koristili Biscotti CMP MCP Server s Claude Desktopom, dodajte sljedeću konfiguraciju u svoju datoteku postavki Claude Desktopa.

Lokacija konfiguracijske datoteke

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

Configuration

Dodajte sljedeće u vašu konfiguracijsku datoteku:

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

Restartujte Claude Desktop nakon spremanja konfiguracijske datoteke. Biscotti CMP alati će se pojaviti u izborniku s alatima.

Da biste koristili Biscotti CMP MCP Server s Cursorom, dodajte sljedeću konfiguraciju u vaše Cursor MCP postavke.

Lokacija konfiguracijske datoteke

• Na razini projekta: .cursor/mcp.json u korijenu vašeg projekta
• Globalno: ~/.cursor/mcp.json

Configuration

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

Nakon spremanja, Cursor će automatski detektirati MCP server i učiniti alate dostupnima u AI asistentu.

Da biste koristili Biscotti CMP MCP Server s Kirom, konfigurirajte ga putem MCP postavki.

Lokacija konfiguracijske datoteke

• Na razini projekta: .kiro/settings/mcp.json u korijenu vašeg projekta
• Globalno: ~/.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 će automatski detektirati MCP server konfiguraciju i učiniti Biscotti CMP alate dostupnima.

Biscotti CMP MCP Server je kompatibilan sa bilo kojim MCP-compliant klijentom. Koristite sljedeću generičku konfiguraciju:

Generička konfiguracija

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

Ako vaš MCP klijent koristi drugačiji format konfiguracije, ključni parametri su:

• Komanda: npx
• Argumenti: -y @biscotti-cmp/mcp-server
• Varijabla okoline: BISCOTTI_API_KEY postavljena na vaš API ključ

Alati za upravljanje vašim web stranicama u Biscotti CMP-u.

Alati za kreiranje i upravljanje banerima za pristanak.

Alati za skeniranje web stranica i provjeru statusa usklađenosti.

Alati za pristup statistikama saglasnosti i analitičkim podacima.

Alati za upravljanje pravnim dokumentima kao što su pravila o privatnosti, uvjeti korištenja i stranice s impresumom.

Alati za upravljanje otkrivenim uslugama trećih strana i njihovim kategorijama pristanka.

Alati za upravljanje webhook integracijama za notifikacije u realnom vremenu.

Alati za upravljanje računima klijenata i operacijama agencije.

Biscotti CMP MCP Server izlaže sljedeće resurse koje AI asistenti mogu pročitati za kontekst:

• biscotti://websites — Popis svih web stranica na vašem računu
• biscotti://website/{id} — Detaljna konfiguracija web stranice
• biscotti://compliance/{id} — Trenutni status usklađenosti za web stranicu
• biscotti://banners/{websiteId} — Svi baneri za web stranicu

Resursi pružaju kontekst samo za čitanje koji pomaže AI asistentima da razumiju vaše trenutno postavljanje prije nego što naprave promjene.

MCP Server uključuje ugrađene predloške upita za uobičajene radne procese:

Compliance Audit

Pokrenite potpunu reviziju usklađenosti na web stranici, skenirajući kolačiće, provjeravajući konfiguraciju pristanka i generirajući izvještaj.

Pokrenite reviziju usklađenosti na mojoj web stranici example.com i predložite poboljšanja.

Banner Setup

Kreirajte i konfigurirajte banner za pristanak s vašim željenim postavkama dizajna i ponašanja.

Kreirajte banner za pristanak usklađen sa GDPR-om za moju web stranicu s tamnom temom i pozicijom dolje lijevo.

Generisanje pravnih dokumenata

Generišite pravne dokumente na osnovu konfiguracije vaše web stranice i ciljane jurisdikcije.

Generišite politiku privatnosti za moju njemačku web stranicu koja pokriva Google Analytics i Facebook Pixel.

Biscotti CMP MCP Server zahtijeva API ključ za autentifikaciju s Biscotti CMP API-jem. Svi zahtjevi koje MCP Server šalje autentifikuju se pomoću vašeg API ključa.

Kako funkcionira autentifikacija

1. Generišete API ključ na stranici Developers Settings (Postavke za programere) na kontrolnoj ploči Biscotti CMP.
2. API ključ se postavlja kao varijabla okruženja BISCOTTI_API_KEY u konfiguraciji vašeg MCP klijenta.
3. MCP Server uključuje ovaj ključ kao Bearer token u svim API zahtjevima.
4. Biscotti CMP API validira ključ i vraća podatke koji su u opsegu vašeg računa.

Da biste dobili API ključ za MCP Server:

1. Prijavite se na svoju Biscotti CMP nadzornu ploču na app.biscotti-cmp.com.
2. Idite na Postavke za programere u bočnoj traci.
3. Kliknite Generiraj novi ključ u kartici API ključevi.
4. Dajte svom ključu opisno ime (npr. "MCP Server - Razvoj").
5. Po želji postavite datum isteka za ključ.
6. Odmah kopirajte generirani ključ - bit će prikazan samo jednom.

Najbolje prakse upravljanja ključevima

• Koristite zasebne API ključeve za razvojno i produkcijsko okruženje.
• Postavite datume isteka na ključeve koji se koriste privremeno.
• Redovito rotirajte ključeve i opozovite neiskorištene ključeve.
• Koristite značajku rotacije ključeva za zamjenu ključeva bez prekida rada.