Сервер Hackle MCP

Сервер Model Context Protocol для API Hackle, предоставляющий инструменты и ресурсы для запроса данных A/B-тестирования.

Функции

Инструменты

Инструмент списка экспериментов

• Имя : experiment-list

• Описание : Извлекает постраничный список экспериментов A/B-тестирования с функцией поиска.

• Параметры :

  • pageNumber : номер страницы (по умолчанию: 1).

  • pageSize : Количество элементов на странице (по умолчанию: 100)

  • searchKeyword : Ключевое слово для поиска (необязательно)

Инструмент детализации эксперимента

• Имя : experiment-detail

• Описание : Извлекает подробную информацию для конкретного эксперимента A/B-теста.

• Параметры :

  • experimentId : Идентификатор эксперимента

Инструмент для создания списка сообщений в приложении

• Имя : in-app-message-list

• Описание : Извлекает постраничный список сообщений в приложении с функцией поиска.

• Параметры :

  • pageNumber : номер страницы (по умолчанию: 1).

  • pageSize : Количество элементов на странице (по умолчанию: 100)

  • searchKeyword : Ключевое слово для поиска (необязательно)

Инструмент для просмотра подробностей сообщений в приложении

• Имя : in-app-message-detail

• Описание : Извлекает подробную информацию о конкретном сообщении в приложении.

• Параметры :

  • inAppMessageId : идентификатор сообщения внутри приложения

Инструмент списка push-сообщений

• Имя : push-message-list

• Описание : Извлекает постраничный список push-сообщений с функцией поиска.

• Параметры :

  • pageNumber : номер страницы (по умолчанию: 1).

  • pageSize : Количество элементов на странице (по умолчанию: 100)

  • searchKeyword : Ключевое слово для поиска (необязательно)

Инструмент для детализации push-сообщений

• Имя : push-message-detail

• Описание : Извлекает подробную информацию о конкретном push-сообщении.

• Параметры :

  • pushMessageId : идентификатор push-сообщения

Инструмент серии активных пользователей

• Имя : active-user-series

• Описание : Извлекает временные ряды данных активных пользователей. Доступно в дневных, еженедельных и ежемесячных единицах.

• Параметры :

  • unit : Единица измерения времени (ДЕНЬ, НЕДЕЛЯ, МЕСЯЦ) (по умолчанию: ДЕНЬ)

  • date : Дата (необязательно)

Инструмент серии удержания

• Имя : retention-series

• Описание : Извлекает временные ряды данных об удержании пользователей. Доступно в ежедневных, еженедельных и ежемесячных единицах.

• Параметры :

  • unit : Единица измерения времени (ДЕНЬ, НЕДЕЛЯ, МЕСЯЦ) (по умолчанию: ДЕНЬ)

  • date : Дата (необязательно)

Инструмент серии Stickiness

• Имя : stickiness-series

• Описание : Извлекает временные ряды данных о прилипчивости пользователя (частота повторных посещений). Доступно в еженедельных и ежемесячных единицах.

• Параметры :

  • unit : Единица измерения времени (НЕДЕЛЯ, МЕСЯЦ) (по умолчанию: НЕДЕЛЯ)

  • date : Дата (необязательно)

Инструмент списка отчетов данных

• Имя : data-report-list

• Описание : Извлекает все метаданные отчета о данных.

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

• Имя : data-report-detail

• Описание : Извлекает детали одного отчета по данным. Он предоставит идентификатор и тип аналитической диаграммы внутри отчета по данным. Рекомендуется использовать Analytics Chart Detail Tool для получения дополнительной информации о каждой диаграмме.

• Параметры :

  • dataReportId : Идентификатор отчета по данным. Его можно найти в ответе инструмента Data Report List.

Инструмент списка аналитических диаграмм

• Имя : analytics-chart-list

• Описание : Извлекает список метаданных диаграммы анализа данных.

• Параметры :

  • pageNumber : Номер страницы (по умолчанию: 1) (необязательно)

  • pageSize : Количество элементов на странице (по умолчанию: 100) (необязательно)

  • searchKeyword : Ключевое слово для поиска (необязательно) (необязательно)

  • chartType : типы диаграмм, предоставляемые Hackle: FUNNEL, DATA_INSIGHT, RETENTION и USER_PATH. (необязательно)

Инструмент для создания подробной аналитической диаграммы

• Имя : analytics-chart-detail

• Описание : Извлекает данные аналитической диаграммы. Вы можете визуализировать диаграмму, используя результат этого инструмента.

• Параметры :

  • chartId : Идентификатор аналитической диаграммы. Его можно найти в ответе инструмента Data Report Detail Tool или инструмента Analytics Chart List Tool.

  • chartType : Тип аналитической диаграммы (FUNNEL, DATA_INSIGHT, RETENTION, USER_PATH). Его можно найти в ответе инструмента Data Report Detail Tool или инструмента Analytics Chart List Tool.

Инструмент списка удаленных конфигураций

• Имя : remote-config-list

• Описание : Извлекает список удаленных конфигураций.

• Параметры :

  • pageNumber : номер страницы (по умолчанию: 1).

  • pageSize : Количество элементов на странице (по умолчанию: 100)

  • searchKeyword : Ключевое слово для поиска (необязательно)

  • status : Статус удаленной конфигурации: АКТИВНО, АРХИВИРОВАНО (по умолчанию: «АКТИВНО»)

