Dokumentácia k serveru MCP

Server Biscotti CMP MCP umožňuje asistentom umelej inteligencie programovo komunikovať s vaším účtom Biscotti CMP. Spravujte webové stránky, bannerové reklamy, kontroly súladu, analýzy súhlasov, právne dokumenty a ďalšie funkcie – všetko prostredníctvom príkazov v prirodzenom jazyku vo vašom vývojárskom prostredí (IDE).

Server MCP (Model Context Protocol) funguje ako most medzi vaším AI asistentom a rozhraním Biscotti CMP API a poskytuje súbor nástrojov, ktoré je možné volať priamo z vášho vývojového prostredia.

Predpoklady

• Node.js 18 alebo novšia verzia
• Účet Biscotti CMP s tarifou Agency alebo LTD Agency
• API kľúč zo stránky Nastavenia pre vývojárov

Rýchly štart

Najrýchlejší spôsob, ako začať, je využiť npx — bez nutnosti inštalácie:

npx @biscotti-cmp/mcp-server

Spustite server MCP priamo bez toho, aby ste ho inštalovali globálne. Pre väčšinu používateľov je to odporúčaný postup:

npx @biscotti-cmp/mcp-server

Ak dávate prednosť globálnej inštalácii MCP Server na svojom systéme:

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

Po inštalácii môžete server spustiť priamo:

biscotti-mcp

Ak chcete používať server Biscotti CMP MCP s aplikáciou Claude Desktop, pridajte do konfiguračného súboru aplikácie Claude Desktop nasledujúce nastavenia.

Umiestnenie konfiguračného súboru

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

Nastavenia

Do konfiguračného súboru pridajte nasledujúci text:

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

Po uložení konfiguračného súboru reštartujte aplikáciu Claude Desktop. Nástroje Biscotti CMP sa zobrazia v ponuke nástrojov.

Ak chcete používať server Biscotti CMP MCP s Cursorom, pridajte do nastavení Cursor MCP nasledujúcu konfiguráciu.

Umiestnenie konfiguračného súboru

• Na úrovni projektu: .cursor/mcp.json v koreňovom adresári vášho projektu
• Celosvetovo: ~/.cursor/mcp.json

Nastavenia

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

Po uložení aplikácia Cursor automaticky zistí server MCP a sprístupní nástroje v asistentoch umelej inteligencie.

Ak chcete používať server Biscotti CMP MCP s Kiro, nakonfigurujte ho v nastaveniach MCP.

Umiestnenie konfiguračného súboru

• Na úrovni projektu: .kiro/settings/mcp.json v koreňovom adresári vášho projektu
• Celosvetovo: ~/.kiro/settings/mcp.json

Nastavenia

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

Kiro automaticky zistí konfiguráciu servera MCP a sprístupní nástroje Biscotti CMP.

Server Biscotti CMP MCP je kompatibilný s akýmkoľvek klientom podporujúcim protokol MCP. Použite nasledujúcu všeobecnú konfiguráciu:

Všeobecná konfigurácia

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

Ak váš klient MCP používa iný formát konfigurácie, kľúčové parametre sú:

• Príkaz: npx
• Argumenty: -y @biscotti-cmp/mcp-server
• Premenná prostredia: BISCOTTI_API_KEY nastavte na svoj kľúč API

Nástroje pre správu vašich webových stránok v Biscotti CMP.

Nástroje na vytváranie a správu bannerov so žiadosťou o súhlas.

Nástroje pre skenovanie webových stránok a overenie stavu súladu.

Nástroje pre prístup k štatistikám súhlasu a analytickým dátam.

Nástroje na správu právnych dokumentov, ako sú zásady ochrany osobných údajov, podmienky používania a stránky s informáciami o prevádzkovateľovi.

Nástroje na správu detegovaných služieb tretích strán a ich kategórií súhlasu.

Nástroje pre správu webhook integrácií pre notifikácie o udalostiach v reálnom čase.

Nástroje pre správu klientských účtov a prevádzky pre agentúry.

Server Biscotti CMP MCP sprístupňuje nasledujúce zdroje, z ktorých si asistenti umelej inteligencie môžu načerpať kontext:

• biscotti://websites — Zoznam všetkých webových stránok vo vašom účte
• biscotti://website/{id} — Podrobná konfigurácia webovej stránky
• biscotti://compliance/{id} — Aktuálny stav súladu webovej stránky
• biscotti://banners/{websiteId} — Všetky bannerové reklamy pre danú webovú stránku

Zdroje poskytujú kontext len na čítanie, ktorý pomáha asistentom umelej inteligencie porozumieť vašej aktuálnej konfigurácii pred vykonaním zmien.

Server MCP obsahuje vstavané šablóny výziev pre bežné pracovné postupy:

Audit súladu

Vykonajte komplexný audit súladu na webovej stránke, pri ktorom skontrolujete súbory cookie, overíte nastavenia súhlasu a vygenerujete správu.

Spustiť audit zhody na mojej webovej stránke example.com a navrhnúť vylepšenia.

Nastavenie banneru

Vytvorte a nakonfigurujte banner so žiadosťou o súhlas podľa svojich predstáv, čo sa týka vzhľadu a správania.

Vytvorte banner so súhlasom v súlade s GDPR pre moju webovú stránku s tmavou témou a pozíciou vľavo dole.

Vytváranie právnych dokumentov

Vytvorte právne dokumenty na základe konfigurácie vašej webovej stránky a príslušnej jurisdikcie.

Vygenerujte zásady ochrany osobných údajov pre moju nemeckú webovú stránku, ktorá pokrýva Google Analytics a Facebook Pixel.

Server Biscotti CMP MCP vyžaduje kľúč API na overenie identity v rámci rozhrania API Biscotti CMP. Všetky požiadavky odoslané serverom MCP sú overované pomocou vášho kľúča API.

Ako funguje overovanie

1. API kľúč si vytvoríte na stránke Nastavenia pre vývojárov vo vašom riadiacom paneli Biscotti CMP.
2. Kľúč API je nastavený ako BISCOTTI_API_KEY premenná prostredia v konfigurácii vášho klienta MCP.
3. Server MCP zahrňuje tento kľúč ako token typu „Bearer“ vo všetkých požiadavkách API.
4. Rozhranie API Biscotti CMP overí kľúč a vráti údaje týkajúce sa vášho účtu.

Postup získania kľúča API pre server MCP:

1. Prihláste sa do svojho ovládacieho panela Biscotti CMP na adrese app.biscotti-cmp.com.
2. V bočnom paneli prejdite do nastavení pre vývojárov.
3. Na karte „API kľúče“ kliknite na tlačidlo „Vytvoriť nový kľúč“.
4. Pomenujte svoj kľúč výstižným názvom (napr. „MCP Server – Vývoj“).
5. Môžete nastaviť dátum vypršania platnosti kľúča.
6. Okamžite si skopírujte vygenerovaný kľúč – zobrazí sa len raz.

Osvedčené postupy v oblasti správy kľúčov

• Používajte odlišné kľúče API pre vývojové a produkčné prostredia.
• Nastavte dátumy vypršania platnosti pre kľúče, ktoré sa používajú dočasne.
• Kľúče pravidelne striedajte a nepoužívané kľúče zrušte.
• Využite funkciu rotácie kľúčov na výmenu kľúčov bez prerušenia prevádzky.