Tài liệu Máy chủ MCP

Biscotti CMP MCP Server cho phép các trợ lý AI tương tác với tài khoản Biscotti CMP của bạn một cách программных. Quản lý trang web, biểu ngữ, quét tuân thủ, phân tích đồng ý, tài liệu pháp lý, v.v. — tất cả thông qua các lệnh ngôn ngữ tự nhiên trong IDE của bạn.

MCP (Model Context Protocol) Server hoạt động như một cầu nối giữa trợ lý AI của bạn và Biscotti CMP API, cung cấp một bộ công cụ có thể được gọi trực tiếp từ môi trường phát triển của bạn.

Prerequisites

• Node.js 18 or later
• Một tài khoản Biscotti CMP với gói Agency hoặc LTD Agency
• Một khóa API từ trang Developer Settings

Quick Start

Cách nhanh nhất để bắt đầu là sử dụng npx — không cần cài đặt:

npx @biscotti-cmp/mcp-server

Chạy MCP Server trực tiếp mà không cần cài đặt nó trên toàn cục. Đây là phương pháp được khuyến nghị cho hầu hết người dùng:

npx @biscotti-cmp/mcp-server

Nếu bạn muốn cài đặt MCP Server toàn cục trên hệ thống của mình:

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

Sau khi cài đặt, bạn có thể chạy máy chủ trực tiếp:

biscotti-mcp

Để sử dụng Biscotti CMP MCP Server với Claude Desktop, hãy thêm cấu hình sau vào tệp cài đặt Claude Desktop của bạn.

Vị trí tệp cấu hình

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

Configuration

Thêm phần sau vào tệp cấu hình của bạn:

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

Khởi động lại Claude Desktop sau khi lưu tệp cấu hình. Các công cụ Biscotti CMP sẽ xuất hiện trong menu công cụ.

Để sử dụng Biscotti CMP MCP Server với Cursor, hãy thêm cấu hình sau vào cài đặt Cursor MCP của bạn.

Vị trí tệp cấu hình

• Cấp dự án: .cursor/mcp.json trong thư mục gốc của dự án của bạn
• Toàn cục: ~/.cursor/mcp.json

Configuration

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

Sau khi lưu, Cursor sẽ tự động phát hiện máy chủ MCP và cung cấp các công cụ trong trợ lý AI.

Để sử dụng Biscotti CMP MCP Server với Kiro, hãy định cấu hình nó thông qua cài đặt MCP.

Vị trí tệp cấu hình

• Cấp dự án: .kiro/settings/mcp.json trong thư mục gốc dự án của bạn
• Toàn cục: ~/.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 sẽ tự động phát hiện cấu hình máy chủ MCP và cung cấp các công cụ Biscotti CMP.

Biscotti CMP MCP Server tương thích với mọi máy khách tuân thủ MCP. Sử dụng cấu hình chung sau:

Cấu hình chung

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

Nếu máy khách MCP của bạn sử dụng định dạng cấu hình khác, các tham số chính là:

• Lệnh: npx
• Đối số: -y @biscotti-cmp/mcp-server
• Biến môi trường: BISCOTTI_API_KEY được đặt thành khóa API của bạn

Công cụ quản lý các trang web của bạn trong Biscotti CMP.

Công cụ để tạo và quản lý banner chấp thuận.

Công cụ quét trang web và kiểm tra trạng thái tuân thủ.

Công cụ truy cập thống kê đồng ý và dữ liệu phân tích.

Công cụ để quản lý các tài liệu pháp lý như chính sách bảo mật, điều khoản dịch vụ và trang imprint.

Các công cụ để quản lý các dịch vụ bên thứ ba được phát hiện và các danh mục đồng ý của chúng.

Công cụ quản lý tích hợp webhook cho thông báo sự kiện theo thời gian thực.

Công cụ quản lý tài khoản khách hàng và hoạt động của đại lý.

Máy chủ Biscotti CMP MCP cung cấp các tài nguyên sau mà trợ lý AI có thể đọc để lấy ngữ cảnh:

• biscotti://websites — Danh sách tất cả các trang web trong tài khoản của bạn
• biscotti://website/{id} — Cấu hình trang web chi tiết
• biscotti://compliance/{id} — Trạng thái tuân thủ hiện tại cho một trang web
• biscotti://banners/{websiteId} — Tất cả banner cho một trang web

Tài nguyên cung cấp ngữ cảnh chỉ đọc, giúp các trợ lý AI hiểu thiết lập hiện tại của bạn trước khi thực hiện thay đổi.

MCP Server bao gồm các mẫu lời nhắc tích hợp cho các quy trình làm việc phổ biến:

Compliance Audit

Chạy kiểm tra tuân thủ đầy đủ trên một trang web, quét cookie, kiểm tra cấu hình chấp thuận và tạo báo cáo.

Chạy kiểm tra tuân thủ trên trang web example.com của tôi và đề xuất các cải tiến.

Banner Setup

Tạo và cấu hình một banner chấp thuận với thiết kế và cài đặt hành vi ưa thích của bạn.

Tạo một banner chấp thuận tuân thủ GDPR cho trang web của tôi với chủ đề tối và vị trí phía dưới bên trái.

Tạo Tài Liệu Pháp Lý

Tạo tài liệu pháp lý dựa trên cấu hình trang web và khu vực pháp lý mục tiêu của bạn.

Tạo chính sách bảo mật cho trang web tiếng Đức của tôi bao gồm Google Analytics và Facebook Pixel.

Biscotti CMP MCP Server yêu cầu khóa API để xác thực với Biscotti CMP API. Tất cả các yêu cầu được thực hiện bởi MCP Server đều được xác thực bằng khóa API của bạn.

Cách Thức Xác Thực

1. Bạn tạo khóa API trong trang Cài đặt Nhà phát triển của bảng điều khiển Biscotti CMP của bạn.
2. Khóa API được đặt làm biến môi trường BISCOTTI_API_KEY trong cấu hình máy khách MCP của bạn.
3. MCP Server bao gồm khóa này dưới dạng mã thông báo Bearer trong tất cả các yêu cầu API.
4. Biscotti CMP API xác thực khóa và trả về dữ liệu được giới hạn trong tài khoản của bạn.

Để lấy khóa API cho MCP Server:

1. Đăng nhập vào bảng điều khiển Biscotti CMP của bạn tại app.biscotti-cmp.com.
2. Điều hướng đến Cài đặt Nhà phát triển trong thanh bên.
3. Nhấp vào Tạo Khóa Mới trong tab Khóa API.
4. Đặt cho khóa của bạn một tên mô tả (ví dụ: "MCP Server - Phát triển").
5. Tùy chọn đặt ngày hết hạn cho khóa.
6. Sao chép khóa đã tạo ngay lập tức — nó sẽ chỉ được hiển thị một lần.

Các Phương Pháp Hay Nhất Để Quản Lý Khóa

• Sử dụng các khóa API riêng biệt cho môi trường phát triển và sản xuất.
• Đặt ngày hết hạn cho các khóa được sử dụng tạm thời.
• Xoay vòng khóa thường xuyên và thu hồi các khóa không sử dụng.
• Sử dụng tính năng xoay vòng khóa để thay thế khóa mà không cần thời gian ngừng hoạt động.