ConfigCat

официальный

Взаимодействует с платформой флагов функций ConfigCat. Поддерживает управление флагами функций, конфигурациями, окружениями, продуктами и организациями. Помогает интегрировать SDK ConfigCat, внедрять флаги функций или удалять зомби-флаги (устаревшие).

Что можно делать с ConfigCat MCP?

  • Управление флагами функций — Создавайте, просматривайте, обновляйте, заменяйте или удаляйте флаги функций и их настройки в конфигурации ConfigCat.
  • Управление продуктами и окружениями — Просматривайте список, создавайте, обновляйте или удаляйте продукты, конфигурации, окружения и сегменты.
  • Работа с запросами на изменение — Создавайте, просматривайте список, одобряйте, применяйте, закрывайте запросы на изменение конфигурации и окружения или комментируйте их.
  • Получение документации по SDK — Получайте документацию по SDK и примеры кода для интеграции флагов функций ConfigCat в проект.
  • Проверка диагностики — Просматривайте журналы аудита, получайте отчёт об устаревших флагах функций и проверяйте использование ресурсов и квоты организации.
  • Управление участниками и вебхуками — Приглашайте участников, обновляйте группы разрешений, а также создавайте, обновляйте или удаляйте вебхуки.

Документация

MCP-сервер ConfigCat

NPM License

Сервер Model Context Protocol (MCP) от ConfigCat предоставляет доступ к общедоступному API управления ConfigCat для управления флагами функций и конфигурациями. Он также позволяет редактору кода понимать ваши флаги функций, интегрировать подходящий SDK ConfigCat в проект и даже создавать новые флаги функций непосредственно в кодовой базе.

Возможности

  • Инструменты:
    • Полный набор инструментов для работы с общедоступным API управления ConfigCat. Вы можете создавать, просматривать, обновлять и удалять любые сущности ConfigCat, например флаги функций, конфигурации, среды или продукты.
    • Получайте подробную документацию по SDK и примеры кода для простой реализации флагов функций в проекте.

Настройка

Для настройки MCP-сервера можно использовать следующие переменные среды.

Переменная средыОбязательнаяПо умолчаниюОписание
CONFIGCAT_API_USER☑Имя пользователя для базовой аутентификации в ConfigCat Management API.
CONFIGCAT_API_PASS☑Пароль для базовой аутентификации в ConfigCat Management API.
CONFIGCAT_BASE_URLhttps://api.configcat.comХост ConfigCat Management API.

Ниже приведены инструкции по подключению клиента к MCP-серверу.

Cursor

  1. Откройте Preferences -> Cursor Settings -> MCP & Integrations
  2. Нажмите Add Custom MCP
  3. Добавьте следующее определение сервера для MCP-сервера ConfigCat:
{
  "mcpServers": {
    "ConfigCat": {
      "command": "npx",
      "args": ["-y", "@configcat/mcp-server"],
      "env": {
        "CONFIGCAT_API_USER": "YOUR_API_USER",
        "CONFIGCAT_API_PASS": "YOUR_API_PASSWORD"
      }
    }
  }
}
  1. Сохраните настройки.

Visual Studio Code

  1. Создайте файл .vscode/mcp.json в корневой папке проекта со следующим содержимым:
{
  "servers": {
    "ConfigCat": {
      "command": "npx",
      "args": ["-y", "@configcat/mcp-server"],
      "env": {
        "CONFIGCAT_API_USER": "YOUR_API_USER",
        "CONFIGCAT_API_PASS": "YOUR_API_PASSWORD"
      }
    }
  }
}
  1. Сохраните файл настроек. Теперь MCP-сервер должен быть доступен в VS Code.

Claude Desktop

  1. Откройте Настройки → Разработчик
  2. Нажмите Изменить конфигурацию
  3. Откройте claude_desktop_config.json
  4. Добавьте следующее определение сервера для MCP-сервера ConfigCat:
{
  "mcpServers": {
    "ConfigCat": {
      "command": "npx",
      "args": ["-y", "@configcat/mcp-server"],
      "env": {
        "CONFIGCAT_API_USER": "YOUR_API_USER",
        "CONFIGCAT_API_PASS": "YOUR_API_PASSWORD"
      }
    }
  }
}
  1. Сохраните изменения и перезапустите Claude.

Доступные инструменты

Управление участниками

Организации

  • list-organizations — Список всех организаций

Участники

  • list-organization-members — Список участников организации
  • list-pending-invitations — Список ожидающих приглашений
  • list-pending-invitations-org — Список ожидающих приглашений в организацию
  • list-product-members — Список участников продукта
  • invite-member — Пригласить нового участника
  • update-member-permissions — Обновить разрешения участника
  • delete-organization-member — Удалить участника организации
  • delete-product-member — Удалить участника продукта
  • delete-invitation — Отменить приглашение

Группы разрешений

  • list-permission-groups — Список групп разрешений
  • create-permission-group — Создать новую группу разрешений
  • get-permission-group — Получить сведения о группе разрешений
  • update-permission-group — Обновить группу разрешений
  • delete-permission-group — Удалить группу разрешений

Общие сведения

Продукты

  • list-products — Список всех продуктов
  • get-product — Получить сведения о конкретном продукте
  • update-product — Обновить существующий продукт
  • delete-product — Удалить продукт
  • get-product-preferences — Получить настройки продукта
  • update-product-preferences — Обновить настройки продукта
  • create-product — Создать новый продукт

