Локальный MCP-сервер LaunchDarkly

Локальный сервер Model Context Protocol (MCP) для окружений LaunchDarkly во Федеральном секторе и в Европейском Союзе (EU).

Important

Используйте размещённый MCP-сервер LaunchDarkly там, где он доступен

LaunchDarkly настоятельно рекомендует использовать размещённый MCP-сервер там, где он доступен. Размещённый сервер обладает более широким набором функций и получает обновления чаще, чем этот самоуправляемый сервер.

LaunchDarkly предоставляет этот самоуправляемый MCP-сервер для окружений LaunchDarkly в EU или Federal, которые пока не поддерживают размещённый MCP.

Содержание

• Локальный MCP-сервер LaunchDarkly

• Установка

• Требования

• Доступные ресурсы и операции

• Доступные окружения

• Участие сообщества

• О LaunchDarkly

Установка

Этот MCP-сервер можно установить в любом AI-клиенте, который поддерживает протокол MCP. Обращайтесь к инструкциям вашего AI-клиента, если он здесь не указан.

Шаги установки Cursor

Создайте файл .cursor/mcp.json в корне проекта со следующим содержимым:

{
  "mcpServers": {
    "LaunchDarkly": {
      "command": "npx",
      "args": [
        "-y", "--package", "@launchdarkly/mcp-server", "--", "mcp", "start",
        "--api-key", "api-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
      ]
    }
  }
}

Укажите ваш API-ключ на странице авторизации LaunchDarkly.

Шаги установки Claude

Добавьте следующее определение сервера в файл claude_desktop_config.json:

{
  "mcpServers": {
    "LaunchDarkly": {
      "command": "npx",
      "args": [
        "-y", "--package", "@launchdarkly/mcp-server", "--", "mcp", "start",
        "--api-key", "api-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
      ]
    }
  }
}

Укажите ваш API-ключ на странице авторизации LaunchDarkly.

Шаги установки Qodo Gen

• Откройте панель чатов Qodo Gen в VSCode или IntelliJ.

• Нажмите Connect more tools.

• Нажмите + Add new MCP.

• Добавьте следующую конфигурацию:

{
  "mcpServers": {
    "LaunchDarkly": {
      "command": "npx",
      "args": [
        "-y", "--package", "@launchdarkly/mcp-server", "--", "mcp", "start",
        "--api-key", "api-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
      ]
    }
  }
}

Укажите ваш API-ключ на странице авторизации LaunchDarkly.

• Нажмите Save.

Установка GitHub Copilot CLI

Используйте Copilot CLI для интерактивного добавления MCP-сервера:

/mcp add

Или создайте/отредактируйте ~/.copilot/mcp-config.json со следующим содержимым:

{
  "mcpServers": {
    "LaunchDarkly": {
      "command": "npx",
      "args": [
        "-y", "--package", "@launchdarkly/mcp-server", "--", "mcp", "start",
        "--api-key", "api-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
      ]
    }
  }
}

Укажите ваш API-ключ на странице авторизации LaunchDarkly.

Для дополнительной информации смотрите GitHub Copilot CLI documentation.

Шаги установки автономного бинарника

Вы также можете запустить MCP-сервер как автономный бинарник без дополнительных зависимостей. Бинарники нужно скачивать из доступных выпусков GitHub, указывая соответствующее значение tag:

curl -L -o mcp-server https://github.com/launchdarkly/mcp-server/releases/download/{tag}/mcp-server-bun-darwin-arm64 && \
chmod +x mcp-server

Установка из локального клона

Вы также можете запустить MCP-сервер локально, склонировав этот репозиторий. После клонирования нужно установить зависимости (npm install) и собрать сервер (npm run build).

Затем настройте определение вашего сервера так, чтобы он ссылался на ваш локальный клон. Например:

{
  "mcpServers": {
    "launchdarkly": {
      "command": "node",
      "args": [
        "/path/to/mcp-server/bin/mcp-server.js", "start",
        "--api-key", "api-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
      ]
    }
  }
}

Установка с использованием переменных окружения

Некоторые AI-клиенты поддерживают доступ к переменным окружения в конфигурациях MCP. В таких клиентах можно настроить MCP-сервер так, чтобы он считывал переменную окружения, например MCP_LD_TOKEN, следующим образом:

{
  "mcpServers": {
    "launchdarkly": {
      "command": "npx",
      "args": [
        "-y", "--package", "@launchdarkly/mcp-server", "--", "mcp", "start",
        "--api-key", "$LD_ACCESS_TOKEN"
      ],
      "env": {
        "LD_ACCESS_TOKEN": "MCP_LD_TOKEN"
      }
    }
  }
}

Установка через Docker

Если установка MCP-сервера через AWS Marketplace, вытяните образ с помощью аутентифицированной роли, используя инструкции в карточке продукта marketplace.

