跳至内容
Biscotti CMP
定价下载文档MCP Server博客
登录免费开始
首页›MCP 服务器
MCP 服务器
入门指南
  • 概述
  • 使用 npx 运行
  • 全球安装
IDE 设置
  • Claude 桌面版
  • 光标
  • 你好
  • 其他 MCP 客户
可用工具
  • 网站管理
  • 横幅管理
  • 合规扫描
  • 同意分析
  • 法律文件
  • 服务
  • Webhooks
  • 代理机构
资源与提示
  • MCP 资源
  • 提示模板
身份验证
  • API密钥要求
  • 获取 API 密钥
MCP 服务器文档

MCP 服务器文档

入门指南

概述

Biscotti CMP MCP 服务器支持 AI 助手通过编程方式与您的 Biscotti CMP 账户进行交互。您可通过 IDE 中的自然语言命令,管理网站、横幅广告、合规性扫描、同意分析、法律文件等各项内容。

MCP(模型上下文协议)服务器充当您的 AI 助手与 Biscotti CMP API 之间的桥梁,提供了一套可直接从您的开发环境中调用的工具。

先决条件

  • Node.js 18 或更高版本
  • 一个采用代理商或LTD代理商方案的Biscotti CMP账户
  • 来自“开发者设置”页面的 API 密钥

快速入门

最快捷的入门方式是使用 npx — 无需安装:

bash
npx @biscotti-cmp/mcp-server

使用 npx 运行

直接运行 MCP 服务器,无需进行全局安装。这是对大多数用户推荐的做法:

bash
npx @biscotti-cmp/mcp-server
成功

使用 npx时,服务器会即时下载并运行。您的 IDE 配置将自动处理此过程。

全球安装

如果您更倾向于在系统上全局安装 MCP 服务器:

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

安装后,您可以直接运行服务器:

bash
biscotti-mcp
成功

全局安装适用于希望更快启动时间或需要在无互联网访问的环境中运行服务器的情况。

IDE 设置

Claude 桌面版

若要在 Claude Desktop 中使用 Biscotti CMP MCP 服务器,请在您的 Claude Desktop 设置文件中添加以下配置。

配置文件位置
  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
配置

在配置文件中添加以下内容:

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

请将 your-api-key-here 请在“开发者设置”页面中将此处替换为您的实际 API 密钥。

保存配置文件后,请重新启动 Claude Desktop。Biscotti CMP 工具将出现在“工具”菜单中。

光标

若要在 Cursor 中使用 Biscotti CMP MCP 服务器,请在您的 Cursor MCP 设置中添加以下配置。

配置文件位置
  • 项目级别: .cursor/mcp.json 在项目根目录下
  • 全球: ~/.cursor/mcp.json
配置
json
{
  "mcpServers": {
    "biscotti-cmp": {
      "command": "npx",
      "args": ["-y", "@biscotti-cmp/mcp-server"],
      "env": {
        "BISCOTTI_API_KEY": "your-api-key-here"
      }
    }
  }
}
成功

请将 your-api-key-here 请在“开发者设置”页面中将此处替换为您的实际 API 密钥。

保存后,Cursor 将自动检测 MCP 服务器,并在 AI 助手中提供相应工具。

你好

若要将 Biscotti CMP MCP 服务器与 Kiro 配合使用,请通过 MCP 设置进行配置。

配置文件位置
  • 项目级别: .kiro/settings/mcp.json 在项目根目录下
  • 全球: ~/.kiro/settings/mcp.json
配置
json
{
  "mcpServers": {
    "biscotti-cmp": {
      "command": "npx",
      "args": ["-y", "@biscotti-cmp/mcp-server"],
      "env": {
        "BISCOTTI_API_KEY": "your-api-key-here"
      }
    }
  }
}
成功

请将 your-api-key-here 请在“开发者设置”页面中将此处替换为您的实际 API 密钥。

Kiro 将自动检测 MCP 服务器配置,并提供 Biscotti CMP 工具。

其他 MCP 客户

Biscotti CMP MCP 服务器与任何符合 MCP 标准的客户端均兼容。请使用以下通用配置:

