เอกสารประกอบเซิร์ฟเวอร์ MCP

Biscotti CMP MCP Server ช่วยให้ผู้ช่วย AI สามารถโต้ตอบกับบัญชี Biscotti CMP ของคุณได้โดยทางโปรแกรม จัดการเว็บไซต์ แบนเนอร์ การสแกนการปฏิบัติตามข้อกำหนด การวิเคราะห์ความยินยอม เอกสารทางกฎหมาย และอื่นๆ อีกมากมาย ทั้งหมดนี้ผ่านคำสั่งภาษาธรรมชาติใน IDE ของคุณ

MCP (Model Context Protocol) Server ทำหน้าที่เป็นสะพานเชื่อมระหว่างผู้ช่วย AI ของคุณกับ Biscotti CMP API โดยจัดชุดเครื่องมือที่สามารถเรียกใช้ได้โดยตรงจากสภาพแวดล้อมการพัฒนาของคุณ

Prerequisites

• Node.js 18 or later
• บัญชี Biscotti CMP ที่มีแผน Agency หรือ LTD Agency
• API key จากหน้า Developer Settings

Quick Start

วิธีที่เร็วที่สุดในการเริ่มต้นคือการใช้ npx ไม่จำเป็นต้องติดตั้ง:

npx @biscotti-cmp/mcp-server

เรียกใช้ MCP Server โดยตรงโดยไม่ต้องติดตั้งทั่วโลก นี่คือแนวทางที่แนะนำสำหรับผู้ใช้ส่วนใหญ่:

npx @biscotti-cmp/mcp-server

หากคุณต้องการติดตั้ง MCP Server ทั่วระบบบนระบบของคุณ:

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

หลังจากติดตั้ง คุณสามารถรันเซิร์ฟเวอร์โดยตรง:

biscotti-mcp

ในการใช้ Biscotti CMP MCP Server กับ Claude Desktop ให้เพิ่มการกำหนดค่าต่อไปนี้ลงในไฟล์การตั้งค่า Claude Desktop ของคุณ

ตำแหน่งไฟล์การกำหนดค่า

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

Configuration

เพิ่มสิ่งต่อไปนี้ลงในไฟล์การกำหนดค่าของคุณ:

{
  "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 Server กับ Cursor ให้เพิ่มการกำหนดค่าต่อไปนี้ลงในการตั้งค่า Cursor MCP ของคุณ

ตำแหน่งไฟล์การกำหนดค่า

• Project-level: .cursor/mcp.json ใน root ของโปรเจ็กต์ของคุณ
• Global: ~/.cursor/mcp.json

Configuration

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

หลังจากบันทึก Cursor จะตรวจพบ MCP server โดยอัตโนมัติ และทำให้เครื่องมือพร้อมใช้งานใน AI assistant

ในการใช้ Biscotti CMP MCP Server กับ Kiro ให้กำหนดค่าผ่านการตั้งค่า MCP

ตำแหน่งไฟล์การกำหนดค่า

• Project-level: .kiro/settings/mcp.json ใน root ของโปรเจ็กต์ของคุณ
• Global: ~/.kiro/settings/mcp.json

Configuration

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

Kiro จะตรวจพบการกำหนดค่า MCP server โดยอัตโนมัติ และทำให้เครื่องมือ Biscotti CMP พร้อมใช้งาน

Biscotti CMP MCP Server เข้ากันได้กับไคลเอนต์ที่รองรับ 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 key ของคุณ

เครื่องมือสำหรับจัดการเว็บไซต์ของคุณใน Biscotti CMP

เครื่องมือสำหรับสร้างและจัดการแบนเนอร์ยินยอม

เครื่องมือสำหรับสแกนเว็บไซต์และตรวจสอบสถานะการปฏิบัติตามกฎระเบียบ

เครื่องมือสำหรับเข้าถึงสถิติความยินยอมและข้อมูลวิเคราะห์

เครื่องมือสำหรับจัดการเอกสารทางกฎหมาย เช่น นโยบายความเป็นส่วนตัว ข้อกำหนดในการให้บริการ และหน้าประทับ

เครื่องมือสำหรับจัดการบริการของบุคคลที่สามที่ตรวจพบและหมวดหมู่ความยินยอมของบริการเหล่านั้น

เครื่องมือสำหรับจัดการการรวม webhook สำหรับการแจ้งเตือนเหตุการณ์แบบเรียลไทม์

เครื่องมือสำหรับการจัดการบัญชีลูกค้าและการดำเนินงานของลูกค้า

Biscotti CMP MCP Server แสดงทรัพยากรต่อไปนี้ที่ผู้ช่วย AI สามารถอ่านเพื่อเป็นบริบท:

• biscotti://websites — รายการเว็บไซต์ทั้งหมดในบัญชีของคุณ
• biscotti://website/{id} — การกำหนดค่าเว็บไซต์โดยละเอียด
• biscotti://compliance/{id} — สถานะการปฏิบัติตามข้อกำหนดปัจจุบันสำหรับเว็บไซต์
• biscotti://banners/{websiteId} — แบนเนอร์ทั้งหมดสำหรับเว็บไซต์

ทรัพยากรให้บริบทแบบอ่านอย่างเดียวที่ช่วยให้ผู้ช่วย AI เข้าใจการตั้งค่าปัจจุบันของคุณก่อนทำการเปลี่ยนแปลง

MCP Server มีเทมเพลตพร้อมท์ในตัวสำหรับเวิร์กโฟลว์ทั่วไป:

Compliance Audit

เรียกใช้การตรวจสอบการปฏิบัติตามข้อกำหนดทั้งหมดบนเว็บไซต์ สแกนหาคุกกี้ ตรวจสอบการกำหนดค่าความยินยอม และสร้างรายงาน

เรียกใช้การตรวจสอบการปฏิบัติตามข้อกำหนดบนเว็บไซต์ example.com ของฉัน และแนะนำการปรับปรุง

Banner Setup

สร้างและกำหนดค่าแบนเนอร์ความยินยอมด้วยการออกแบบและการตั้งค่าลักษณะการทำงานที่คุณต้องการ

สร้างแบนเนอร์ความยินยอมที่สอดคล้องกับ GDPR สำหรับเว็บไซต์ของฉันด้วยธีมสีเข้มและตำแหน่งด้านล่างซ้าย

การสร้างเอกสารทางกฎหมาย

สร้างเอกสารทางกฎหมายตามการกำหนดค่าเว็บไซต์และเขตอำนาจศาลเป้าหมายของคุณ

สร้างนโยบายความเป็นส่วนตัวสำหรับเว็บไซต์ภาษาเยอรมันของฉันที่ครอบคลุม Google Analytics และ Facebook Pixel

Biscotti CMP MCP Server ต้องใช้ API key เพื่อรับรองความถูกต้องกับ Biscotti CMP API คำขอทั้งหมดที่ส่งโดย MCP Server จะได้รับการรับรองความถูกต้องโดยใช้ API key ของคุณ

วิธีการรับรองความถูกต้อง

1. คุณสร้าง API key ได้ในหน้า Developer Settings ของแดชบอร์ด Biscotti CMP ของคุณ
2. API key จะถูกตั้งค่าเป็นตัวแปรสภาพแวดล้อม BISCOTTI_API_KEY ในการกำหนดค่าไคลเอนต์ MCP ของคุณ
3. MCP Server จะรวมคีย์นี้เป็นโทเค็น Bearer ในคำขอ API ทั้งหมด
4. Biscotti CMP API จะตรวจสอบคีย์และส่งคืนข้อมูลที่กำหนดขอบเขตไว้สำหรับบัญชีของคุณ

หากต้องการรับ API key สำหรับ MCP Server:

1. เข้าสู่ระบบแดชบอร์ด Biscotti CMP ของคุณที่ app.biscotti-cmp.com
2. นำทางไปยัง Developer Settings ในแถบด้านข้าง
3. คลิก Generate New Key ในแท็บ API Keys
4. ตั้งชื่อคีย์ของคุณให้สื่อความหมาย (เช่น "MCP Server - Development")
5. หรือจะตั้งค่าวันหมดอายุสำหรับคีย์ก็ได้
6. คัดลอกคีย์ที่สร้างขึ้นทันที — จะแสดงเพียงครั้งเดียวเท่านั้น

แนวทางปฏิบัติที่ดีที่สุดในการจัดการคีย์

• ใช้ API key แยกกันสำหรับสภาพแวดล้อมการพัฒนาและการใช้งานจริง
• ตั้งค่าวันที่หมดอายุสำหรับคีย์ที่ใช้ชั่วคราว
• หมุนเวียนคีย์เป็นประจำและเพิกถอนคีย์ที่ไม่ได้ใช้งาน
• ใช้คุณสมบัติการหมุนเวียนคีย์เพื่อแทนที่คีย์โดยไม่หยุดทำงาน