Τεκμηρίωση διακομιστή MCP

Ο διακομιστής Biscotti CMP MCP επιτρέπει στους βοηθούς τεχνητής νοημοσύνης να αλληλεπιδρούν με τον λογαριασμό σας στο Biscotti CMP μέσω προγραμματισμού. Διαχειριστείτε ιστότοπους, διαφημιστικά banner, ελέγχους συμμόρφωσης, αναλύσεις συγκατάθεσης, νομικά έγγραφα και πολλά άλλα — όλα μέσω εντολών φυσικής γλώσσας στο περιβάλλον ανάπτυξης εφαρμογών (IDE) σας.

Ο διακομιστής MCP (Model Context Protocol) λειτουργεί ως γέφυρα μεταξύ του βοηθού τεχνητής νοημοσύνης σας και του API Biscotti CMP, παρέχοντας ένα σύνολο εργαλείων που μπορούν να κληθούν απευθείας από το περιβάλλον ανάπτυξης σας.

Προαπαιτούμενα

• Node.js 18 ή νεότερη έκδοση
• Ένας λογαριασμός Biscotti CMP με πρόγραμμα «Agency» ή «LTD Agency»
• Ένα κλειδί API από τη σελίδα «Ρυθμίσεις προγραμματιστή»

Γρήγορη εκκίνηση

Ο πιο γρήγορος τρόπος για να ξεκινήσετε είναι να χρησιμοποιήσετε npx — δεν απαιτείται εγκατάσταση:

npx @biscotti-cmp/mcp-server

Εκτελέστε τον διακομιστή MCP απευθείας, χωρίς να τον εγκαταστήσετε σε επίπεδο συστήματος. Αυτή είναι η συνιστώμενη μέθοδος για τους περισσότερους χρήστες:

npx @biscotti-cmp/mcp-server

Εάν προτιμάτε να εγκαταστήσετε τον MCP Server παγκοσμίως στο σύστημα σας:

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

Μετά την εγκατάσταση, μπορείτε να εκτελέσετε τον διακομιστή απευθείας:

biscotti-mcp

Για να χρησιμοποιήσετε τον διακομιστή Biscotti CMP MCP με το Claude Desktop, προσθέστε την παρακάτω διαμόρφωση στο αρχείο ρυθμίσεων του Claude Desktop.

Θέση του αρχείου ρυθμίσεων

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

Ρυθμίσεις

Προσθέστε τα εξής στο αρχείο ρυθμίσεων σας:

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

Επανεκκινήστε το Claude Desktop αφού αποθηκεύσετε το αρχείο ρυθμίσεων. Τα εργαλεία Biscotti CMP θα εμφανιστούν στο μενού «Εργαλεία».

Για να χρησιμοποιήσετε τον διακομιστή Biscotti CMP MCP με το Cursor, προσθέστε την παρακάτω διαμόρφωση στις ρυθμίσεις του Cursor MCP.

Θέση του αρχείου ρυθμίσεων

• Σε επίπεδο έργου: .cursor/mcp.json στη ρίζα του έργου σας
• Παγκόσμια: ~/.cursor/mcp.json

Ρυθμίσεις

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

Μετά την αποθήκευση, το Cursor θα εντοπίσει αυτόματα τον διακομιστή MCP και θα διαθέσει τα εργαλεία στον βοηθό τεχνητής νοημοσύνης.

Για να χρησιμοποιήσετε τον διακομιστή Biscotti CMP MCP με το Kiro, ρυθμίστε τον μέσω των παραμέτρων του MCP.

Θέση του αρχείου ρυθμίσεων

• Σε επίπεδο έργου: .kiro/settings/mcp.json στη ρίζα του έργου σας
• Παγκόσμια: ~/.kiro/settings/mcp.json

Ρυθμίσεις

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

Το Kiro θα ανιχνεύσει αυτόματα τη διαμόρφωση του διακομιστή MCP και θα διαθέσει τα εργαλεία Biscotti CMP.

Ο διακομιστής Biscotti CMP MCP είναι συμβατός με οποιονδήποτε πελάτη που υποστηρίζει το πρωτόκολλο MCP. Χρησιμοποιήστε την ακόλουθη γενική διαμόρφωση:

Γενικές ρυθμίσεις

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

Εάν ο πελάτης MCP σας χρησιμοποιεί διαφορετική μορφή διαμόρφωσης, οι βασικές παράμετροι είναι:

• Εντολή: npx
• Επιχειρήματα: -y @biscotti-cmp/mcp-server
• Μεταβλητή περιβάλλοντος: BISCOTTI_API_KEY ορίστε το κλειδί API σας

Εργαλεία για τη διαχείριση των ιστοσελίδων σας στο Biscotti CMP.

Εργαλεία για τη δημιουργία και τη διαχείριση των πλαισίων συγκατάθεσης.

Εργαλεία για τη σάρωση ιστοσελίδων και τον έλεγχο της κατάστασης συμμόρφωσης.

Εργαλεία για πρόσβαση σε στατιστικά συγκατάθεσης και δεδομένα αναλύσεων.

Εργαλεία για τη διαχείριση νομικών εγγράφων, όπως πολιτικές απορρήτου, όροι χρήσης και σελίδες νομικών πληροφοριών.

