ComposioHQ/LaunchDarkly-Automation

Automação LaunchDarkly

Automatize seus workflows de feature flags do LaunchDarkly -- enumere projetos e ambientes, crie triggers de flags acionados por webhooks, gerencie o ciclo de vida dos triggers e audite referências de código em repositórios.

Documentação do toolkit: composio.dev/toolkits/launch_darkly

---

Configuração

1. Adicione o servidor MCP do Composio ao seu cliente: https://rube.app/mcp
2. Conecte sua conta LaunchDarkly quando solicitado (autenticação via chave de API)
3. Comece a usar os workflows abaixo

---

Workflows Principais

1. Listar Projetos

Use LAUNCH_DARKLY_LIST_PROJECTS para descobrir todos os projetos e suas chaves para operações subsequentes.

Ferramenta: LAUNCH_DARKLY_LIST_PROJECTS
Entradas:
  - filter: string (ex.: "query:myproject" ou "keys:proj1,proj2" ou "tags:mytag")
  - expand: string (ex.: "environments" para incluir lista de ambientes por projeto)
  - limit: integer (padrão 20)
  - offset: integer (índice inicial da paginação)
  - sort: string (ex.: "name" ou "-name" para descendente)

2. Obter Ambientes de um Projeto

Use LAUNCH_DARKLY_GET_ENVIRONMENTS para listar todos os ambientes dentro de um projeto (produção, staging, teste, etc.).

Ferramenta: LAUNCH_DARKLY_GET_ENVIRONMENTS
Entradas:
  - project_key: string (obrigatório) -- ex.: "my-project", "default"
  - filter: string (ex.: "query:production")
  - limit: integer (padrão 20)
  - offset: integer (paginação)
  - sort: string (ex.: "name" ou "-name")

3. Criar um Workflow de Trigger de Flag

Use LAUNCH_DARKLY_CREATE_TRIGGER_WORKFLOW para configurar alternâncias automáticas de flags acionadas por eventos externos (webhooks, alertas do Datadog, etc.).

Ferramenta: LAUNCH_DARKLY_CREATE_TRIGGER_WORKFLOW
Entradas:
  - project_key: string (obrigatório)
  - feature_flag_key: string (obrigatório) -- ex.: "new-feature", "enable-dark-mode"
  - environment_key: string (obrigatório) -- ex.: "production", "staging"
  - integration_key: string (padrão "generic-trigger") -- ou "datadog", "honeycomb", "dynatrace"
  - instructions: array de objetos (opcional):
      - kind: "flag_action" (fixo)
      - action: "turnFlagOn" | "turnFlagOff"
  - comment: string (opcional) -- descrição do propósito do trigger

O trigger gera uma URL de webhook única que pode ser chamada para executar a ação de flag configurada.

4. Deletar um Workflow de Trigger de Flag

Use LAUNCH_DARKLY_DELETE_TRIGGER_WORKFLOW para remover permanentemente um trigger e sua URL.

Ferramenta: LAUNCH_DARKLY_DELETE_TRIGGER_WORKFLOW
Entradas:
  - project_key: string (obrigatório)
  - feature_flag_key: string (obrigatório)
  - environment_key: string (obrigatório)
  - id: string (obrigatório) -- o ID do trigger retornado durante a criação

Aviso: A exclusão é irreversível. O trigger e sua URL não podem ser recuperados.

5. Listar Repositórios com Referências de Código

Use LAUNCH_DARKLY_LIST_CODE_REFERENCE_REPOSITORIES para rastrear onde as feature flags são usadas em seu código.

Ferramenta: LAUNCH_DARKLY_LIST_CODE_REFERENCE_REPOSITORIES
Entradas:
  - projKey: string (opcional) -- filtrar por chave do projeto
  - flagKey: string (opcional) -- filtrar por chave da feature flag
  - withBranches: string (qualquer valor para incluir dados de branch)
  - withReferencesForDefaultBranch: string (qualquer valor para incluir refs de código para o branch padrão)

Nota: Referências de código é um recurso Enterprise que requer permissões de escrita em code-reference-repository.

---

Armadilhas Conhecidas

Armadilha	Detalhe
Descoberta de chave de projeto	Sempre use LAUNCH_DARKLY_LIST_PROJECTS primeiro para encontrar chaves de projeto válidas antes de chamar outras ferramentas.
Formato da chave do ambiente	As chaves de ambiente são slugs em minúsculas (ex.: "production", "test"), não nomes de exibição.
Exclusão de trigger é permanente	Uma vez deletado via LAUNCH_DARKLY_DELETE_TRIGGER_WORKFLOW, a URL do trigger é irrecuperável.
Referências de código apenas Enterprise	LAUNCH_DARKLY_LIST_CODE_REFERENCE_REPOSITORIES requer plano Enterprise e permissões de escrita.
Formato das instruções do trigger	Cada objeto de instrução requer kind: "flag_action" (constante fixa) e action como turnFlagOn ou turnFlagOff.

---

Referência Rápida

Slug da Ferramenta	Descrição
LAUNCH_DARKLY_LIST_PROJECTS	Listar todos os projetos com filtragem e paginação
LAUNCH_DARKLY_GET_ENVIRONMENTS	Listar ambientes dentro de um projeto
LAUNCH_DARKLY_CREATE_TRIGGER_WORKFLOW	Criar um trigger de flag acionado por webhook
LAUNCH_DARKLY_DELETE_TRIGGER_WORKFLOW	Deletar permanentemente um trigger de flag
LAUNCH_DARKLY_LIST_CODE_REFERENCE_REPOSITORIES	Listar repositórios com referências de código para flags

---

Desenvolvido por Composio