跳至內容
Biscotti CMP
價格下載文件MCP Server部落格
登入免費開始
首頁›zh-TW
MCP 伺服器
開始使用
  • 概述
  • 使用 npx 執行
  • 全球安裝
IDE 設定
  • Claude 桌面版
  • 游標
  • 你好
  • 其他 MCP 客戶
可用工具
  • 網站管理
  • 橫幅管理
  • 合規性掃描
  • 同意分析
  • 法律文件
  • 服務
  • Webhook
  • 代理機構
資源與提示
  • MCP 資源
  • 提示範本
驗證
  • API 金鑰要求
  • 取得 API 金鑰
MCP 伺服器文件

MCP 伺服器文件

開始使用

概述

Biscotti CMP MCP 伺服器讓 AI 助理能夠透過程式化方式與您的 Biscotti CMP 帳戶進行互動。您可透過整合開發環境 (IDE) 中的自然語言指令,管理網站、橫幅廣告、合規性掃描、同意分析、法律文件等各項功能。

MCP(模型上下文協定)伺服器充當您的 AI 助理與 Biscotti CMP API 之間的橋樑,提供一套可直接從您的開發環境中調用的工具。

先決條件

  • Node.js 18 或更新版本
  • 一個採用「代理商」或「有限責任公司代理商」方案的 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 桌面版

若要將 Biscotti CMP MCP 伺服器與 Claude Desktop 搭配使用,請在您的 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

列出網站的掃描結果,包括偵測到的 Cookie 和服務。

generate_compliance_report

為網站產生合規性報告。

同意分析

用於存取同意統計和分析數據的工具。

get_consent_stats

獲取同意統計,包括選擇加入率、同意分佈和隨時間變化的趨勢。

export_consent_logs

匯出詳細的同意紀錄,以用於稽核和合規性報告。使用 lookup_consent 可透過同意 ID 查詢單一同意紀錄。

法律文件

用於管理法律文件的工具,例如隱私權政策、服務條款及版權聲明頁面。

list_legal_documents

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

get_legal_document

取得特定法律文件的內容和設定。

產生法律文件

根據您的網站設定和管轄區,產生新的法律文件。

服務

用於管理偵測到的第三方服務及其同意分類的工具。

list_services

列出網站所有偵測到的第三方服務。

update_service_category

更新服務的同意分類或封鎖配置。

Webhook

用於管理 webhook 整合以接收即時事件通知的工具。

list_webhooks

列出您帳戶的所有已配置 webhook。

create_webhook

建立一個新的 Webhook 端點以接收同意事件(consent.granted、consent.revoked)。

delete_webhook

刪除 webhook 端點。

test_webhook

向 webhook 端點發送測試事件以驗證連線。

代理機構

代理帳戶管理和客戶操作的工具。

list_agency_clients

列出您的代理商管理的所有客戶帳戶。

get_agency_usage

獲取所有客戶帳戶的使用報告,包括 Session 計數和功能使用情況。

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. 請登入您的 Biscotti CMP 控制台,網址為 app.biscotti-cmp.com。
  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 提供的服務