MCP serverio dokumentacija

„Biscotti CMP MCP“ serveris leidžia dirbtinio intelekto asistentams programiškai sąveikauti su jūsų „Biscotti CMP“ paskyra. Valdykite svetaines, reklamos banerius, atitikties patikrinimus, sutikimų analizę, teisinius dokumentus ir dar daugiau – visa tai naudodami natūralios kalbos komandas savo IDE.

MCP (Model Context Protocol) serveris veikia kaip tiltas tarp jūsų AI asistento ir „Biscotti CMP“ API, teikdamas įrankių rinkinį, kurį galima tiesiogiai iškviesti iš jūsų kūrimo aplinkos.

Būtinos sąlygos

• „Node.js“ 18 ar naujesnė versija
• „Biscotti CMP“ paskyra su „Agency“ arba „LTD Agency“ planu
• API raktas iš puslapio „Kūrėjo nustatymai“

Greitasis pradžios vadovas

Greičiausias būdas pradėti – naudoti npx — nereikia diegti:

npx @biscotti-cmp/mcp-server

Paleiskite MCP serverį tiesiogiai, jo neįdiegdami sistemos lygiu. Tai yra rekomenduojamas būdas daugumai vartotojų:

npx @biscotti-cmp/mcp-server

Jei norite įdiegti MCP serverį globaliai savo sistemoje:

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

Po įdiegimo galite paleisti serverį tiesiogiai:

biscotti-mcp

Norėdami naudoti „Biscotti CMP MCP Server“ su „Claude Desktop“, į „Claude Desktop“ nustatymų failą įtraukite šią konfigūraciją.

Konfigūracijos failo vieta

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

Konfigūracija

Į savo konfigūracijos failą įtraukite šią informaciją:

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

Išsaugoję konfigūracijos failą, paleiskite „Claude Desktop“ iš naujo. „Biscotti CMP“ įrankiai pasirodys įrankių meniu.

Norėdami naudoti „Biscotti CMP MCP“ serverį su „Cursor“, įtraukite šią konfigūraciją į savo „Cursor MCP“ nustatymus.

Konfigūracijos failo vieta

• Projekto lygmeniu: .cursor/mcp.json jūsų projekto šaknyje
• Global: ~/.cursor/mcp.json

Konfigūracija

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

Išsaugojus, „Cursor“ automatiškai aptiks MCP serverį ir įtrauks šiuos įrankius į AI asistentą.

Norėdami naudoti „Biscotti CMP MCP“ serverį su „Kiro“, sukonfigūruokite jį per MCP nustatymus.

Konfigūracijos failo vieta

• Projekto lygmeniu: .kiro/settings/mcp.json jūsų projekto šaknyje
• Pasauliniu mastu: ~/.kiro/settings/mcp.json

Konfigūracija

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

„Kiro“ automatiškai nustatys MCP serverio konfigūraciją ir suteiks prieigą prie „Biscotti CMP“ įrankių.

„Biscotti CMP MCP“ serveris suderinamas su bet kuriuo MCP standartą atitinkančiu klientu. Naudokite šią bendrąją konfigūraciją:

Bendrieji nustatymai

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

Jei jūsų MCP klientas naudoja kitokį konfigūracijos formatą, pagrindiniai parametrai yra šie:

• Komanda: npx
• Argumentai: -y @biscotti-cmp/mcp-server
• Aplinkos kintamasis: BISCOTTI_API_KEY nustatykite savo API raktą

Įrankiai jūsų tinklalapių valdymui Biscotti CMP.

Įrankiai sutikimo juostų kūrimui ir tvarkymui.

Įrankiai tinklalapių skenavimui ir suderinamumo būsenai tikrinti.

Įrankiai prieigos prie sutikimo statistikos ir analitikos duomenų.

Įrankiai, skirti tvarkyti teisinius dokumentus, pavyzdžiui, privatumo politiką, paslaugų teikimo sąlygas ir informacijos apie leidėją puslapius.

