Документация по серверу MCP

Сервер Biscotti CMP MCP позволяет AI-помощникам программно взаимодействовать с вашей учетной записью 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 предоставляет следующие ресурсы, которые ИИ-помощники могут использовать для понимания контекста:

• 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 для среды разработки и производственной среды.
• Установите сроки действия для ключей, которые используются временно.
• Регулярно меняйте ключи и аннулируйте неиспользуемые ключи.
• Используйте функцию ротации ключей для замены ключей без простоев.