Dokumentazzjoni tas-Server MCP

Is-Server MCP ta' Biscotti CMP jippermetti lill-assistenti tal-AI jinteraġixxu mal-kont ta' Biscotti CMP tiegħek b'mod programmatiku. Immaniġġja websajts, banners, skans ta' konformità, analitika tal-kunsens, dokumenti legali, u aktar — kollha permezz ta' kmandi b'lingwa naturali fl-IDE tiegħek.

Is-Server tal-MCP (Model Context Protocol) jaġixxi bħala pont bejn l-assistent tal-AI tiegħek u l-API ta' Biscotti CMP, u jipprovdi sett ta' għodod li jistgħu jiġu msejħa direttament mill-ambjent ta' żvilupp tiegħek.

Prerekwiżiti

• Node.js 18 jew aktar ġdid
• Kont ta' Biscotti CMP bi pjan ta' Aġenzija jew Aġenzija LTD
• Ċavetta API mill-paġna tas-Settings tal-Iżviluppatur

Bidu Mgħaġġel

L-aktar mod mgħaġġel biex tibda huwa billi tuża npx — m'hemmx bżonn installazzjoni:

npx @biscotti-cmp/mcp-server

Mexxi s-Server tal-MCP direttament mingħajr ma tinstallah globalment. Dan huwa l-approċċ rakkomandat għal ħafna mill-utenti:

npx @biscotti-cmp/mcp-server

Jekk tippreferi tinstalla l-MCP Server globalment fuq is-sistema tiegħek:

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

Wara l-installazzjoni, tista' terġa' tnaddaf il-server:

biscotti-mcp

Biex tuża s-Server tal-MCP ta' Biscotti CMP ma' Claude Desktop, żid il-konfigurazzjoni li ġejja mal-fajl tas-settings ta' Claude Desktop tiegħek.

Post tal-Fajl tal-Konfigurazzjoni

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

Konfigurazzjoni

Żid dan li ġej mal-fajl tal-konfigurazzjoni tiegħek:

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

Erġa' ibda Claude Desktop wara li ssalva l-fajl tal-konfigurazzjoni. L-għodod ta' Biscotti CMP se jidhru fil-menu tal-għodod.

Biex tuża s-Server tal-MCP ta' Biscotti CMP ma' Cursor, żid il-konfigurazzjoni li ġejja mas-settings tal-MCP ta' Cursor tiegħek.

Post tal-Fajl tal-Konfigurazzjoni

• Fil-livell tal-proġett: .cursor/mcp.json fl-għerq tal-proġett tiegħek
• Globali: ~/.cursor/mcp.json

Konfigurazzjoni

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

Wara li ssalva, Cursor awtomatikament se jiskopri s-server MCP u jagħmel l-għodod disponibbli fl-assistent tal-AI.

Biex tuża s-Server MCP Biscotti CMP ma' Kiro, ikkofigurah permezz tas-settings tal-MCP.

Post tal-Fajl tal-Konfigurazzjoni

• Fil-livell tal-proġett: .kiro/settings/mcp.json fl-għerq tal-proġett tiegħek
• Globali: ~/.kiro/settings/mcp.json

Konfigurazzjoni

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

Kiro awtomatikament se jiskopri l-konfigurazzjoni tas-server MCP u jagħmel l-għodod Biscotti CMP disponibbli.

Is-Server MCP Biscotti CMP huwa kompatibbli ma' kwalunkwe klijent konformi mal-MCP. Uża l-konfigurazzjoni ġenerika li ġejja:

Konfigurazzjoni Ġenerika

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

Jekk il-klijent MCP tiegħek juża format ta' konfigurazzjoni differenti, il-parametri ewlenin huma:

• Kmand: npx
• Argumenti: -y @biscotti-cmp/mcp-server
• Varjabbli tal-ambjent: BISCOTTI_API_KEY issettjata għall-API key tiegħek

Għodod għal amministrazzjoni ta' siti web tiegħek f'Biscotti CMP.

Għodod għall-ħolqien u l-maniġġjar ta' banners ta' kunsens.

Għodod għal skannjar ta' siti web u ċċekkjar ta' status ta' konformità.

Għodod għal aċċess għal statistiki ta' konsens u data analitika.

Għodod għall-maniġġjar ta' dokumenti legali bħal politiki tal-privatezza, termini ta' servizz, u paġni tal-imprint.