Įrankiai, skirti valdyti aptiktas trečiųjų šalių paslaugas ir jų sutikimo kategorijas.

Įrankiai webhook integracijų valdymui realaus laiko įvykio pranešimams.

Įrankiai agentūros klientų sąskaitų valdymui ir operacijoms.

„Biscotti CMP MCP“ serveris teikia šiuos išteklius, kuriuos AI asistentai gali naudoti kontekstui suprasti:

• biscotti://websites — Visų jūsų paskyroje esančių svetainių sąrašas
• biscotti://website/{id} — Išsami svetainės konfigūracija
• biscotti://compliance/{id} — Dabartinė svetainės atitikties būklė
• biscotti://banners/{websiteId} — Visi svetainės reklaminiai skydeliai

Šie ištekliai suteikia tik skaitymo režimu veikiančią aplinką, kuri padeda AI asistentams suprasti jūsų dabartinę konfigūraciją prieš atliekant pakeitimus.

MCP serveryje yra įdiegtų komandų eilutės šablonų, skirtų dažniausiai naudojamiems darbo srautams:

Atitikties auditas

Atlikite išsamų svetainės atitikties auditą: patikrinkite slapukus, peržiūrėkite sutikimo nustatymus ir parengite ataskaitą.

Atlikti atitikties auditą mano svetainėje example.com ir pasiūlyti patobulinimų.

Bannerio nustatymas

Sukurkite ir sukonfigūruokite sutikimo juostą pagal savo pageidaujamą dizainą ir veikimo nustatymus.

Sukurti GDPR reikalavimus atitinkančią sutikimo reklamjuostę mano svetainei su tamsia tema ir apatine kairiąja pozicija.

Teisinių dokumentų rengimas

Sukurkite teisinius dokumentus, atsižvelgiant į jūsų svetainės nustatymus ir taikytiną jurisdikciją.

Sugeneruoti privatumo politiką mano Vokietijos svetainei, kuri apima Google Analytics ir Facebook Pixel.

„Biscotti CMP MCP“ serveriui reikia API rakto, kad būtų galima atlikti autentifikavimą naudojant „Biscotti CMP“ API. Visi „MCP“ serverio siunčiami užklausimai yra autentifikuojami naudojant jūsų API raktą.

Kaip veikia autentifikavimas

1. API raktą sukuriate savo „Biscotti CMP“ valdymo skydo puslapyje „Kūrėjo nustatymai“.
2. API raktas nustatomas kaip BISCOTTI_API_KEY aplinkos kintamasis jūsų MCP kliento konfigūracijoje.
3. MCP serveris įtraukia šį raktą kaip „Bearer“ žetoną į visus API užklausimus.
4. „Biscotti CMP“ API patikrina raktą ir grąžina duomenis, susijusius su jūsų paskyra.

Norėdami gauti MCP serverio API raktą:

1. Prisijunkite prie savo „Biscotti CMP“ valdymo skydo adresu app.biscotti-cmp.com.
2. Šoninėje juostoje pereikite į „Kūrėjo nustatymus“.
3. Skirtuke „API raktai“ spustelėkite „Sukurti naują raktą“.
4. Pavadinkite raktą apibūdinančiu pavadinimu (pvz., „MCP serveris – kūrimas“).
5. Jei norite, nustatykite rakto galiojimo pabaigos datą.
6. Iš karto nukopijuokite sukurtą raktą – jis bus rodomas tik vieną kartą.

Geriausios raktų tvarkymo praktikos

• Naudokite atskirus API raktus kūrimo ir gamybos aplinkoms.
• Nustatykite galiojimo pabaigos datas raktams, kurie naudojami laikinai.
• Reguliariai keiskite raktus ir panaikinkite nenaudojamus raktus.
• Naudokite raktų keitimo funkciją, kad galėtumėte pakeisti raktus be veiklos pertraukos.