Чтобы запустить контейнер:

docker run --rm -p 8080:8080 709825985650.dkr.ecr.us-east-1.amazonaws.com/launchdarkly/mcp --api-key api-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

Затем настройте определение вашего сервера, чтобы он ссылался на локальный клон. Например:

{
  "mcpServers": {
    "launchdarkly": {
      "command": "npx",
      "args": [
        "-y", "--package", "@launchdarkly/mcp-server", "--", "mcp", "start",
        "--api-key", "$LD_ACCESS_TOKEN"
      ],
      "env": {
        "LD_ACCESS_TOKEN": "MCP_LD_TOKEN"
      }
      "url": "http://localhost:8080/sse"
    }
  }
}

Это не будет работать в AI-клиентах (таких как Cursor), которые не поддерживают доступ к переменным окружения напрямую внутри MCP-конфигураций. В качестве обходного решения можно вызвать локальный скрипт из вашей MCP-конфигурации. См. пример здесь: https://github.com/launchdarkly/mcp-server/issues/26#issuecomment-3064419507.

Требования

Для поддерживаемых сред выполнения JavaScript смотрите RUNTIMES.md.

Доступные ресурсы и операции

Доступные методы

AiConfigs

• [getTargeting] - Показать таргетинг AI Config

• [updateTargeting] - Обновить таргетинг AI Config

• [list] - Список AI Config'ов

• [create] - Создать новый AI Config

• [delete] - Удалить AI Config

• [get] - Получить AI Config

• [update] - Обновить AI Config

• [createVariation] - Создать вариацию AI Config

• [deleteVariation] - Удалить вариацию AI Config

• [getVariation] - Получить вариацию AI Config

• [updateVariation] - Обновить вариацию AI Config

AuditLog

• [listEntries] - Список записей журнала аудита

CodeReferences

• [listRepositories] - Список репозиториев

Environments

• [listByProject] - Список окружений

FeatureFlags

• [getStatus] - Получить статус флага во всех окружениях

• [list] - Список флагов функций

• [create] - Создать флаг функции

• [get] - Получить флаг функции

• [patch] - Обновить флаг функции

• [delete] - Удалить флаг функции

Доступные окружения

Большинство учетных записей клиентов работают в коммерческом окружении (окружение по умолчанию). Клиенты на других окружениях могут указать аргумент --server-url, чтобы подключиться к нужному окружению. Например, клиенты на федеральном окружении LaunchDarkly должны указать аргумент --server-url https://app.launchdarkly.us при запуске MCP-сервера.

Окружение	URL сервера
Коммерческое (По умолчанию)	https://app.launchdarkly.com
Federal	https://app.launchdarkly.us
EU	https://app.eu.launchdarkly.com

Участие сообщества

Хотя мы ценим вклад сообщества в этот SDK, эта библиотека генерируется программно. Любые ручные изменения в внутренних файлах будут перезаписаны при следующем обновлении.

Мы ждём ваших отзывов. Не стесняйтесь открыть PR или issue с концептом, и мы постараемся включить его в будущий релиз.

О LaunchDarkly

• LaunchDarkly — платформа для непрерывной доставки, которая предоставляет фич-флаги как услугу и позволяет разработчикам быстро и безопасно итеративно развивать продукты. Мы предлагаем легко пометить ваши функции и управлять ими через дашборд LaunchDarkly. С LaunchDarkly вы можете:

• Развернуть новую функцию для подмножества ваших пользователей (например, группы пользователей, согласившиеся стать бета-тестерами), собирая отзывы и отчёты об ошибках из реального использования.

• Постепенно разворачивать функцию на возрастающую долю пользователей и отслеживать влияние функции на ключевые метрики (например, насколько вероятно, что пользователь совершит покупку, если у него есть функция A по сравнению с функцией B?).

• Отключать функцию, которая вызывает проблемы с производительностью в продакшене, без повторного развёртывания или перезапуска приложения с изменённой конфигурацией.

• Предоставлять доступ к определённым функциям на основе атрибутов пользователей, например плана оплаты (например, пользователи на плане «gold» получают доступ к большему числу функций, чем пользователи на плане «silver»).

• Отключать части вашего приложения для облегчения обслуживания, не снимая всё с эксплуатации.

• LaunchDarkly предоставляет SDKs флагов функций для широкого спектра языков и технологий. Ознакомьтесь с нашей документацией для полного списка.

• Изучайте LaunchDarkly

• Sign up for a free LaunchDarkly account

• launchdarkly.com для получения дополнительной информации

• launchdarkly.com/docs для нашей документации и руководств по SDK

• launchdarkly.com/docs/api для нашей API документации

• blog.launchdarkly.com для последних обновлений продукта