通用配置
json
{
  "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 密钥
成功

请查阅 MCP 客户端文档,了解配置文件的确切位置和格式。

可用工具

网站管理

用于在 Biscotti CMP 中管理您的网站的工具。

list_websites

列出您账户中的所有网站及其配置和状态。

get_website

获取特定网站的详细信息,包括设置、域名和扫描状态。

create_website

使用域名、名称和配置选项创建新网站。

update_website

更新网站设置,例如名称、域名或配置选项。

get_install_script

获取网站的 JavaScript 安装代码片段,可直接粘贴到 HTML 中。

横幅管理

用于创建和管理同意横幅的工具。

list_banners

列出网站的所有同意横幅。

get_banner

获取详细的横幅配置,包括颜色、文本和定位。

create_banner

创建一个具有可自定义设计和行为设置的新同意横幅。

update_banner

更新现有横幅的设计、文本或行为配置。

delete_banner

删除一个同意横幅。

get_banner_embed

获取特定横幅的嵌入代码。

合规扫描

用于扫描网站和检查合规状态的工具。

trigger_scan

启动新的合规扫描以检测网站上的 Cookie、跟踪器和第三方服务。

list_scans

列出网站的 scans,包括检测到的 cookies 和服务。

generate_compliance_report

为网站生成合规性报告。

同意分析

用于访问同意统计信息和分析数据的工具。

get_consent_stats

获取同意统计信息,包括选择加入率、同意分布和时间趋势。

export_consent_logs

导出详细的 consent 日志,用于审计和合规性报告。使用 lookup_consent 通过 Consent ID 查找单个 consent 记录。

法律文件

用于管理法律文件的工具,例如隐私政策、服务条款和版权声明页面。

list_legal_documents

列出网站的所有法律文件。

get_legal_document

获取特定法律文件的内容和配置。

生成法律文件

根据您的网站配置和管辖区域生成新的法律文件。

服务

用于管理检测到的第三方服务及其 consent 分类的工具。

list_services

列出网站所有检测到的第三方服务。

update_service_category

更新服务的 consent 分类或拦截配置。

Webhooks

用于管理 webhook 集成以实现实时事件通知的工具。

list_webhooks

列出您账户中配置的所有 webhook。

create_webhook

创建一个新的 webhook 终点,用于接收 consent 事件(consent.granted、consent.revoked)。

delete_webhook

删除 webhook 端点。

test_webhook

向 webhook 端点发送测试事件以验证连接。

代理机构

用于代理账户管理和客户运营的工具。

list_agency_clients

列出您的代理管理的所有客户账户。

get_agency_usage

获取所有客户账户的使用报告,包括会话计数和功能使用情况。

create_agency_client

在您的代理账户下创建新的客户账户。

资源与提示

MCP 资源

Biscotti CMP MCP 服务器提供了以下资源,AI 助手可读取这些资源以获取上下文信息:

  • biscotti://websites — 您账户中的所有网站列表
  • biscotti://website/{id} — 网站详细配置
  • biscotti://compliance/{id} — 网站的当前合规状态
  • biscotti://banners/{websiteId} — 某个网站的所有横幅广告

资源提供只读上下文,有助于 AI 助手在进行更改前了解您的当前设置。

提示模板

MCP 服务器内置了适用于常见工作流的提示模板:

合规审计

对网站进行全面的合规性审计,包括扫描Cookie、检查同意设置并生成报告。

text
对我的网站 example.com 运行合规性审计,并提出改进建议。
横幅设置

创建并配置一个符合您偏好的设计和行为设置的同意横幅。

text
为我的网站创建一个符合 GDPR 要求的同意横幅,采用深色主题和左下角位置。
法律文件生成

根据您的网站配置和目标司法管辖区生成法律文件。

text
为我的德国网站生成一份隐私政策,其中涵盖 Google Analytics 和 Facebook Pixel。

身份验证

API密钥要求

Biscotti CMP MCP 服务器需要一个 API 密钥来通过 Biscotti CMP API 进行身份验证。MCP 服务器发出的所有请求均使用您的 API 密钥进行身份验证。

身份验证的工作原理

  1. 您可以在 Biscotti CMP 控制台的“开发者设置”页面中生成 API 密钥。
  2. API 密钥已设置为 BISCOTTI_API_KEY 环境变量。
  3. MCP 服务器会在所有 API 请求中将此密钥作为 Bearer 令牌包含在内。
  4. Biscotti CMP API 会验证密钥,并返回与您的账户相关的数据。
警告

请妥善保管您的 API 密钥。切勿将其提交至版本控制系统或公开分享。若密钥泄露,请立即通过“开发者设置”页面进行轮换。

获取 API 密钥

要获取 MCP 服务器的 API 密钥:

  1. 请登录 app.biscotti-cmp.com 访问您的 Biscotti CMP 控制面板。
  2. 在侧边栏中导航至“开发者设置”。
  3. 在“API 密钥”选项卡中点击“生成新密钥”。
  4. 为您的密钥指定一个描述性名称(例如,“MCP 服务器 - 开发”)。
  5. 可选地为密钥设置过期日期。
  6. 请立即复制生成的密钥——它只会显示一次。
成功

API 密钥仅在“代理”和“LTD 代理”套餐中提供。如果您未看到“开发者设置”页面,可能需要升级您的套餐。

密钥管理最佳实践
  • 请为开发环境和生产环境分别使用不同的 API 密钥。
  • 为临时使用的密钥设置过期日期。
  • 定期轮换密钥,并撤销未使用的密钥。
  • 利用密钥轮换功能,可在不影响服务的情况下更换密钥。
Biscotti CMP

Made with 🍪 in Germany.

产品

关于我们功能定价文档MCP 服务器Cookie 检查无障碍下载Legal WatchdogAssessment EngineTrust PortalEnterprise隐私与同意知识库博客Cookie同意与隐私术语表适用地区无障碍作为设计原则

法律

版本说明隐私政策服务条款撤销权DPA(数据保护协议)Cookie 政策

联系方式

联系方式
© 2026 Biscotti – Campcruisers GmbH 的一项服务