Конфигурации

  • list-configs — Список конфигураций продукта
  • create-config — Создать новую конфигурацию
  • get-config — Получить сведения о конкретной конфигурации
  • update-config — Обновить существующую конфигурацию
  • delete-config — Удалить конфигурацию

Среды

  • list-environments — Список сред продукта
  • create-environment — Создать новую среду
  • get-environment — Получить сведения о конкретной среде
  • update-environment — Обновить существующую среду
  • delete-environment — Удалить среду

Сегменты

  • list-segments — Список сегментов пользователей
  • create-segment — Создать новый сегмент
  • get-segment — Получить сведения о конкретном сегменте
  • update-segment — Обновить существующий сегмент
  • delete-segment — Удалить сегмент

Ключи SDK

  • get-sdk-keys — Получить ключи SDK для конфигурации/среды

Вебхуки

  • list-webhooks — Список вебхуков
  • get-webhook — Получить сведения о вебхуке
  • replace-webhook — Заменить конфигурацию вебхука
  • update-webhook — Обновить существующий вебхук
  • delete-webhook — Удалить вебхук
  • get-webhook-signing-keys — Список ключей подписи вебхуков
  • create-webhook — Создать новый вебхук

Интеграции

  • list-integrations — Список интеграций
  • create-integration — Создать новую интеграцию
  • get-integration — Получить сведения об интеграции
  • update-integration — Обновить существующую интеграцию
  • delete-integration — Удалить интеграцию

Ссылки на код

  • get-code-references — Получить ссылки на код

Диагностика

Журналы аудита

  • list-auditlogs — Получить журналы аудита продукта
  • list-organization-auditlogs — Получить журналы аудита организации

Устаревшие флаги

  • list-staleflags — Получить отчет об устаревших флагах функций

Использование и квоты

  • get-organization-usage-and-quota — Получить сведения о текущем использовании и квотах организации

Метаданные флагов функций

Флаги функций и настройки

  • list-settings — Список флагов функций для конфигурации
  • create-setting — Создать новый флаг функции
  • list-predefined-variations — Список предопределенных вариантов
  • update-predefined-variations — Обновить предопределенные варианты
  • get-setting — Получить сведения о конкретном флаге функции
  • replace-setting — Заменить конфигурацию флага функции
  • update-setting — Обновить существующий флаг функции
  • delete-setting — Удалить флаг функции

Теги

  • list-tags — Список тегов продукта
  • create-tag — Создать новый тег
  • list-settings-by-tag — Получить флаги функций по тегу
  • get-tag — Получить сведения о конкретном теге
  • update-tag — Обновить существующий тег
  • delete-tag — Удалить тег

Значения флагов функций и настроек (API v1 и v2)

  • get-setting-value — Получить значение флага функции
  • update-setting-value — Обновить значение флага функции
  • replace-setting-value — Заменить значение флага функции
  • get-setting-values — Получить значения нескольких настроек
  • post-setting-values — Обновить значения нескольких настроек
  • Варианты V2: *-v2 версии перечисленных выше инструментов для Config V2

Запросы на изменение

  • get-change-request — Возвращает сведения о конкретном запросе на изменение
  • update-change-request — Обновляет метаданные запроса на изменение, например заголовок, примечание, расписание и т. д.
  • list-change-requests — Список запросов на изменение
  • get-change-request-proposed-changes — Возвращает предлагаемые изменения настроек, включенные в запрос на изменение
  • update-change-request-proposed-change — Обновляет предлагаемые изменения настроек, включенные в запрос на изменение
  • add-change-request-comment — Добавляет новый комментарий к запросу на изменение
  • apply-change-request — Применяет запрос на изменение
  • approve-change-request — Добавляет ваше одобрение к запросу на изменение
  • claim-change-request-ownership — Назначает вас владельцем запроса на изменение
  • close-change-request — Закрывает запрос на изменение без его применения
  • create-change-request — Создает новый запрос на изменение для указанной конфигурации и среды
  • remove-change-request-approval — Удаляет ваше ранее добавленное одобрение запроса на изменение
  • resolve-change-request-setting-conflicts — Обновляет предлагаемые изменения настройки, включенной в запрос на изменение, чтобы устранить конфликты, вызванные параллельно опубликованными изменениями
  • update-change-request-comment — Обновляет существующий комментарий к запросу на изменение
  • delete-change-request-comment — Удаляет комментарий к запросу на изменение
  • delete-change-request-proposed-change — Удаляет настройку из запроса на изменение

Документация по SDK

  • get-sdk-documentation — Получить подробную документацию по SDK и примеры кода для простой реализации флагов функций в проекте.

Ограничения частоты запросов к API

Для общедоступного API ConfigCat действуют ограничения частоты запросов. Сервер соблюдает эти ограничения и возвращает соответствующие сообщения об ошибках при их превышении.

Примечание о безопасности

Этот сервер предназначен только для операций управления. Не используйте его для вычисления значений флагов функций в рабочих приложениях — вместо этого используйте SDK ConfigCat или ConfigCat Proxy.

Нужна помощь?

https://configcat.com/support

Участие в разработке

Мы приветствуем ваш вклад. Дополнительную информацию см. в руководстве по участию в разработке.

О ConfigCat