Инструмент для удаленной настройки детализации

• Имя : remote-config-detail

• Описание : Извлекает сведения об удаленной конфигурации.

• Параметры :

  • remoteConfigId : Идентификатор удаленной конфигурации. Эту информацию можно получить с помощью Remote Config List Tool.

Инструмент создания удаленной конфигурации

• Имя : remote-config-create

• Описание : Создает пустую удаленную конфигурацию. Рекомендуется сначала обновить существующий RC, если есть связанный RC с тем, который вы хотите создать, поскольку общее количество RC ограничено.

• Параметры :

  • body : Тело запроса.

    • key : Имя удаленной конфигурации.

    • description : Описание удаленной конфигурации.

    • dataType : Тип значения удаленной конфигурации: STRING, JSON, NUMBER, BOOLEAN.

    • userIdentifierCriteria : Критерии идентификатора пользователя для таргетинга. Вы можете использовать критерии, предоставленные Hackle($deviceId, $userId) или ваши собственные критерии, созданные на веб-сайте панели управления Hackle. (по умолчанию: '$deviceId')

Инструмент обновления содержимого удаленной конфигурации

• Имя : remote-config-update

• Описание : Обновляет содержимое удаленной конфигурации.

• Параметры :

  • remoteConfigId : идентификатор удаленной конфигурации.

  • body : Тело запроса.

    • dataType : Тип значения удаленной конфигурации: STRING, JSON, NUMBER, BOOLEAN. Запрос не будет принят, если dataType и значения удаленной конфигурации не совпадают.

    • remoteConfigDefaultValue : Значение по умолчанию удаленной конфигурации. Тип этого значения должен совпадать с полем dataType.

    • conditionalValues : Массив значений условной удаленной конфигурации с указанием группы пользователей.

      • ruleName : Имя правила условия таргетинга.

      • remoteConfigValue : Значение удаленной конфигурации. Тип этого значения должен совпадать с полем dataType.

      • target

        • conditions : Правила нацеливания. Пользователи, которые удовлетворяют всем условиям в этом массиве, увидят удаленное значение конфигурации этого правила.

          • key

            • type : Тип условия: HACKLE_PROPERTY, USER_PROPERTY, AB_TEST, FEATURE_FLAG, COHORT, SEGMENT.

            • name : Имя свойства, если тип — HACKLE_PROPERTY или USER_PROPERTY. Ключ эксперимента, если тип — AB_TEST. Ключ флага функции, если тип — FEATURE_FLAG. Вы можете поместить любую непустую строку, если тип — COHORT или SEGMENT.

          • match

            • operator : операторы, которые будут использоваться для сопоставления ключа и значений условия.

            • valueType : Тип значения условия нацеливания: NUMBER, STRING, BOOLEAN, VERSION.

            • values : значения ключа условия нацеливания. Ниже приведены некоторые особые случаи: значения будут обрабатываться как имена, если вы используете SEGMENT. Разрешены только строки 'A' и 'B', если тип AB_TEST. Принимаются только логические значения, если тип FEATURE_FLAG. Необходимо указать идентификатор когорты, если тип COHORT.

Инструмент обновления критериев идентификатора пользователя удаленной конфигурации

• Имя : remote-config-update-user-identifier-criteria

• Описание : Обновляет критерии идентификатора пользователя удаленной конфигурации. Изменение будет применено как к производственной среде, так и к среде разработки.

• Параметры :

  • remoteConfigId : идентификатор удаленной конфигурации.

  • body : Тело запроса.

    • userIdentifierCriteria : Критерии идентификатора пользователя для таргетинга. Вы можете использовать критерии, предоставленные Hackle($deviceId, $userId) или ваши собственные критерии, созданные на веб-сайте панели управления Hackle. (по умолчанию: '$deviceId')

Инструмент обновления описания удаленной конфигурации

• Имя : remote-config-update-description

• Описание : Обновляет описание удаленной конфигурации. Изменение будет применено как к производственной среде, так и к среде разработки.

• Параметры :

  • remoteConfigId : идентификатор удаленной конфигурации.

  • body : Тело запроса.

    • description : Описание удаленной конфигурации.

Related MCP server: MCP Boilerplate

Установка

Добавьте эту запись в ваш claude_desktop_config.json:

• На Mac: ~/Library/Application Support/Claude/claude_desktop_config.json

• В Windows: %APPDATA%\Claude\claude_desktop_config.json

• В Linux: ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "hackle-mcp": {
      "command": "npx",
      "args": ["-y", "@hackle-io/hackle-mcp@latest"],
      "env": {
        "API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Перезапустите Клода, если он запущен.

Получение вашего API-ключа

Для использования сервера Hackle MCP вам понадобится ключ API. Чтобы получить ключ API:

1. Свяжитесь с командой Hackle напрямую через сообщество Hackle Slack.

2. Запросите ключ API для доступа к серверу MCP

3. Команда Hackle предоставит вам уникальный ключ API.

Важно : Никогда не делитесь своим ключом API и не передавайте его в публичные репозитории. Относитесь к своему ключу API как к конфиденциальным учетным данным.

Лицензия

Массачусетский технологический институт