Интеграция Model Context Protocol (MCP)

Model Context Protocol (MCP) — это открытый протокол, представленный компанией Anthropic, позволяющий языковым моделям (LLM), средам разработки с ИИ (таким как Cursor, Windsurf) и автономным агентам безопасно взаимодействовать с внешними инструментами, базами данных и сервисами.

HashEntry предоставляет официальные Streamable-HTTP MCP-серверы, позволяющие разработчикам и специалистам по защите данных автоматизировать сканирование cookie-файлов, настраивать баннеры согласия, формировать юридические политики и запрашивать аналитику согласий GDPR/KVKK на естественном языке.

Архитектура и Уровни Доступа

HashEntry предоставляет три выделенных сервера MCP с учетом различных политик безопасности:

Эндпоинт	Уровень доступа	Аутентификация	Возможности
`https://system.hashentry.com/mcp/public`	Публичный (Public)	Не требуется (Анонимно)	Экспресс-аудит сайтов, глобальный справочник cookie, просмотр тарифов и базы знаний.
`https://system.hashentry.com/mcp/tenant`	Клиентский (Tenant)	Bearer-токен (`he_mcp_...`)	Управление сайтами, запуск аудитов cookie, настройка внешнего вида баннера, создание и публикация правовых документов, статистика согласий.
`https://system.hashentry.com/mcp/reseller`	Партнерский (Reseller)	Bearer-токен (`he_mcp_...`)	Управление портфелем клиентов агентства, учет комиссионных выплат, баланс и тикеты поддержки.

Аутентификация и Создание Токенов MCP

Для доступа к серверам Tenant и Reseller каждый запрос должен сопровождаться персональным токеном (he_mcp_...).

Создание токена через Панель Управления HashEntry

Войдите в Личный Кабинет HashEntry.
Перейдите в раздел Настройки → Токены AI и MCP.
Нажмите Создать новый токен MCP, укажите понятное имя и срок действия.
Скопируйте сформированный ключ he_mcp_... и сохраните его в надежном месте.

Настройка ИИ-Клиентов

1. Настройка Cursor IDE

Создайте или обновите файл .cursor/mcp.json в корневой папке вашего проекта:

{
  "mcpServers": {
    "hashentry-public": {
      "url": "https://system.hashentry.com/mcp/public"
    },
    "hashentry-tenant": {
      "url": "https://system.hashentry.com/mcp/tenant",
      "headers": {
        "Authorization": "Bearer he_mcp_ВАШ_ТОКЕН_ЗДЕСЬ"
      }
    }
  }
}

2. Настройка Claude Desktop

Откройте файл конфигурации claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Добавьте конфигурацию сервера:

{
  "mcpServers": {
    "hashentry": {
      "url": "https://system.hashentry.com/mcp/tenant",
      "headers": {
        "Authorization": "Bearer he_mcp_ВАШ_ТОКЕН_ЗДЕСЬ"
      }
    }
  }
}

Доступные Инструменты MCP (Tools)

1. Публичные Инструменты (`/mcp/public`)

Доступны без регистрации:

start_cmp_scan: Запуск комплексного аудита cookie и конфиденциальности для любого URL.
get_cmp_scan_status: Проверка статуса выполнения текущего сканирования.
get_cmp_scan_report: Получение детального отчета с классификацией cookie и оценкой соответствия.
search_cookie_definitions: Поиск в глобальной базе HashEntry по имени cookie, провайдеру и сроку жизни.
get_pricing_plans: Просмотр действующих тарифных планов и лимитов.
search_knowledge_base: Поиск по официальной документации и юридическим справочникам.

2. Инструменты Клиента (`/mcp/tenant`)

Требуют действительный токен клиента:

list_sites: Список всех сайтов, подключенных к вашему аккаунту.
get_site: Получение настроек, ключей API и параметров конкретного сайта.
create_site: Регистрация нового веб-сайта в системе.
trigger_site_cookie_scan: Инициализация сканирования cookie для зарегистрированного сайта.
list_site_cookies: Список обнаруженных файлов cookie с распределением по категориям.
get_banner_config: Получение параметров темы, текста и юридических режимов баннера.
update_banner_config: Обновление дизайна и поведения баннера согласия.
list_documents: Список юридических документов (Политика Cookie, Уведомление о конфиденциальности).
get_document: Загрузка полного текста политики в формате markdown или HTML.
save_document_draft: Сохранение текста или правок, сгенерированных ИИ, в виде черновика.
publish_document: Публикация согласованного правового документа с присвоением версии.
get_consent_stats: Метрики принятия, отклонения и распределения категорий согласий.
list_tickets и create_ticket: Просмотр обращений и отправка новых тикетов в службу поддержки.
get_quota_usage: Просмотр использованных квот (сканирования, сайты, API-запросы).

3. Инструменты Партнера (`/mcp/reseller`)

Требуют авторизации реселлера:

get_reseller_dashboard: Сводные показатели по клиентам агентства, баланс комиссионных и выплаты.
list_reseller_tenants: Список всех клиентских организаций вашего агентства.
create_reseller_tenant: Создание новой клиентской организации.
list_commissions: Подробная история начислений партнерских вознаграждений.
list_reseller_tickets и create_reseller_ticket: Приоритетная поддержка для партнеров.