ConfigCat
официальныйВзаимодействует с платформой флагов функций ConfigCat. Поддерживает управление флагами функций, конфигурациями, окружениями, продуктами и организациями. Помогает интегрировать SDK ConfigCat, внедрять флаги функций или удалять зомби-флаги (устаревшие).
Что можно делать с ConfigCat MCP?
- Управление флагами функций — Создавайте, просматривайте, обновляйте, заменяйте или удаляйте флаги функций и их настройки в конфигурации ConfigCat.
- Управление продуктами и окружениями — Просматривайте список, создавайте, обновляйте или удаляйте продукты, конфигурации, окружения и сегменты.
- Работа с запросами на изменение — Создавайте, просматривайте список, одобряйте, применяйте, закрывайте запросы на изменение конфигурации и окружения или комментируйте их.
- Получение документации по SDK — Получайте документацию по SDK и примеры кода для интеграции флагов функций ConfigCat в проект.
- Проверка диагностики — Просматривайте журналы аудита, получайте отчёт об устаревших флагах функций и проверяйте использование ресурсов и квоты организации.
- Управление участниками и вебхуками — Приглашайте участников, обновляйте группы разрешений, а также создавайте, обновляйте или удаляйте вебхуки.
Документация
MCP-сервер ConfigCat
Сервер 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_URL | https://api.configcat.com | Хост ConfigCat Management API. |
Ниже приведены инструкции по подключению клиента к MCP-серверу.
Cursor
- Откройте
Preferences->Cursor Settings->MCP & Integrations - Нажмите
Add Custom MCP - Добавьте следующее определение сервера для MCP-сервера ConfigCat:
{
"mcpServers": {
"ConfigCat": {
"command": "npx",
"args": ["-y", "@configcat/mcp-server"],
"env": {
"CONFIGCAT_API_USER": "YOUR_API_USER",
"CONFIGCAT_API_PASS": "YOUR_API_PASSWORD"
}
}
}
}
- Сохраните настройки.
Visual Studio Code
- Создайте файл
.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"
}
}
}
}
- Сохраните файл настроек. Теперь MCP-сервер должен быть доступен в VS Code.
Claude Desktop
- Откройте Настройки → Разработчик
- Нажмите Изменить конфигурацию
- Откройте
claude_desktop_config.json - Добавьте следующее определение сервера для MCP-сервера ConfigCat:
{
"mcpServers": {
"ConfigCat": {
"command": "npx",
"args": ["-y", "@configcat/mcp-server"],
"env": {
"CONFIGCAT_API_USER": "YOUR_API_USER",
"CONFIGCAT_API_PASS": "YOUR_API_PASSWORD"
}
}
}
}
- Сохраните изменения и перезапустите 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.
Нужна помощь?
Участие в разработке
Мы приветствуем ваш вклад. Дополнительную информацию см. в руководстве по участию в разработке.