Dokumentacija za MCP poslužitelj

Biscotti CMP MCP Server omogućuje AI asistentima programsku interakciju s vašim Biscotti CMP računom. Upravljajte web-stranicama, bannerima, skeniranjima usklađenosti, analizom suglasnosti, pravnim dokumentima i još mnogo toga — sve putem naredbi prirodnog jezika u vašem IDE-u.

MCP (Model Context Protocol) poslužitelj djeluje kao most između vašeg AI asistenta i Biscotti CMP API-ja, pružajući skup alata koje možete izravno pozvati iz svog razvojnog okruženja.

Preduvjeti

• Node.js 18 ili noviji
• Biscotti CMP račun s planom Agencija ili LTD Agencija
• API ključ s stranice Postavke za programere

Brzi početak

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

npx @biscotti-cmp/mcp-server

Pokrenite MCP poslužitelj izravno, bez globalne instalacije. Ovo je preporučeni pristup za većinu korisnika:

npx @biscotti-cmp/mcp-server

Ako želite globalno instalirati MCP poslužitelj na svom sustavu:

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

Nakon instalacije možete izravno pokrenuti poslužitelj:

biscotti-mcp

Da biste koristili Biscotti CMP MCP poslužitelj 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
• Windowsi: %APPDATA%\Claude\claude_desktop_config.json

Konfiguracija

Dodajte sljedeće u svoju konfiguracijsku datoteku:

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

Ponovno pokrenite Claude Desktop nakon spremanja konfiguracijske datoteke. Alati Biscotti CMP pojavit će se u izborniku alata.

Da biste koristili Biscotti CMP MCP poslužitelj s Cursorom, dodajte sljedeću konfiguraciju u svoje Cursor MCP postavke.

Lokacija konfiguracijske datoteke

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

Konfiguracija

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

Nakon spremanja, Cursor će automatski otkriti MCP poslužitelj i omogućiti alate u AI asistentu.

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

Lokacija konfiguracijske datoteke

• Na razini projekta: .kiro/settings/mcp.json u korijenskom direktoriju vašeg projekta
• Globalno: ~/.kiro/settings/mcp.json

Konfiguracija

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

Kiro će automatski otkriti konfiguraciju MCP poslužitelja i omogućiti alate Biscotti CMP.

Biscotti CMP MCP poslužitelj je kompatibilan sa svakim klijentom usklađenim s MCP-om. Koristite sljedeću generičku konfiguraciju:

Opća 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:

• Zapovijed: npx
• Argumenti: -y @biscotti-cmp/mcp-server
• Promjenjiva okruženja: BISCOTTI_API_KEY postavite na svoj API ključ

Alati za upravljanje svojim web mjestima u Biscotti CMP-u.

Alati za izradu i upravljanje bannerima za privolu.

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

Alati za pristup statistikama pristanka i analitičkim podacima.

Alati za upravljanje pravnim dokumentima kao što su pravila o privatnosti, uvjeti pružanja usluge i stranice s pravnim obavijestima.

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

Alati za upravljanje webhook integracijama za obavijesti o događajima u stvarnom vremenu.

Alati za upravljanje računima klijenata i operacijama agencije.

Poslužitelj Biscotti CMP MCP izlaže sljedeće resurse koje AI asistenti mogu č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 samo za čitanje kontekst koji pomaže AI asistentima da razumiju vašu trenutnu konfiguraciju prije izvođenja promjena.

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

Revizija usklađenosti

Provedite potpunu reviziju usklađenosti web-stranice, skenirajući kolačiće, provjeravajući konfiguraciju privola i generirajući izvješće.

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

Postavljanje banera

Stvorite i konfigurirajte banner za davanje pristanka s dizajnom i postavkama ponašanja po vašem izboru.

Stvorite GDPR-usuglašeni banner za pristanak za moju web stranicu s tamnom temom i donjom lijevom pozicijom.

Generiranje pravnih dokumenata

Generirajte pravne dokumente na temelju konfiguracije vaše web stranice i ciljane jurisdikcije.

Generirajte pravila o privatnosti za moju njemačku web stranicu koja pokrivaju Google Analytics i Facebook Pixel.

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

Kako funkcionira autentifikacija

1. Generirate API ključ na stranici Postavke za programere na svojoj nadzornoj ploči Biscotti CMP.
2. API ključ je postavljen kao BISCOTTI_API_KEY varijabla okruženja u konfiguraciji vašeg MCP klijenta.
3. MCP poslužitelj uključuje ovaj ključ kao Bearer token u svim API zahtjevima.
4. Biscotti CMP API provjerava ključ i vraća podatke ograničene na vaš račun.

Kako dobiti API ključ za MCP poslužitelj:

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

Najbolje prakse upravljanja ključevima

• Koristite odvojene API ključeve za razvojno i produkcijsko okruženje.
• Postavite datume isteka za 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 zastoja.