MCPサーバーのドキュメント

Biscotti CMP MCP Server を使用すると、AIアシスタントがプログラム経由でBiscotti CMPアカウントと連携できるようになります。ウェブサイト、バナー、コンプライアンススキャン、同意分析、法的文書などを、IDE内の自然言語コマンドだけで管理できます。

MCP（Model Context Protocol）サーバーは、AIアシスタントとBiscotti CMP APIとの間の橋渡し役として機能し、開発環境から直接呼び出すことができる一連のツールを提供します。

前提条件

• Node.js 18 以降
• エージェンシープランまたはLTDエージェンシープランのBiscotti CMPアカウント
• 「開発者設定」ページにあるAPIキー

クイックスタート

すぐに始めるには、 npx — インストール不要：

npx @biscotti-cmp/mcp-server

MCPサーバーをグローバルにインストールせずに、直接実行します。これは、ほとんどのユーザーにとって推奨される方法です：

npx @biscotti-cmp/mcp-server

MCPサーバーをシステム全体にインストールする場合:

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

設定

設定ファイルに以下を追加してください：

{
  "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の設定に以下の設定を追加してください。

設定ファイルの保存場所

• プロジェクトレベル： .cursor/mcp.json プロジェクトのルートディレクトリ内
• グローバル： ~/.cursor/mcp.json

設定

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

保存後、Cursorが自動的にMCPサーバーを検出し、AIアシスタントでツールが利用可能になります。

Biscotti CMP MCP ServerをKiroで使用するには、MCPの設定から構成を行ってください。

設定ファイルの保存場所

• プロジェクトレベル： .kiro/settings/mcp.json プロジェクトのルートディレクトリ内
• 世界全体： ~/.kiro/settings/mcp.json

設定

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

KiroはMCPサーバーの設定を自動的に検出し、Biscotti CMPツールを利用可能にします。

Biscotti CMP MCPサーバーは、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キーを設定してください

Biscotti CMPでウェブサイトを管理するためのツール。

同意バナーの作成・管理ツール。

ウェブサイトをスキャンし、コンプライアンスステータスを確認するためのツール。

同意統計と分析データにアクセスするためのツール。

プライバシーポリシー、利用規約、サイト運営者情報ページなどの法的文書を管理するためのツール。

検出されたサードパーティサービスと、その同意カテゴリを管理するためのツール。

リアルタイムイベント通知用のウェブフック統合を管理するためのツール。

代理店アカウント管理とクライアント運用のためのツール。

Biscotti CMP MCPサーバーは、AIアシスタントがコンテキストとして参照できる以下のリソースを提供しています：

• biscotti://websites — アカウント内のすべてのウェブサイトのリスト
• biscotti://website/{id} — ウェブサイトの詳細設定
• biscotti://compliance/{id} — ウェブサイトの現在のコンプライアンス状況
• biscotti://banners/{websiteId} — 特定のウェブサイトのすべてのバナー

リソースは、AIアシスタントが変更を加える前に現在の設定を把握するのに役立つ、読み取り専用のコンテキストを提供します。

MCPサーバーには、一般的なワークフロー用の組み込みプロンプトテンプレートが用意されています：

コンプライアンス監査

ウェブサイトに対して包括的なコンプライアンス監査を実施し、Cookieのスキャン、同意設定の確認を行い、レポートを作成します。

私のウェブサイト example.com でコンプライアンス監査を実施し、改善点を提案してください。

バナーの設定

お好みのデザインや動作設定で、同意バナーを作成・設定してください。

ダークテーマと左下の位置で、私のウェブサイト用のGDPR準拠の同意バナーを作成してください。

法的文書の作成

ウェブサイトの設定と対象となる法域に基づいて、法的文書を生成します。

Google AnalyticsとFacebook Pixelをカバーする、私のドイツのウェブサイト用のプライバシーポリシーを生成してください。

Biscotti CMP MCPサーバーは、Biscotti CMP API への認証を行うためにAPIキーを必要とします。MCPサーバーから送信されるすべてのリクエストは、お客様のAPIキーを使用して認証されます。

認証の仕組み

1. Biscotti CMPダッシュボードの「開発者設定」ページでAPIキーを生成します。
2. APIキーは、MCPクライアントの設定内の BISCOTTI_API_KEY 環境変数として設定されています。
3. MCPサーバーは、すべてのAPIリクエストにおいて、このキーをベアラートークンとして含めます。
4. Biscotti CMP APIはキーの有効性を確認し、お客様のアカウントに限定されたデータを返します。

MCPサーバーのAPIキーを取得するには：

1. app.biscotti-cmp.com にアクセスし、Biscotti CMP ダッシュボードにログインしてください。
2. サイドバーの「開発者向け設定」に移動します。
3. 「API キー」タブで「新しいキーを生成」をクリックします。
4. キーにわかりやすい名前を付けます（例：「MCPサーバー - 開発」）。
5. 必要に応じて、キーの有効期限を設定します。
6. 生成されたキーはすぐにコピーしてください。一度しか表示されません。

鍵管理のベストプラクティス

• 開発環境と本番環境では、それぞれ別のAPIキーを使用してください。
• 一時的に使用されるキーには有効期限を設定してください。
• 鍵を定期的に入れ替え、使用していない鍵は取り消してください。
• キーローテーション機能を使用して、システムを停止させることなくキーを更新できます。