MCP szerver dokumentáció

A Biscotti CMP MCP Server lehetővé teszi az AI-asszisztensek számára, hogy programozási úton kommunikáljanak a Biscotti CMP-fiókjával. Kezelje webhelyeit, bannereit, megfelelőségi ellenőrzéseit, hozzájárulási elemzéseit, jogi dokumentumait és még sok mást – mindezt az IDE-jében természetes nyelvű parancsok segítségével.

Az MCP (Model Context Protocol) szerver hídként működik az AI-asszisztensed és a Biscotti CMP API között, és olyan eszközöket biztosít, amelyeket közvetlenül a fejlesztői környezetedből hívhatsz meg.

Előfeltételek

• Node.js 18 vagy újabb verzió
• Egy Biscotti CMP-fiók „Agency” vagy „LTD Agency” csomaggal
• API-kulcs a Fejlesztői beállítások oldalról

Gyors útmutató

A leggyorsabb módja a kezdésnek az, ha npx — telepítés nélkül:

npx @biscotti-cmp/mcp-server

Indítsa el az MCP-kiszolgálót közvetlenül, anélkül, hogy globálisan telepítené. Ez a legtöbb felhasználó számára ajánlott módszer:

npx @biscotti-cmp/mcp-server

Ha globálisan szeretné telepíteni az MCP szervert a rendszerén:

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

A telepítés után közvetlenül futtathatja a szervert:

biscotti-mcp

A Biscotti CMP MCP Server használatához a Claude Desktop alkalmazással egészítse ki a Claude Desktop beállítási fájlját a következő konfigurációval.

A konfigurációs fájl helye

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

Beállítások

Írd be a következőket a konfigurációs fájlba:

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

A konfigurációs fájl mentése után indítsa újra a Claude Desktop alkalmazást. A Biscotti CMP eszközök megjelennek az Eszközök menüben.

A Biscotti CMP MCP szerver Cursorral való használatához adja hozzá a következő beállításokat a Cursor MCP-beállításaihoz.

A konfigurációs fájl helye

• Projekt szint: .cursor/mcp.json a projekt gyökérkönyvtárában
• Globális: ~/.cursor/mcp.json

Beállítások

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

A mentés után a Cursor automatikusan felismeri az MCP-kiszolgálót, és az eszközöket elérhetővé teszi az AI-asszisztensben.

Ahhoz, hogy a Biscotti CMP MCP szervert a Kiro-val együtt használhassa, állítsa be azt az MCP beállítások menüben.

A konfigurációs fájl helye

• Projekt szint: .kiro/settings/mcp.json a projekt gyökérkönyvtárában
• Világszerte: ~/.kiro/settings/mcp.json

Beállítások

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

A Kiro automatikusan felismeri az MCP-kiszolgáló konfigurációját, és elérhetővé teszi a Biscotti CMP-eszközöket.

A Biscotti CMP MCP szerver bármely MCP-kompatibilis klienssel együttműködik. Használja a következő általános beállítást:

Általános beállítások

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

Ha az MCP-kliens más konfigurációs formátumot használ, a legfontosabb paraméterek a következők:

• Parancs: npx
• Érvek: -y @biscotti-cmp/mcp-server
• Környezeti változó: BISCOTTI_API_KEY állítsa be az API-kulcsát

Eszközök a weboldalai kezeléséhez a Biscotti CMP-ben.

Eszközök a hozzájárulási sávok létrehozásához és kezeléséhez.

Eszközök weboldalak szkennereléséhez és compliance állapot ellenőrzéséhez.

Eszközök a hozzájárulási statisztikák és elemzési adatok eléréséhez.

Eszközök jogi dokumentumok – például adatvédelmi nyilatkozatok, felhasználási feltételek és jogi nyilatkozatok – kezeléséhez.

Eszközök az észlelt harmadik féltől származó szolgáltatások és azok hozzájárulási kategóriáinak kezelésére.

Eszközök a webhook integrációk kezeléséhez valós idejű esemény értesítésekhez.

Eszközök ügynökségi fiókok kezeléséhez és ügyfelei műveleteihez.

A Biscotti CMP MCP szerver a következő erőforrásokat teszi elérhetővé, amelyeket az AI-asszisztensek a kontextus megértése érdekében kiolvashatnak:

• biscotti://websites — A fiókodban található összes webhely listája
• biscotti://website/{id} — A weboldal részletes beállításai
• biscotti://compliance/{id} — Egy weboldal aktuális megfelelési állapota
• biscotti://banners/{websiteId} — Egy webhely összes bannerje

Az erőforrások olyan, csak olvasásra szolgáló kontextust nyújtanak, amely segít a mesterséges intelligencia-asszisztenseknek megérteni a jelenlegi beállításokat, mielőtt bármilyen módosítást hajtanának végre.

Az MCP Server beépített parancssori sablonokat tartalmaz a leggyakoribb munkafolyamatokhoz:

Megfelelési ellenőrzés

Végezzen teljes körű megfelelőségi ellenőrzést egy weboldalon: vizsgálja meg a cookie-kat, ellenőrizze a hozzájárulási beállításokat, és készítsen jelentést.

Megfelelőségi audit futtatása az example.com weboldalamon, és javaslatok tétele.

Banner beállítása

Hozzon létre és állítson be egy hozzájárulási sávot a kívánt megjelenéssel és viselkedési beállításokkal.

GDPR-kompatibilis hozzájárulási banner létrehozása a weboldalamhoz sötét témával és bal alsó pozícióval.

Jogi dokumentumok készítése

Készítsen jogi dokumentumokat a webhely konfigurációja és a céljoghatóság alapján.

Adatvédelmi irányelvek generálása a német weboldalamhoz, amely kiterjed a Google Analytics és a Facebook Pixel szolgáltatásokra.

A Biscotti CMP MCP szerverhez API-kulcs szükséges a Biscotti CMP API-n keresztüli hitelesítéshez. Az MCP szerver által kezdeményezett összes kérés hitelesítése az Ön API-kulcsával történik.

Hogyan működik a hitelesítés?

1. Az API-kulcsot a Biscotti CMP irányítópult „Fejlesztői beállítások” oldalán hozhatja létre.
2. Az API-kulcs az BISCOTTI_API_KEY környezeti változóként van beállítva az MCP kliens konfigurációjában.
3. Az MCP-kiszolgáló minden API-kérésben ezt a kulcsot Bearer-tokenként mellékeli.
4. A Biscotti CMP API ellenőrzi a kulcs érvényességét, majd a felhasználói fiókjához tartozó adatokat adja vissza.

Az MCP-kiszolgáló API-kulcsának megszerzéséhez:

1. Jelentkezzen be a Biscotti CMP irányítópultjára az app.biscotti-cmp.com oldalon.
2. Lépj az oldalsávon a Fejlesztői beállítások menüpontra.
3. Kattintson az „Új kulcs létrehozása” gombra az „API-kulcsok” fülön.
4. Adjon a kulcsának egy leíró nevet (pl. „MCP-kiszolgáló – Fejlesztés”).
5. Opcionálisan állítson be lejárati dátumot a kulcshoz.
6. Azonnal másolja le a generált kulcsot – csak egyszer jelenik meg.

A kulcskezelés legjobb gyakorlata

• Használjon külön API-kulcsokat a fejlesztési és az éles környezetben.
• Állítson be lejárati dátumot az ideiglenesen használt kulcsokra.
• Rendszeresen cserélje ki a kulcsokat, és vonja vissza a már nem használt kulcsokat.
• Használja a kulcsváltási funkciót a kulcsok leállás nélküli cseréjéhez.