ConfigCat

официальный

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

GitHub
17

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

  • Управление флагами функций — Создание, чтение, обновление или удаление флагов функций и настроек с помощью таких инструментов, как create-setting и update-setting.
  • Управление таргетингом и значениями — Получение или изменение значений флагов для каждого окружения с помощью get-setting-value, update-setting-value и массового post-setting-values.
  • Администрирование ресурсов ConfigCat — Управление продуктами, конфигурациями, окружениями и сегментами через create-product, create-config, create-environment и create-segment.
  • Управление доступом команды — Приглашение участников, обновление разрешений и управление группами разрешений с помощью invite-member и update-member-permissions.
  • Получение руководства по настройке SDK — Получение документации SDK и примеров кода для вашего проекта с использованием update-sdk-documentation.
  • Аудит и мониторинг — Просмотр журналов аудита и выявление устаревших флагов с помощью list-auditlogs и list-staleflags.

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

ConfigCat MCP-сервер

NPM License

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

Возможности

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

Настройка

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

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

Инструкции ниже показывают, как подключить клиент к 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 — Получить журналы аудита организации

Зомби-флаги (устаревшие)

  • 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

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

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

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

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

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

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

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

https://configcat.com/support

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

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

О ConfigCat