ConfigCat

официальный

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

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

  • Управление флагами функций — Попросите ассистента создать, обновить или удалить флаги функций и настройки с помощью create-setting, update-setting или delete-setting.
  • Контроль значений флагов — Используйте get-setting-value или update-setting-value для чтения или изменения значений флагов функций в различных средах.
  • Обработка запросов на изменения — Создавайте, одобряйте, применяйте или комментируйте запросы на изменения с помощью таких инструментов, как create-change-request и apply-change-request.
  • Получение рекомендаций по SDK — Запросите update-sdk-documentation для примеров кода и рекомендаций по внедрению для SDK вашего проекта.
  • Управление доступом команды — Приглашайте участников, обновляйте разрешения или просматривайте список участников организации с помощью invite-member и list-organization-members.
  • Отслеживание состояния флагов — Создавайте отчеты об устаревших флагах с помощью list-staleflags или просматривайте журналы аудита через list-auditlogs.

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

ConfigCat MCP сервер

NPM License

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

Возможности

  • Инструменты:
    • Полный набор инструментов для операций с публичным management 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. Добавьте следующее определение сервера для ConfigCat MCP сервера:
{
  "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. Добавьте следующее определение сервера для ConfigCat MCP сервера:
{
  "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 - Получить журналы аудита организации

Zombie (устаревшие) флаги

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

Метаданные фича-флагов

Фича-флаги и настройки

  • 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

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

Ограничения скорости API

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

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

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

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

https://configcat.com/support

Вклад в развитие

Вклад приветствуется. Для получения дополнительной информации, пожалуйста, прочитайте Руководство по внесению вклада.

О ConfigCat