Dokumentacija strežnika MCP

Strežnik Biscotti CMP MCP omogoča AI-pomočnikom, da programsko komunicirajo z vašim računom Biscotti CMP. Upravljajte spletne strani, pasice, preglede skladnosti, analitiko soglasij, pravne dokumente in še več – vse to prek ukazov v naravnem jeziku v vašem razvojnem okolju.

Strežnik MCP (Model Context Protocol) deluje kot most med vašim AI-pomočnikom in API-jem Biscotti CMP ter ponuja niz orodij, ki jih lahko neposredno pokličete iz svojega razvojnega okolja.

Predpogoji

• Node.js 18 ali novejša različica
• Račun Biscotti CMP z načrtom »Agency« ali »LTD Agency«
• API ključ s strani »Nastavitve za razvijalce«

Hitri začetek

Najhitrejši način za začetek je uporaba npx — namestitev ni potrebna:

npx @biscotti-cmp/mcp-server

Zagnajte strežnik MCP neposredno, brez globalne namestitve. To je priporočeni način za večino uporabnikov:

npx @biscotti-cmp/mcp-server

Če želite namestiti strežnik MCP globalno na svojem sistemu:

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

Po namestitvi lahko strežnik neposredno zaženete:

biscotti-mcp

Če želite uporabljati strežnik Biscotti CMP MCP s programom Claude Desktop, v datoteko z nastavitvami programa Claude Desktop vnesite naslednjo konfiguracijo.

Mesto shranitve konfiguracijske datoteke

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

Nastavitve

V konfiguracijsko datoteko dodajte naslednje:

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

Po shranitvi konfiguracijske datoteke ponovno zaženite program Claude Desktop. Orodja Biscotti CMP se bodo prikazala v meniju Orodja.

Če želite uporabljati strežnik Biscotti CMP MCP skupaj s programom Cursor, v nastavitve programa Cursor MCP vnesite naslednjo konfiguracijo.

Mesto shranitve konfiguracijske datoteke

• Na ravni projekta: .cursor/mcp.json v korenskem imeniku projekta
• Globalno: ~/.cursor/mcp.json

Nastavitve

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

Po shranitvi bo Cursor samodejno zaznal strežnik MCP in omogočil dostop do orodij v AI-pomočniku.

Če želite uporabljati strežnik Biscotti CMP MCP v povezavi s programom Kiro, ga nastavite v nastavitvah MCP.

Mesto shranitve konfiguracijske datoteke

• Na ravni projekta: .kiro/settings/mcp.json v korenskem imeniku projekta
• Na svetovni ravni: ~/.kiro/settings/mcp.json

Nastavitve

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

Kiro bo samodejno zaznal konfiguracijo strežnika MCP in omogočil dostop do orodij Biscotti CMP.

Strežnik Biscotti CMP MCP je združljiv z vsemi odjemalci, ki podpirajo protokol MCP. Uporabite naslednjo splošno konfiguracijo:

Splošna konfiguracija

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

Če vaš MCP-odjemalec uporablja drugačen format konfiguracije, so ključni parametri naslednji:

• Ukaz: npx
• Argumenti: -y @biscotti-cmp/mcp-server
• Okoljska spremenljivka: BISCOTTI_API_KEY nastavite na svoj API ključ

Orodja za upravljanje vaših spletnih strani v Biscotti CMP.

Orodja za ustvarjanje in upravljanje pasic za pridobivanje soglasja.

Orodja za preiskavo spletnih strani in preverjanje stanja usklajenosti.

Orodja za dostop do statistike soglasij in analitičnih podatkov.

Orodja za upravljanje pravnih dokumentov, kot so politike zasebnosti, pogoji uporabe in strani z informacijami o izdajatelju.

Orodja za upravljanje zaznanih storitev tretjih oseb in njihovih kategorij privolitve.

Orodja za upravljanje integracij webhook za dogodke v realnem času.

Orodja za upravljanje računov strank in operacij za agencije.

Strežnik Biscotti CMP MCP omogoča dostop do naslednjih virov, ki jih lahko AI-pomočniki uporabijo za razumevanje konteksta:

• biscotti://spletne strani — Seznam vseh spletnih strani v tvojem računu
• biscotti://website/{id} — Podrobna konfiguracija spletnega mesta
• biscotti://compliance/{id} — Trenutno stanje skladnosti spletnega mesta
• biscotti://banners/{websiteId} — Vsi pasici za spletno stran

Viri zagotavljajo kontekst, ki je na voljo le za branje in ki umetnim inteligencam pomaga razumeti vašo trenutno nastavitev, preden izvedejo spremembe.

Strežnik MCP vsebuje vgrajene predloge za pozive za pogoste delovne tokove:

Revizija skladnosti

Opravite celovito preverjanje skladnosti spletnega mesta, pri čemer poiščite piškotke, preverite nastavitve soglasja in pripravite poročilo.

Zaženite revizijo skladnosti na mojem spletnem mestu example.com in predlagajte izboljšave.

Nastavitev pasice

Ustvarite in nastavite pasico za soglasje z želenim videzom in nastavitvami delovanja.

Ustvarite pasico za soglasje, ki je skladna z GDPR, za moje spletno mesto s temno temo in položajem spodaj levo.

Priprava pravnih dokumentov

Ustvarite pravne dokumente na podlagi nastavitev vaše spletne strani in ciljne pravne ureditve.

Ustvarite pravilnik o zasebnosti za moje nemško spletno mesto, ki zajema Google Analytics in Facebook Pixel.

Strežnik Biscotti CMP MCP potrebuje ključ API za avtentifikacijo v vmesniku API Biscotti CMP. Vsa poizvedovanja, ki jih izvede strežnik MCP, se avtentificirajo z vašim ključem API.

Kako deluje avtentifikacija

1. API ključ ustvarite na strani »Nastavitve za razvijalce« v nadzorni plošči Biscotti CMP.
2. API ključ je nastavljen kot BISCOTTI_API_KEY okoljska spremenljivka v konfiguraciji vašega MCP odjemalca.
3. Strežnik MCP ta ključ vključi kot žeton Bearer v vsa zahtevka API.
4. API Biscotti CMP preveri veljavnost ključa in vrne podatke, ki se nanašajo na vaš račun.

Če želite pridobiti API ključ za strežnik MCP:

1. Prijavite se v nadzorno ploščo Biscotti CMP na naslovu app.biscotti-cmp.com.
2. V stranskem meniju odprite nastavitve za razvijalce.
3. V zavihku »API ključi« kliknite »Ustvari nov ključ«.
4. Dajte ključu opisno ime (npr. »MCP Server – Razvoj«).
5. Po želji lahko nastavite datum poteka veljavnosti ključa.
6. Takoj si zapišite ustvarjeni ključ – prikazan bo le enkrat.

Najboljše prakse na področju upravljanja ključev

• Za razvojno in produkcijsko okolje uporabljajte ločene API-ključe.
• Za ključe, ki se uporabljajo začasno, nastavite datume poteka veljavnosti.
• Ključe redno menjajte in neuporabljene ključe prekličite.
• Uporabite funkcijo menjave ključev, da ključe zamenjate brez prekinitve delovanja.