Skip to main content

Интеграция с AI-инструментами

Cursor, Claude, Codex и другие помощники могут интегрировать FlipFlag через документацию и SDK. Для этого не требуется отдельный MCP-сервер.

Skill — Markdown с инструкциями. Подключите его по правилам вашего инструмента или дайте агенту прочитать файл как руководство проекта. Публикация файла сама по себе не устанавливает расширение в IDE.

Пример задания агенту​

Интегрируй FlipFlag в существующий React-проект.
Прочитай https://docs.flipflag.ru/llms.txt и skill интеграции.
API: https://api.flipflag.ru, окружение: prod.
Ключ возьми из конфигурации приложения; не печатай его в отчёте.
Для new_checkout безопасный default — false.
Используй стабильный непрозрачный ID пользователя из текущей авторизации.
Обновляй контекст при смене аккаунта и при logout.
При недоступном API приложение должно продолжать работу.
Проверь оба значения флага, холодный запуск без API и смену пользователя.

Для on-prem замените API на origin заказчика, например https://flags.company.example. Не добавляйте /v1 к url: SDK добавляет путь.

Что проверить при приёмке​

Ключ должен соответствовать проекту, окружению и платформе. Browser/mobile ключ видим пользователям; server key хранится только на сервере. Флаги не заменяют проверку прав доступа. Передавайте минимальные атрибуты пользователя.

React useFlag().enabled описывает активность возвращённого флага; для boolean-решения проверяйте value === true. В Node/SSR контекст конкретного пользователя нельзя менять в общем singleton-клиенте для параллельных запросов.

SDK выполняет удалённое вычисление и периодическое обновление, в JavaScript по умолчанию каждые 15 секунд. Чтение работает из последнего снимка; после ошибки обновления сохраняется последний успешный результат. При холодном запуске используется default приложения. Метрики отправляются best effort и не являются надёжным бухгалтерским учётом или доказательством MAU.

Проверяйте установленную версию и доступность пакета в registry. Изменения в репозитории SDK могут появляться раньше, чем опубликованный npm-пакет.