Dokumentace k serveru MCP

Server Biscotti CMP MCP umožňuje asistentům s umělou inteligencí programově komunikovat s vaším účtem Biscotti CMP. Spravujte webové stránky, bannery, kontroly souladu s předpisy, analýzy souhlasů, právní dokumenty a další – to vše pomocí příkazů v přirozeném jazyce přímo ve vašem vývojovém prostředí.

Server MCP (Model Context Protocol) funguje jako most mezi vaším AI asistentem a rozhraním Biscotti CMP API a poskytuje sadu nástrojů, které lze přímo vyvolat z vašeho vývojového prostředí.

Předpoklady

• Node.js 18 nebo novější
• Účet Biscotti CMP s tarifem Agency nebo LTD Agency
• API klíč ze stránky Nastavení pro vývojáře

Rychlý start

Nejrychlejší způsob, jak začít, je použít npx — není nutná žádná instalace:

npx @biscotti-cmp/mcp-server

Spusťte server MCP přímo, aniž byste jej instalovali globálně. Tento postup se doporučuje většině uživatelů:

npx @biscotti-cmp/mcp-server

Pokud dáváte přednost globální instalaci MCP Server na svém systému:

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

Po instalaci můžete server spustit přímo:

biscotti-mcp

Chcete-li používat server Biscotti CMP MCP se softwarem Claude Desktop, přidejte následující konfiguraci do konfiguračního souboru softwaru Claude Desktop.

Umístění konfiguračního souboru

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

Nastavení

Do konfiguračního souboru přidejte následující:

{
  "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 souboru restartujte program Claude Desktop. Nástroje Biscotti CMP se zobrazí v nabídce nástrojů.

Chcete-li používat server Biscotti CMP MCP se systémem Cursor, přidejte do nastavení Cursor MCP následující konfiguraci.

Umístění konfiguračního souboru

• Na úrovni projektu: .cursor/mcp.json v kořenovém adresáři projektu
• Global: ~/.cursor/mcp.json

Nastavení

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

Po uložení aplikace Cursor automaticky vyhledá server MCP a zpřístupní nástroje v AI asistentovi.

Chcete-li používat server Biscotti CMP MCP se systémem Kiro, nakonfigurujte jej v nastavení MCP.

Umístění konfiguračního souboru

• Na úrovni projektu: .kiro/settings/mcp.json v kořenovém adresáři projektu
• Celosvětově: ~/.kiro/settings/mcp.json

Nastavení

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

Kiro automaticky rozpozná konfiguraci serveru MCP a zpřístupní nástroje Biscotti CMP.

Server Biscotti CMP MCP je kompatibilní s jakýmkoli klientem podporujícím protokol MCP. Použijte následující obecný konfigurační příkaz:

Obecná konfigurace

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

Pokud váš klient MCP používá jiný formát konfigurace, klíčové parametry jsou:

• Příkaz: npx
• Argumenty: -y @biscotti-cmp/mcp-server
• Proměnná prostředí: BISCOTTI_API_KEY nastavte na svůj API klíč

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

Nástroje pro vytváření a správu bannerů s žádostí o souhlas.

Nástroje pro skenování webových stránek a kontrolu stavu souladu.

Nástroje pro přístup ke statistikám souhlasu a analytickým datům.

Nástroje pro správu právních dokumentů, jako jsou zásady ochrany osobních údajů, podmínky používání a stránky s identifikačními údaji.

Nástroje pro správu detekovaných služeb třetích stran a jejich kategorií souhlasu.

Nástroje pro správu webhook integrací pro notifikace událostí v reálném čase.

Nástroje pro správu klientských účtů a provozu agentury.

Server Biscotti CMP MCP zpřístupňuje následující zdroje, z nichž si AI asistenti mohou načíst kontext:

• biscotti://websites — Seznam všech webových stránek ve vašem účtu
• biscotti://website/{id} — Podrobná konfigurace webové stránky
• biscotti://compliance/{id} — Aktuální stav shody webové stránky
• biscotti://banners/{websiteId} — Všechny bannery pro daný web

Nastavení poskytují informace pouze pro čtení, které pomáhají asistentům s umělou inteligencí porozumět vašemu aktuálnímu nastavení před provedením změn.

Server MCP obsahuje předdefinované šablony výzev pro běžné pracovní postupy:

Audit dodržování předpisů

Proveďte kompletní audit souladu s předpisy na webových stránkách, včetně vyhledání souborů cookie, kontroly nastavení souhlasu a vygenerování zprávy.

Spusťte audit shody na mém webu example.com a navrhněte vylepšení.

Nastavení banneru

Vytvořte a nakonfigurujte banner pro udělení souhlasu podle svých představ, co se týče vzhledu a chování.

Vytvořte banner se souhlasem v souladu s GDPR pro můj web s tmavým motivem a pozicí vlevo dole.

Vytváření právních dokumentů

Vytvářejte právní dokumenty na základě konfigurace vaší webové stránky a příslušné jurisdikce.

Vygenerujte zásady ochrany osobních údajů pro můj německý web, které zahrnují Google Analytics a Facebook Pixel.

Server Biscotti CMP MCP vyžaduje k ověření u rozhraní API Biscotti CMP klíč API. Všechny požadavky odeslané serverem MCP jsou ověřovány pomocí vašeho klíče API.

Jak funguje ověřování

1. API klíč si vygenerujete na stránce Nastavení pro vývojáře v ovládacím panelu Biscotti CMP.
2. API klíč je nastaven jako proměnná prostředí BISCOTTI_API_KEY proměnná prostředí v konfiguraci vašeho klienta MCP.
3. Server MCP zahrnuje tento klíč jako token typu „Bearer“ do všech požadavků API.
4. Rozhraní API Biscotti CMP ověří klíč a vrátí data týkající se vašeho účtu.

Postup pro získání klíče API pro server MCP:

1. Přihlaste se do svého panelu Biscotti CMP na adrese app.biscotti-cmp.com.
2. V postranním panelu přejděte do části Nastavení pro vývojáře.
3. Na kartě „API klíče“ klikněte na tlačítko „Vygenerovat nový klíč“.
4. Pojmenujte svůj klíč výstižně (např. „MCP Server – Vývoj“).
5. Volitelně můžete nastavit datum vypršení platnosti klíče.
6. Vygenerovaný klíč si ihned zapište – zobrazí se pouze jednou.

Osvědčené postupy v oblasti správy klíčů

• Pro vývojové a produkční prostředí používejte samostatné klíče API.
• Nastavte datum vypršení platnosti u klíčů, které se používají pouze dočasně.
• Pravidelně obměňujte klíče a rušte nepoužívané klíče.
• Využijte funkci rotace klíčů k výměně klíčů bez prostojů.