Εργαλεία για τη διαχείριση των εντοπισμένων υπηρεσιών τρίτων και των κατηγοριών συγκατάθεσής τους.

Εργαλεία για τη διαχείριση ενσωματώσεων webhook για ειδοποιήσεις γεγονότων σε πραγματικό χρόνο.

Εργαλεία για τη διαχείριση λογαριασμών πελατών και τις λειτουργίες πρακτορείου.

Ο διακομιστής Biscotti CMP MCP παρέχει τους ακόλουθους πόρους, τους οποίους οι βοηθοί τεχνητής νοημοσύνης μπορούν να αναλύσουν για να κατανοήσουν το πλαίσιο:

• biscotti://websites — Κατάλογος όλων των ιστοσελίδων στον λογαριασμό σας
• biscotti://website/{id} — Λεπτομερείς ρυθμίσεις ιστότοπου
• biscotti://compliance/{id} — Τρέχουσα κατάσταση συμμόρφωσης για έναν ιστότοπο
• biscotti://banners/{websiteId} — Όλα τα banner για έναν ιστότοπο

Οι πόροι παρέχουν πληροφορίες μόνο για ανάγνωση που βοηθούν τους βοηθούς τεχνητής νοημοσύνης να κατανοήσουν την τρέχουσα διαμόρφωσή σας πριν προβούν σε αλλαγές.

Ο διακομιστής MCP περιλαμβάνει ενσωματωμένα πρότυπα προτροπών για συνήθεις ροές εργασιών:

Έλεγχος συμμόρφωσης

Εκτελέστε έναν πλήρη έλεγχο συμμόρφωσης σε έναν ιστότοπο, αναζητώντας cookies, ελέγχοντας τις ρυθμίσεις συγκατάθεσης και δημιουργώντας μια αναφορά.

Εκτελέστε έναν έλεγχο συμμόρφωσης στον ιστότοπό μου example.com και προτείνετε βελτιώσεις.

Ρύθμιση banner

Δημιουργήστε και διαμορφώστε ένα banner συγκατάθεσης με το σχέδιο και τις ρυθμίσεις λειτουργίας που προτιμάτε.

Δημιουργήστε ένα banner συγκατάθεσης συμβατό με GDPR για τον ιστότοπό μου με ένα σκούρο θέμα και θέση κάτω αριστερά.

Δημιουργία νομικών εγγράφων

Δημιουργήστε νομικά έγγραφα με βάση τις ρυθμίσεις του ιστότοπού σας και τη δικαιοδοσία στην οποία απευθύνεστε.

Δημιουργήστε μια πολιτική απορρήτου για τον γερμανικό ιστότοπό μου που καλύπτει το Google Analytics και το Facebook Pixel.

Ο διακομιστής Biscotti CMP MCP απαιτεί ένα κλειδί API για την πιστοποίηση μέσω του API του Biscotti CMP. Όλες οι αιτήσεις που υποβάλλονται από τον διακομιστή MCP πιστοποιούνται χρησιμοποιώντας το κλειδί API σας.

Πώς λειτουργεί η πιστοποίηση

1. Δημιουργείτε ένα κλειδί API στη σελίδα «Ρυθμίσεις προγραμματιστή» του πίνακα ελέγχου του Biscotti CMP.
2. Το κλειδί API έχει οριστεί ως η BISCOTTI_API_KEY μεταβλητή περιβάλλοντος στη διαμόρφωση του πελάτη MCP.
3. Ο διακομιστής MCP συμπεριλαμβάνει αυτό το κλειδί ως διακριτικό Bearer σε όλα τα αιτήματα API.
4. Το API Biscotti CMP επαληθεύει το κλειδί και επιστρέφει δεδομένα που αφορούν τον λογαριασμό σας.

Για να αποκτήσετε ένα κλειδί API για τον διακομιστή MCP:

1. Συνδεθείτε στον πίνακα ελέγχου του Biscotti CMP στη διεύθυνση app.biscotti-cmp.com.
2. Μεταβείτε στις «Ρυθμίσεις προγραμματιστή» στην πλευρική γραμμή.
3. Κάντε κλικ στην επιλογή «Δημιουργία νέου κλειδιού» στην καρτέλα «Κλειδιά API».
4. Δώστε στο κλειδί σας ένα περιγραφικό όνομα (π.χ. «MCP Server - Ανάπτυξη»).
5. Προαιρετικά, ορίστε μια ημερομηνία λήξης για το κλειδί.
6. Αντιγράψτε αμέσως το κλειδί που δημιουργήθηκε — θα εμφανιστεί μόνο μία φορά.

Βέλτιστες πρακτικές διαχείρισης κλειδιών

• Χρησιμοποιήστε ξεχωριστά κλειδιά API για τα περιβάλλοντα ανάπτυξης και παραγωγής.
• Ορίστε ημερομηνίες λήξης για τα κλειδιά που χρησιμοποιούνται προσωρινά.
• Αλλάζετε τακτικά τα κλειδιά και ακυρώνετε τα κλειδιά που δεν χρησιμοποιούνται.
• Χρησιμοποιήστε τη λειτουργία εναλλαγής κλειδιών για να αντικαταστήσετε κλειδιά χωρίς διακοπή λειτουργίας.