LaunchDarkly

Gerencie feature flags do LaunchDarkly a partir do seu agente de codificação de IA.

GitHub
27
Experimente este MCPPatrocinado

Documentação

Servidor MCP local do LaunchDarkly

O servidor local Model Context Protocol (MCP) para ambientes federais e da União Europeia (UE) do LaunchDarkly.

[!IMPORTANT] Use o servidor MCP hospedado do LaunchDarkly quando disponível

A LaunchDarkly recomenda fortemente o uso do servidor MCP hospedado quando disponível. O servidor hospedado é mais completo em recursos e recebe atualizações mais frequentes do que este servidor autogerenciado.

A LaunchDarkly fornece este servidor MCP autogerenciado para instâncias EU ou Federal do LaunchDarkly, que ainda não suportam o MCP hospedado.

Sumário

Instalação

Este servidor MCP pode ser instalado em qualquer cliente de IA que suporte o protocolo MCP. Consulte as instruções do seu cliente de IA se ele não estiver listado aqui.

Passos de instalação no Cursor

Crie um arquivo .cursor/mcp.json na raiz do seu projeto com o seguinte conteúdo:

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

Especifique sua chave de API conforme encontrada na página de Autorização do LaunchDarkly.

Passos de instalação no Claude

Adicione a seguinte definição de servidor ao seu arquivo claude_desktop_config.json:

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

Especifique sua chave de API conforme encontrada na página de Autorização do LaunchDarkly.

Passos de instalação no Qodo Gen

  1. Abra o painel de chat do Qodo Gen no VSCode ou IntelliJ.
  2. Clique em Connect more tools.
  3. Clique em + Add new MCP.
  4. Adicione a seguinte configuração:
{
  "mcpServers": {
    "LaunchDarkly": {
      "command": "npx",
      "args": [
        "-y", "--package", "@launchdarkly/mcp-server", "--", "mcp", "start",
        "--api-key", "api-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
      ]
    }
  }
}

Especifique sua chave de API conforme encontrada na página de Autorização do LaunchDarkly.

  1. Clique em Save.

Passos de instalação no GitHub Copilot CLI

Use o Copilot CLI para adicionar interativamente o servidor MCP:

/mcp add

Ou crie/edite ~/.copilot/mcp-config.json com o seguinte conteúdo:

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

Especifique sua chave de API conforme encontrada na página de Autorização do LaunchDarkly.

Para mais informações, consulte a documentação do GitHub Copilot CLI.

Passos de instalação do binário autônomo

Você também pode executar o servidor MCP como um binário autônomo sem dependências adicionais. Você deve baixar esses binários das versões disponíveis no GitHub, especificando o valor apropriado de tag:

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

Passos de instalação a partir de um clone local

Você também pode executar o servidor MCP localmente clonando este repositório. Após clonar, você precisará instalar as dependências (npm install) e compilar o servidor (npm run build).

Em seguida, configure sua definição de servidor para referenciar seu clone local. Por exemplo:

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

Passos de instalação usando variáveis de ambiente

Alguns clientes de IA permitem acessar variáveis de ambiente nas configurações do MCP. Em clientes de IA onde isso é suportado, você pode configurar seu servidor MCP para ler de uma variável de ambiente como MCP_LD_TOKEN da seguinte forma:

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

Passos de instalação para Docker

Se estiver instalando o servidor MCP do AWS Markeplace, baixe a imagem usando uma função autenticada, seguindo as instruções fornecidas na listagem do marketplace.

Para executar o contêiner:

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

Em seguida, configure sua definição de servidor para referenciar seu clone local. Por exemplo:

{
  "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"
    }
  }
}

Isso não funcionará em clientes de IA (como o Cursor) que não suportam acessar variáveis de ambiente diretamente nas configurações do MCP. Como alternativa, você pode invocar um script local a partir da sua configuração do MCP. Veja aqui um exemplo.

Requisitos

Para runtimes JavaScript suportados, consulte RUNTIMES.md.

Recursos e Operações Disponíveis

Métodos disponíveis

AiConfigs

AuditLog

CodeReferences

Environments

FeatureFlags

  • getStatus - Obter status do flag em todos os ambientes
  • list - Listar feature flags
  • create - Criar um feature flag
  • get - Obter feature flag
  • patch - Atualizar feature flag
  • delete - Excluir feature flag

Ambientes Disponíveis

A maioria das contas de clientes roda no ambiente comercial (padrão) do LaunchDarkly. Clientes em outros ambientes podem especificar o argumento --server-url para se conectar ao ambiente apropriado. Por exemplo, clientes no ambiente Federal do LaunchDarkly devem especificar o argumento --server-url https://app.launchdarkly.us ao iniciar seu servidor MCP.

AmbienteURL do servidor
Comercial (Padrão)https://app.launchdarkly.com
Federalhttps://app.launchdarkly.us
UEhttps://app.eu.launchdarkly.com

Contribuições

Embora valorizemos contribuições de código aberto para este SDK, esta biblioteca é gerada programaticamente. Quaisquer alterações manuais adicionadas aos arquivos internos serão sobrescritas na próxima geração. Esperamos receber seu feedback. Sinta-se à vontade para abrir um PR ou uma issue com uma prova de conceito e faremos o possível para incluí-la em uma versão futura.

Sobre a LaunchDarkly

  • A LaunchDarkly é uma plataforma de entrega contínua que fornece feature flags como serviço e permite que desenvolvedores iterem de forma rápida e segura. Nós permitimos que você sinalize facilmente seus recursos e os gerencie a partir do painel do LaunchDarkly. Com o LaunchDarkly, você pode:
    • Lançar um novo recurso para um subconjunto de seus usuários (como um grupo de usuários que optam por participar de um grupo de testadores beta), coletando feedback e relatórios de bugs de casos de uso reais.
    • Lançar gradualmente um recurso para uma porcentagem crescente de usuários e acompanhar o efeito que o recurso tem em métricas-chave (por exemplo, qual a probabilidade de um usuário concluir uma compra se tiver o recurso A versus o recurso B?).
    • Desativar um recurso que você percebe que está causando problemas de desempenho em produção, sem precisar reimplantar ou até mesmo reiniciar o aplicativo com um arquivo de configuração alterado.
    • Conceder acesso a determinados recursos com base em atributos do usuário, como plano de pagamento (ex: usuários no plano 'gold' têm acesso a mais recursos do que usuários no plano 'silver').
    • Desativar partes do seu aplicativo para facilitar a manutenção, sem colocar tudo offline.
  • A LaunchDarkly fornece SDKs de feature flags para uma ampla variedade de linguagens e tecnologias. Leia nossa documentação para uma lista completa.
  • Explore a LaunchDarkly