Documentația serverului MCP

Serverul Biscotti CMP MCP permite asistenților AI să interacționeze cu contul dvs. Biscotti CMP prin intermediul programării. Gestionați site-uri web, bannere, verificări de conformitate, analize privind consimțământul, documente juridice și multe altele — totul prin comenzi în limbaj natural din IDE-ul dvs.

Serverul MCP (Model Context Protocol) acționează ca o punte de legătură între asistentul dvs. de IA și API-ul Biscotti CMP, oferind un set de instrumente care pot fi apelate direct din mediul dvs. de dezvoltare.

Condiții preliminare

• Node.js 18 sau o versiune ulterioară
• Un cont Biscotti CMP cu un plan „Agenție” sau „Agenție LTD”
• O cheie API din pagina Setări pentru dezvoltatori

Ghid de pornire rapidă

Cea mai rapidă modalitate de a începe este folosind npx — nu este necesară instalarea:

npx @biscotti-cmp/mcp-server

Rulați serverul MCP direct, fără a-l instala la nivel global. Aceasta este metoda recomandată pentru majoritatea utilizatorilor:

npx @biscotti-cmp/mcp-server

Dacă preferați să instalați serverul MCP global pe sistemul dvs.:

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

După instalare, puteți rula serverul direct:

biscotti-mcp

Pentru a utiliza serverul Biscotti CMP MCP împreună cu Claude Desktop, adăugați următoarea configurație în fișierul de setări al Claude Desktop.

Locația fișierului de configurare

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

Configurare

Adaugă următoarele în fișierul de configurare:

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

Reporniți Claude Desktop după ce salvați fișierul de configurare. Instrumentele Biscotti CMP vor apărea în meniul de instrumente.

Pentru a utiliza serverul Biscotti CMP MCP împreună cu Cursor, adăugați următoarea configurație în setările Cursor MCP.

Locația fișierului de configurare

• La nivel de proiect: .cursor/mcp.json în directorul rădăcină al proiectului
• Global: ~/.cursor/mcp.json

Configurare

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

După salvare, Cursor va detecta automat serverul MCP și va pune instrumentele la dispoziție în asistentul AI.

Pentru a utiliza serverul Biscotti CMP MCP împreună cu Kiro, configurați-l prin intermediul setărilor MCP.

Locația fișierului de configurare

• La nivel de proiect: .kiro/settings/mcp.json în directorul rădăcină al proiectului
• La nivel global: ~/.kiro/settings/mcp.json

Configurare

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

Kiro va detecta automat configurația serverului MCP și va pune la dispoziție instrumentele Biscotti CMP.

Serverul Biscotti CMP MCP este compatibil cu orice client compatibil cu MCP. Utilizați următoarea configurație generică:

Configurație generală

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

Dacă clientul MCP utilizează un format de configurare diferit, parametrii cheie sunt:

• Comandă: npx
• Argumente: -y @biscotti-cmp/mcp-server
• Variabilă de mediu: BISCOTTI_API_KEY setați-o la cheia API

Instrumente pentru gestionarea site-urilor dvs. în Biscotti CMP.

Instrumente pentru crearea și gestionarea bannerelor de consimțământ.

Instrumente pentru scanarea site-urilor web și verificarea statusului de conformitate.

Instrumente pentru accesarea statisticilor de consimțământ și a datelor de analiză.

Instrumente pentru gestionarea documentelor juridice, cum ar fi politicile de confidențialitate, termenii și condițiile de utilizare și paginile cu informații legale.

Instrumente pentru gestionarea serviciilor terțe detectate și a categoriilor de consimțământ ale acestora.

Instrumente pentru gestionarea integrărilor webhook pentru notificări de evenimente în timp real.

Instrumente pentru gestionarea conturilor clienților și operațiunile agenției.

Serverul Biscotti CMP MCP pune la dispoziție următoarele resurse pe care asistenții AI le pot accesa pentru a înțelege contextul:

• biscotti://site-uri web — Lista tuturor site-urilor web din contul tău
• biscotti://website/{id} — Configurație detaliată a site-ului web
• biscotti://compliance/{id} — Starea actuală de conformitate a unui site web
• biscotti://banners/{websiteId} — Toate bannerele pentru un site web

Resursele oferă informații de tip „doar citire” care ajută asistenții AI să înțeleagă configurația actuală înainte de a efectua modificări.

Serverul MCP include șabloane de solicitări integrate pentru fluxurile de lucru obișnuite:

Audit de conformitate

Efectuați un audit complet de conformitate al unui site web, verificând prezența fișierelor cookie, verificând configurarea consimțământului și generând un raport.

Rulează un audit de conformitate pe site-ul meu web example.com și sugerează îmbunătățiri.

Configurarea bannerului

Creați și configurați un banner de consimțământ cu designul și setările de funcționare dorite.

Creează un banner de consimțământ conform GDPR pentru site-ul meu web cu o temă întunecată și poziție în stânga jos.

Generarea documentelor juridice

Generați documente juridice pe baza configurației site-ului dvs. web și a jurisdicției țintă.

Generează o politică de confidențialitate pentru site-ul meu web german care acoperă Google Analytics și Facebook Pixel.

Serverul Biscotti CMP MCP necesită o cheie API pentru autentificarea la API-ul Biscotti CMP. Toate solicitările efectuate de serverul MCP sunt autentificate folosind cheia dvs. API.

Cum funcționează autentificarea

1. Generați o cheie API în pagina „Setări pentru dezvoltatori” din panoul de control Biscotti CMP.
2. Cheia API este setată ca BISCOTTI_API_KEY variabilă de mediu în configurația clientului MCP.
3. Serverul MCP include această cheie sub forma unui token Bearer în toate solicitările API.
4. API-ul Biscotti CMP validează cheia și returnează date specifice contului dumneavoastră.

Pentru a obține o cheie API pentru serverul MCP:

1. Conectați-vă la panoul de control Biscotti CMP la adresa app.biscotti-cmp.com.
2. Accesați secțiunea „Setări pentru dezvoltatori” din bara laterală.
3. Faceți clic pe „Generați o cheie nouă” în fila „Chei API”.
4. Dați cheii un nume descriptiv (de exemplu, „Server MCP – Dezvoltare”).
5. Opțional, puteți seta o dată de expirare pentru cheie.
6. Copiați imediat cheia generată — aceasta va fi afișată o singură dată.

Cele mai bune practici în gestionarea cheilor

• Folosiți chei API distincte pentru mediile de dezvoltare și de producție.
• Setați date de expirare pentru cheile utilizate temporar.
• Schimbați periodic cheile și anulați-le pe cele neutilizate.
• Folosiți funcția de rotație a cheilor pentru a înlocui cheile fără întreruperi.