Għodod għall-ġestjoni ta' servizzi ta' partijiet terzi misjuba u l-kategoriji tal-kunsens tagħhom.

Għodod għal amministrazzjoni ta' integrazzjonijiet ta' webhook għal notifiki ta' events f'temp reali.

Għodod għal amministrazzjoni ta' konti ta' klijenti u operazzjonijiet ta' aġenzija.

Is-Server MCP tal-Biscotti CMP jesponi r-riżorsi li ġejjin li l-assistenti tal-AI jistgħu jaqraw għall-kuntest:

• biscotti://websites — Lista tal-websajts kollha fil-kont tiegħek
• biscotti://website/{id} — Konfigurazzjoni dettaljata tal-websajt
• biscotti://compliance/{id} — Status kurrenti ta' konformità għal websajt
• biscotti://banners/{websiteId} — Il-banners kollha għal websajt

Ir-riżorsi jipprovdu kuntest read-only li jgħin lill-assistenti tal-AI jifhmu s-setup kurrenti tiegħek qabel ma jagħmlu bidliet.

Is-Server MCP jinkludi mudelli tal-istruzzjonijiet integrati għal flussi tax-xogħol komuni:

Verifika tal-Konformità

Mexxi verifika sħiħa tal-konformità fuq websajt, skannja għall-cookies, iċċekkja l-konfigurazzjoni tal-kunsens, u ġġenera rapport.

Mexxi verifika tal-konformità fuq il-websajt tiegħi example.com u issuġġerixxi titjib.

Setup tal-Banner

Oħloq u kkonfigura banner tal-kunsens bid-disinn preferut tiegħek u s-settings tal-imġieba.

Oħloq banner ta' kunsens konformi mal-GDPR għall-websajt tiegħi b'tema skura u pożizzjoni fin-naħa t'isfel tax-xellug.

Ġenerazzjoni ta' Dokumenti Legali

Iġġenera dokumenti legali abbażi tal-konfigurazzjoni tal-websajt tiegħek u l-ġurisdizzjoni fil-mira.

Iġġenera politika ta' privatezza għall-websajt Ġermaniża tiegħi li tkopri Google Analytics u Facebook Pixel.

Is-Server MCP ta' Biscotti CMP jeħtieġ ċavetta API biex jawtentika mal-API ta' Biscotti CMP. It-talbiet kollha magħmula mis-Server MCP huma awtentikati permezz taċ-ċavetta API tiegħek.

Kif Taħdem l-Awtentikazzjoni

1. Tiġġenera ċavetta API fil-paġna tas-Settings tal-Iżviluppatur tad-dashboard ta' Biscotti CMP tiegħek.
2. Iċ-ċavetta API tiġi ssettjata bħala l-varjabbli tal-ambjent BISCOTTI_API_KEY fil-konfigurazzjoni tal-klijent MCP tiegħek.
3. Is-Server MCP jinkludi din iċ-ċavetta bħala token Bearer fit-talbiet kollha tal-API.
4. L-API ta' Biscotti CMP tivvalida ċ-ċavetta u tirritorna dejta skoperta għall-kont tiegħek.

Biex tikseb ċavetta API għas-Server MCP:

1. Idħol fid-dashboard ta' Biscotti CMP tiegħek fuq app.biscotti-cmp.com.
2. Inaviga lejn Developer Settings fil-sidebar.
3. Ikklikkja Iġġenera Ċavetta Ġdida fit-tab API Keys.
4. Agħti lill-ċavetta tiegħek isem deskrittiv (e.g., "Server MCP - Żvilupp").
5. Issettja data ta' skadenza fakultattiva għaċ-ċavetta.
6. Ikkopja ċ-ċavetta ġġenerata immedjatament — se tintwera darba biss.

L-Aħjar Prattiki fil-Ġestjoni taċ-Ċavetti

• Uża ċavetti API separati għall-ambjenti ta' żvilupp u produzzjoni.
• Issettja dati ta' skadenza fuq ċavetti li jintużaw temporanjament.
• Ibdil ċavetti regolarment u irrevoka ċavetti mhux użati.
• Uża l-karatteristika tar-rotazzjoni taċ-ċavetti biex tissostitwixxi ċavetti mingħajr waqfien.