Документація до сервера MCP

Сервер Biscotti CMP MCP дозволяє штучним інтелектам взаємодіяти з вашим обліковим записом Biscotti CMP за допомогою програмного коду. Керуйте веб-сайтами, банерами, перевірками на відповідність вимогам, аналітикою щодо згоди, юридичними документами та іншим — і все це за допомогою команд природною мовою у вашому IDE.

Сервер MCP (Model Context Protocol) виступає в ролі мосту між вашим штучним інтелектом-помічником та API Biscotti CMP, надаючи набір інструментів, які можна викликати безпосередньо з вашого середовища розробки.

Необхідні умови

• Node.js 18 або пізнішої версії
• Обліковий запис Biscotti CMP за тарифним планом «Агентство» або «Агентство LTD»
• Ключ API зі сторінки «Налаштування розробника»

Швидкий старт

Найшвидший спосіб розпочати роботу — це скористатися npx — інсталяція не потрібна:

npx @biscotti-cmp/mcp-server

Запустіть сервер MCP безпосередньо, не встановлюючи його в системному каталозі. Це рекомендований підхід для більшості користувачів:

npx @biscotti-cmp/mcp-server

Якщо ви бажаєте встановити MCP Server глобально на своїй системі:

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

Після встановлення ви можете запустити сервер безпосередньо:

biscotti-mcp

Щоб використовувати сервер Biscotti CMP MCP із 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 разом із 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 із 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} — Усі банери для веб-сайту

Ресурси надають контекст, доступний лише для читання, який допомагає штучному інтелекту зрозуміти ваші поточні налаштування перед внесенням змін.

Сервер MCP містить вбудовані шаблони командних рядків для типових робочих процесів:

Аудит відповідності

Провести повний аудит відповідності веб-сайту: перевірити наявність файлів cookie, налаштування щодо згоди та сформувати звіт.

Запустіть аудит відповідності на моєму веб-сайті example.com і запропонуйте покращення.

Налаштування банера

Створіть та налаштуйте банер згоди, вибравши бажаний дизайн та параметри поведінки.

Створіть GDPR-сумісний банер згоди для мого веб-сайту з темною темою та розташуванням внизу ліворуч.

Створення юридичних документів

Створюйте юридичні документи на основі налаштувань вашого веб-сайту та юрисдикції, на яку він орієнтований.

Згенеруйте політику конфіденційності для мого німецького веб-сайту, яка охоплює Google Analytics та Facebook Pixel.

Сервер Biscotti CMP MCP потребує ключа API для автентифікації в API Biscotti CMP. Усі запити, що надсилаються сервером MCP, автентифікуються за допомогою вашого ключа API.

Як працює аутентифікація

1. Ви створюєте ключ API на сторінці «Налаштування для розробників» у вашій панелі управління Biscotti CMP.
2. Ключ API задається як BISCOTTI_API_KEY змінної середовища у вашій конфігурації клієнта MCP.
3. Сервер MCP додає цей ключ у вигляді токена Bearer до всіх запитів API.
4. API Biscotti CMP перевіряє ключ і повертає дані, що стосуються саме вашого облікового запису.

Щоб отримати ключ API для сервера MCP:

1. Увійдіть у свою панель управління Biscotti CMP за адресою app.biscotti-cmp.com.
2. Перейдіть до розділу «Налаштування розробника» на бічній панелі.
3. Натисніть «Створити новий ключ» на вкладці «Ключі API».
4. Дайте своєму ключу описову назву (наприклад, «Сервер MCP — Розробка»).
5. За бажанням можна встановити термін дії ключа.
6. Негайно скопіюйте згенерований ключ — він відобразиться лише один раз.

Кращі практики управління ключами

• Використовуйте окремі ключі API для середовищ розробки та виробничих середовищ.
• Встановіть терміни дії для ключів, які використовуються тимчасово.
• Регулярно змінюйте ключі та анулюйте ті, що не використовуються.
• Скористайтеся функцією ротації ключів, щоб замінити ключі без простою.