Dokumentacija MCP servera

Biscotti CMP MCP Server omogućava AI asistentima da programski interaguju sa vašim Biscotti CMP nalogom. Upravljajte veb-sajtovima, banerima, skeniranjima usklađenosti, analitikom pristanka, pravnim dokumentima i još mnogo toga — sve putem naredbi prirodnog jezika u vašem IDE-u.

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

Prerequisites

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

Quick Start

Najbrži način da započnete je korišćenjem npx — nije potrebna instalacija:

npx @biscotti-cmp/mcp-server

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

npx @biscotti-cmp/mcp-server

Ako preferirate da instalirate MCP Server globalno na svom sistemu:

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

Nakon instalacije, možete pokrenuti server direktno:

biscotti-mcp

Da biste koristili Biscotti CMP MCP Server sa Claude Desktop-om, dodajte sledeću konfiguraciju u datoteku sa podešavanjima za Claude Desktop.

Lokacija konfiguracione datoteke

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

Configuration

Dodajte sledeće u vašu konfiguracionu datoteku:

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

Ponovo pokrenite Claude Desktop nakon što sačuvate konfiguracionu datoteku. Biscotti CMP alati će se pojaviti u meniju alata.

Da biste koristili Biscotti CMP MCP Server sa Cursor-om, dodajte sledeću konfiguraciju u Cursor MCP podešavanja.

Lokacija konfiguracione datoteke

• Na nivou projekta: .cursor/mcp.json u korenu 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 čuvanja, Cursor će automatski detektovati MCP server i učiniti alate dostupnim u AI asistentu.

Da biste koristili Biscotti CMP MCP Server sa Kiro-om, konfigurišite ga kroz MCP podešavanja.

Lokacija konfiguracione datoteke

• Na nivou projekta: .kiro/settings/mcp.json u korenu 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 detektovati konfiguraciju MCP servera i učiniti Biscotti CMP alate dostupnim.

Biscotti CMP MCP Server je kompatibilan sa bilo kojim MCP klijentom. Koristite sledeć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
• Promenljiva okruženja: 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 proveru statusa usklađenosti.

Alati za pristup statistici saglasnosti i analitičkim podacima.

Alati za upravljanje pravnim dokumentima kao što su politike privatnosti, uslovi korišćenja usluge i imprint stranice.

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

Alati za upravljanje webhook integracijama za obaveštenja o događajima u realnom vremenu.

Alati za upravljanje nalozima klijenata i operacijama agencije.

Biscotti CMP MCP Server izlaže sledeće resurse koje AI asistenti mogu da čitaju za kontekst:

• biscotti://websites — Lista svih veb sajtova u vašem nalogu
• biscotti://website/{id} — Detaljna konfiguracija veb sajta
• biscotti://compliance/{id} — Trenutni status usklađenosti za veb sajt
• biscotti://banners/{websiteId} — Svi baneri za veb sajt

Resursi pružaju kontekst samo za čitanje koji pomaže AI asistentima da razumeju vaše trenutno podešavanje pre nego što izvrše promene.

MCP Server uključuje ugrađene šablone upita za uobičajene radne tokove:

Compliance Audit

Pokrenite potpunu reviziju usklađenosti na veb sajtu, skenirajući kolačiće, proveravajući konfiguraciju saglasnosti i generišući izveštaj.

Pokrenite reviziju usklađenosti na mom veb sajtu example.com i predložite poboljšanja.

Banner Setup

Kreirajte i konfigurišite baner saglasnosti sa željenim dizajnom i postavkama ponašanja.

Kreirajte baner saglasnosti usklađen sa GDPR za moj veb sajt sa tamnom temom i donjom levom pozicijom.

Generisanje pravnih dokumenata

Generišite pravne dokumente na osnovu konfiguracije vašeg veb sajta i ciljne jurisdikcije.

Generišite politiku privatnosti za moj nemački veb sajt koja pokriva Google Analytics i Facebook Pixel.

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

Kako funkcioniše autentifikacija

1. Generišete API ključ na stranici Developer Settings vaše Biscotti CMP kontrolne table.
2. API ključ je postavljen kao BISCOTTI_API_KEY promenljiva okruženja u vašoj MCP klijentskoj konfiguraciji.
3. MCP Server uključuje ovaj ključ kao Bearer token u svim API zahtevima.
4. Biscotti CMP API validira ključ i vraća podatke koji su obuhvaćeni vašim nalogom.

Da biste dobili API ključ za MCP server:

1. Prijavite se na kontrolnu tablu Biscotti CMP na app.biscotti-cmp.com.
2. Idite na Podešavanja za programere u bočnoj traci.
3. Kliknite na Generiši novi ključ na kartici API ključevi.
4. Dajte svom ključu opisno ime (npr. „MCP Server - Development“).
5. Opciono, postavite datum isteka za ključ.
6. Odmah kopirajte generisani ključ - biće prikazan samo jednom.

Najbolje prakse za upravljanje ključevima

• Koristite zasebne API ključeve za razvojno i proizvodno okruženje.
• Postavite datume isteka na ključeve koji se koriste privremeno.
• Redovno rotirajte ključeve i opozovite nekorišćene ključeve.
• Koristite funkciju rotacije ključeva da biste zamenili ključeve bez prekida rada.