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

Сървърът Biscotti CMP MCP позволява на AI асистентите да взаимодействат с вашия акаунт в Biscotti CMP чрез програмиране. Управлявайте уебсайтове, банери, проверки за съответствие, анализи на съгласието, правни документи и много други — всичко това чрез команди на естествен език в средата ви за разработка (IDE).

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

Предпоставки

• Node.js 18 или по-нова версия
• Акаунт в 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.

Инструменти за създаване и управление на банери за съгласие.

Инструменти за сканиране на уебсайтове и проверка на съответствие.

Инструменти за достъп до статистика и анализи на съгласия.

Инструменти за управление на правни документи, като политики за поверителност, условия за ползване и страници с правна информация.

Инструменти за управление на открити услуги на трети страни и техните категории за съгласие.

Инструменти за управление на webhook интеграции за уведомления за събития в реално време.

Инструменти за управление на клиентски акаунти и операции за агенции.

Сървърът Biscotti CMP MCP предоставя следните ресурси, които AI асистентите могат да използват за контекст:

• biscotti://уебсайтове — Списък на всички уебсайтове във вашия акаунт
• biscotti://website/{id} — Подробна конфигурация на уебсайта
• biscotti://compliance/{id} — Текущ статус на съответствие за уебсайт
• biscotti://banners/{websiteId} — Всички банери за даден уебсайт

Ресурсите предоставят контекст само за четене, който помага на AI асистентите да разберат текущата ви конфигурация, преди да извършат промени.

Сървърът MCP включва вградени шаблони за подсказки за често използвани работни процеси:

Одит за съответствие

Извършете пълен одит за съответствие на уебсайта, като сканирате за бисквитки, проверите настройките за съгласие и генерирате доклад.

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