unleash-mcp — MCP-сервер для Claude Code: флаги Unleash из чата
MCP-сервер, через который ИИ-ассистент создаёт и настраивает фича-флаги в Unleash. Пригодится, когда фичу нужно спрятать за флагом прямо во время работы над кодом.
claude mcp add --env UNLEASH_BASE_URL=<UNLEASH_BASE_URL> --env UNLEASH_PAT=<UNLEASH_PAT> --env UNLEASH_DEFAULT_PROJECT=<UNLEASH_DEFAULT_PROJECT> --env UNLEASH_MCP_SEND_FEEDBACK=<UNLEASH_MCP_SEND_FEEDBACK> --env UNLEASH_FEEDBACK_URL=<UNLEASH_FEEDBACK_URL> --transport stdio unleash-mcp -- npx -y @unleash/mcpЧто делает unleash-mcp
Сервер даёт ассистенту набор инструментов к Admin API Unleash. Он умеет создавать флаги, искать уже существующие, чтобы не плодить дубли, оценивать риск изменения и подсказывать, как обернуть его во флаг. Отдельные инструменты показывают состояние флага, его историю из журнала событий и объясняют, какие стратегии сработали при проверке по контексту.
Основной сценарий такой: сначала ассистент оценивает изменение и решает, нужен ли флаг, потом проверяет, нет ли уже похожего, создаёт новый и выдаёт код для его использования. Есть инструменты для раскатки на среду — процент, сегменты, ограничения, — а также для жизненного цикла: завершить, архивировать, пометить устаревшим.
Перед запуском понадобятся Node.js 22 или выше, pnpm либо npm, доступ к инстансу Unleash и personal access token с правом создавать флаги. Без токена сервер работать не будет. Есть экспериментальный режим подключения по HTTP к встроенному remote MCP самого Unleash — его нужно включить на инстансе. Инструмент send_feedback отправляет отчёт об ошибке в Unleash только с согласия пользователя; при UNLEASH_MCP_SEND_FEEDBACK=false он в списке не появляется.
Какие задачи решает
- создать фича-флаг в Unleash, не открывая веб-интерфейс
- проверить, не заведён ли уже такой флаг, и переиспользовать его
- решить, стоит ли вообще прятать изменение за флагом
- посмотреть, кто и когда менял флаг в каждой среде
- снять флаг со среды или удалить его стратегию
Примеры запросов агенту
- Оцени это изменение и скажи, нужен ли для него фича-флаг
- Создай флаг
new-checkoutв проектеwebи покажи, как обернуть в него код - Включи флаг
new-checkoutв staging на 10 процентов пользователей
Как установить unleash-mcp
Командой платформы
claude mcp add --env UNLEASH_BASE_URL=<UNLEASH_BASE_URL> --env UNLEASH_PAT=<UNLEASH_PAT> --env UNLEASH_DEFAULT_PROJECT=<UNLEASH_DEFAULT_PROJECT> --env UNLEASH_MCP_SEND_FEEDBACK=<UNLEASH_MCP_SEND_FEEDBACK> --env UNLEASH_FEEDBACK_URL=<UNLEASH_FEEDBACK_URL> --transport stdio unleash-mcp -- npx -y @unleash/mcpВместо <…> подставьте свои значения. Ещё 1 переменная окружения — в README сервера
Командой платформы
codex mcp add unleash-mcp --env UNLEASH_BASE_URL=<UNLEASH_BASE_URL> --env UNLEASH_PAT=<UNLEASH_PAT> --env UNLEASH_DEFAULT_PROJECT=<UNLEASH_DEFAULT_PROJECT> --env UNLEASH_MCP_SEND_FEEDBACK=<UNLEASH_MCP_SEND_FEEDBACK> --env UNLEASH_FEEDBACK_URL=<UNLEASH_FEEDBACK_URL> -- npx -y @unleash/mcpВместо <…> подставьте свои значения. Ещё 1 переменная окружения — в README сервера
Файл настроек
{
"mcpServers": {
"unleash-mcp": {
"command": "npx",
"args": [
"-y",
"@unleash/mcp"
],
"env": {
"UNLEASH_BASE_URL": "<UNLEASH_BASE_URL>",
"UNLEASH_PAT": "<UNLEASH_PAT>",
"UNLEASH_DEFAULT_PROJECT": "<UNLEASH_DEFAULT_PROJECT>",
"UNLEASH_MCP_SEND_FEEDBACK": "<UNLEASH_MCP_SEND_FEEDBACK>",
"UNLEASH_FEEDBACK_URL": "<UNLEASH_FEEDBACK_URL>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 1 переменная окружения — в README сервера
Файл настроек
{
"servers": {
"unleash-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@unleash/mcp"
],
"env": {
"UNLEASH_BASE_URL": "<UNLEASH_BASE_URL>",
"UNLEASH_PAT": "<UNLEASH_PAT>",
"UNLEASH_DEFAULT_PROJECT": "<UNLEASH_DEFAULT_PROJECT>",
"UNLEASH_MCP_SEND_FEEDBACK": "<UNLEASH_MCP_SEND_FEEDBACK>",
"UNLEASH_FEEDBACK_URL": "<UNLEASH_FEEDBACK_URL>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 1 переменная окружения — в README сервера
Командой платформы
gemini mcp add -e UNLEASH_BASE_URL=<UNLEASH_BASE_URL> -e UNLEASH_PAT=<UNLEASH_PAT> -e UNLEASH_DEFAULT_PROJECT=<UNLEASH_DEFAULT_PROJECT> -e UNLEASH_MCP_SEND_FEEDBACK=<UNLEASH_MCP_SEND_FEEDBACK> -e UNLEASH_FEEDBACK_URL=<UNLEASH_FEEDBACK_URL> unleash-mcp npx -y @unleash/mcpВместо <…> подставьте свои значения. Ещё 1 переменная окружения — в README сервера
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о unleash-mcp
Как установить unleash-mcp в Claude Code?
Выполните claude mcp add unleash-mcp -e UNLEASH_BASE_URL=<UNLEASH_BASE_URL> -e UNLEASH_PAT=<UNLEASH_PAT> -- npx -y @unleash/mcp. Команду запускайте из корня проекта, где нужен сервер.
Что делает unleash-mcp?
Даёт ассистенту инструменты к Admin API Unleash: создание и поиск флагов, оценка изменения, настройка раскатки и таргетинга, история и состояние флага, управление жизненным циклом.
Что нужно для работы unleash-mcp?
Node.js 22 или выше, pnpm либо npm, инстанс Unleash и personal access token с правом создавать флаги. Токен передаётся в переменной UNLEASH_PAT.
