Dokumentasi Server MCP

Server Biscotti CMP MCP memungkinkan asisten AI untuk berinteraksi dengan akun Biscotti CMP Anda secara terprogram. Kelola situs web, spanduk, pemindaian kepatuhan, analisis persetujuan, dokumen hukum, dan banyak lagi — semuanya melalui perintah bahasa alami di IDE Anda.

Server MCP (Model Context Protocol) berfungsi sebagai jembatan antara asisten AI Anda dan API Biscotti CMP, serta menyediakan serangkaian alat yang dapat dipanggil langsung dari lingkungan pengembangan Anda.

Persyaratan

• Node.js 18 atau yang lebih baru
• Akun Biscotti CMP dengan paket Agency atau LTD Agency
• Kunci API dari halaman Pengaturan Pengembang

Panduan Singkat

Cara tercepat untuk memulai adalah dengan menggunakan npx — tidak perlu instalasi:

npx @biscotti-cmp/mcp-server

Jalankan Server MCP secara langsung tanpa menginstalnya secara global. Ini adalah cara yang disarankan bagi sebagian besar pengguna:

npx @biscotti-cmp/mcp-server

Jika Anda lebih suka memasang Server MCP secara global di sistem Anda:

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

Setelah pemasangan, Anda dapat menjalankan server langsung:

biscotti-mcp

Untuk menggunakan Biscotti CMP MCP Server bersama Claude Desktop, tambahkan konfigurasi berikut ke berkas pengaturan Claude Desktop Anda.

Lokasi Berkas Konfigurasi

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

Konfigurasi

Tambahkan baris berikut ke berkas konfigurasi Anda:

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

Mulai ulang Claude Desktop setelah menyimpan berkas konfigurasi. Alat-alat Biscotti CMP akan muncul di menu alat.

Untuk menggunakan Biscotti CMP MCP Server dengan Cursor, tambahkan konfigurasi berikut ke pengaturan Cursor MCP Anda.

Lokasi Berkas Konfigurasi

• Tingkat proyek: .cursor/mcp.json di direktori akar proyek Anda
• Global: ~/.cursor/mcp.json

Konfigurasi

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

Setelah disimpan, Cursor akan secara otomatis mendeteksi server MCP dan menampilkan alat-alat tersebut di asisten AI.

Untuk menggunakan Biscotti CMP MCP Server bersama Kiro, konfigurasikan melalui pengaturan MCP.

Lokasi Berkas Konfigurasi

• Tingkat proyek: .kiro/settings/mcp.json di direktori akar proyek Anda
• Global: ~/.kiro/settings/mcp.json

Konfigurasi

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

Kiro akan secara otomatis mendeteksi konfigurasi server MCP dan menyediakan alat-alat Biscotti CMP.

Server Biscotti CMP MCP kompatibel dengan semua klien yang mendukung MCP. Gunakan konfigurasi umum berikut ini:

Konfigurasi Umum

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

Jika klien MCP Anda menggunakan format konfigurasi yang berbeda, parameter utamanya adalah:

• Perintah: npx
• Argumen: -y @biscotti-cmp/mcp-server
• Variabel lingkungan: BISCOTTI_API_KEY atur ke kunci API Anda

Alat untuk mengelola situs web Anda di Biscotti CMP.

Alat untuk membuat dan mengelola spanduk persetujuan.

Alat untuk memindai situs web dan memeriksa status kepatuhan.

Alat untuk mengakses statistik persetujuan dan data analitik.

Alat untuk mengelola dokumen hukum seperti kebijakan privasi, ketentuan layanan, dan halaman informasi penerbit.

Alat untuk mengelola layanan pihak ketiga yang terdeteksi dan kategori persetujuan mereka.

Alat untuk mengelola integrasi webhook untuk notifikasi acara secara real-time.

Alat untuk manajemen akun klien dan operasi agensi.

Server Biscotti CMP MCP menyediakan sumber daya berikut yang dapat dibaca oleh asisten AI untuk memahami konteks:

• biscotti://situs-web — Daftar semua situs web di akun Anda
• biscotti://website/{id} — Konfigurasi situs web secara terperinci
• biscotti://compliance/{id} — Status kepatuhan terkini untuk sebuah situs web
• biscotti://banners/{websiteId} — Semua spanduk untuk sebuah situs web

Sumber daya menyediakan konteks yang hanya dapat dibaca yang membantu asisten AI memahami konfigurasi Anda saat ini sebelum melakukan perubahan.

Server MCP dilengkapi dengan templat prompt bawaan untuk alur kerja umum:

Audit Kepatuhan

Lakukan audit kepatuhan menyeluruh pada sebuah situs web, termasuk pemindaian cookie, pemeriksaan konfigurasi persetujuan, dan pembuatan laporan.

Jalankan audit kepatuhan pada situs web saya example.com dan sarankan perbaikan.

Pengaturan Banner

Buat dan atur spanduk persetujuan dengan desain dan pengaturan perilaku yang Anda inginkan.

Buat banner persetujuan yang sesuai dengan GDPR untuk situs web saya dengan tema gelap dan posisi kiri bawah.

Pembuatan Dokumen Hukum

Buat dokumen hukum berdasarkan konfigurasi situs web Anda dan yurisdiksi yang menjadi sasaran.

Hasilkan kebijakan privasi untuk situs web Jerman saya yang mencakup Google Analytics dan Facebook Pixel.

Server Biscotti CMP MCP memerlukan kunci API untuk otentikasi dengan API Biscotti CMP. Semua permintaan yang dibuat oleh Server MCP diotentikasi menggunakan kunci API Anda.

Cara Kerja Otentikasi

1. Anda dapat membuat kunci API di halaman Pengaturan Pengembang pada dasbor Biscotti CMP Anda.
2. Kunci API ditetapkan sebagai BISCOTTI_API_KEY variabel lingkungan dalam konfigurasi klien MCP Anda.
3. Server MCP menyertakan kunci ini sebagai token Bearer dalam semua permintaan API.
4. API Biscotti CMP memverifikasi kunci dan mengembalikan data yang terbatas pada akun Anda.

Untuk mendapatkan kunci API untuk Server MCP:

1. Masuk ke dasbor Biscotti CMP Anda di app.biscotti-cmp.com.
2. Buka Pengaturan Pengembang di bilah samping.
3. Klik "Buat Kunci Baru" di tab Kunci API.
4. Beri nama yang deskriptif pada kunci Anda (misalnya, "Server MCP - Pengembangan").
5. Anda dapat menetapkan tanggal kedaluwarsa untuk kunci tersebut.
6. Segera salin kunci yang dihasilkan — kunci tersebut hanya akan ditampilkan sekali.

Praktik Terbaik dalam Pengelolaan Kunci

• Gunakan kunci API yang berbeda untuk lingkungan pengembangan dan produksi.
• Tetapkan tanggal kedaluwarsa pada kunci yang digunakan sementara.
• Gantilah kunci secara berkala dan cabut kunci yang tidak digunakan.
• Gunakan fitur rotasi kunci untuk mengganti kunci tanpa menghentikan operasional.