ConfigCat

oficial

interage com a plataforma de feature flags ConfigCat. Suporta o gerenciamento de feature flags, configurações, ambientes, produtos e organizações. Ajuda a integrar o SDK do ConfigCat, implementar feature flags ou remover flags zumbis (obsoletas).

O que você pode fazer com ConfigCat MCP?

  • Gerenciar sinalizadores de recursos — Criar, ler, atualizar, substituir ou excluir sinalizadores de recursos e suas configurações em uma configuração do ConfigCat.
  • Gerenciar produtos e ambientes — Listar, criar, atualizar ou excluir produtos, configurações, ambientes e segmentos.
  • Lidar com solicitações de alteração — Criar, listar, aprovar, aplicar, fechar ou comentar solicitações de alteração para uma configuração e um ambiente.
  • Obter documentação do SDK — Recuperar a documentação do SDK e exemplos de código para integrar os sinalizadores de recursos do ConfigCat a um projeto.
  • Revisar diagnósticos — Listar logs de auditoria, obter o relatório de sinalizadores de recursos obsoletos e verificar o uso e a cota da organização.
  • Gerenciar membros e webhooks — Convidar membros, atualizar grupos de permissões e criar, atualizar ou excluir webhooks.

Documentação

Servidor MCP do ConfigCat

NPM License

O servidor Model Context Protocol (MCP) do ConfigCat fornece acesso à API pública de gerenciamento do ConfigCat para o gerenciamento de feature flags e configurações. Ele também permite que seu editor de código entenda suas feature flags, integre o SDK apropriado do ConfigCat ao seu projeto ou até mesmo crie novas feature flags diretamente na sua base de código.

Recursos

  • Ferramentas:
    • Conjunto completo de ferramentas para operações da API pública de gerenciamento do ConfigCat. Você pode criar, ler, atualizar e excluir entidades como feature flags, configurações, ambientes ou produtos no ConfigCat.
    • Obtenha documentação abrangente dos SDKs e exemplos de código para implementar feature flags no seu projeto com facilidade.

Configuração

Você pode usar as seguintes variáveis de ambiente para configurar o servidor MCP.

Variável de ambienteObrigatóriaPadrãoDescrição
CONFIGCAT_API_USER☑Nome de usuário da autenticação básica da API de gerenciamento do ConfigCat.
CONFIGCAT_API_PASS☑Senha da autenticação básica da API de gerenciamento do ConfigCat.
CONFIGCAT_BASE_URLhttps://api.configcat.comHost da API de gerenciamento do ConfigCat.

As instruções abaixo mostram como conectar um cliente ao servidor MCP.

Cursor

  1. Abra Preferences -> Cursor Settings -> MCP & Integrations
  2. Clique em Add Custom MCP
  3. Adicione a seguinte definição de servidor para o servidor MCP do ConfigCat:
{
  "mcpServers": {
    "ConfigCat": {
      "command": "npx",
      "args": ["-y", "@configcat/mcp-server"],
      "env": {
        "CONFIGCAT_API_USER": "YOUR_API_USER",
        "CONFIGCAT_API_PASS": "YOUR_API_PASSWORD"
      }
    }
  }
}
  1. Salve as configurações.

Visual Studio Code

  1. Crie um arquivo .vscode/mcp.json na raiz do seu projeto com o seguinte conteúdo:
{
  "servers": {
    "ConfigCat": {
      "command": "npx",
      "args": ["-y", "@configcat/mcp-server"],
      "env": {
        "CONFIGCAT_API_USER": "YOUR_API_USER",
        "CONFIGCAT_API_PASS": "YOUR_API_PASSWORD"
      }
    }
  }
}
  1. Salve o arquivo de configurações. O servidor MCP deverá estar disponível no VS Code.

Claude Desktop

  1. Abra Configurações → Desenvolvedor
  2. Clique em Editar configuração
  3. Abra claude_desktop_config.json
  4. Adicione a seguinte definição de servidor para o servidor MCP do ConfigCat:
{
  "mcpServers": {
    "ConfigCat": {
      "command": "npx",
      "args": ["-y", "@configcat/mcp-server"],
      "env": {
        "CONFIGCAT_API_USER": "YOUR_API_USER",
        "CONFIGCAT_API_PASS": "YOUR_API_PASSWORD"
      }
    }
  }
}
  1. Salve e reinicie o Claude.

Ferramentas disponíveis

Gerenciamento de associação

Organizações

  • list-organizations - Listar todas as organizações

Membros

  • list-organization-members - Listar membros da organização
  • list-pending-invitations - Listar convites pendentes
  • list-pending-invitations-org - Listar convites pendentes da organização
  • list-product-members - Listar membros do produto
  • invite-member - Convidar um novo membro
  • update-member-permissions - Atualizar as permissões de um membro
  • delete-organization-member - Remover membro da organização
  • delete-product-member - Remover membro do produto
  • delete-invitation - Cancelar convite

Grupos de permissões

  • list-permission-groups - Listar grupos de permissões
  • create-permission-group - Criar um novo grupo de permissões
  • get-permission-group - Obter detalhes do grupo de permissões
  • update-permission-group - Atualizar grupo de permissões
  • delete-permission-group - Excluir grupo de permissões

Geral

Produtos

  • list-products - Listar todos os produtos
  • get-product - Obter detalhes de um produto específico
  • update-product - Atualizar produto existente
  • delete-product - Excluir um produto
  • get-product-preferences - Obter preferências do produto
  • update-product-preferences - Atualizar preferências do produto
  • create-product - Criar um novo produto

Configurações

  • list-configs - Listar configurações de um produto
  • create-config - Criar uma nova configuração
  • get-config - Obter detalhes de uma configuração específica
  • update-config - Atualizar configuração existente
  • delete-config - Excluir uma configuração

Ambientes

  • list-environments - Listar ambientes de um produto
  • create-environment - Criar um novo ambiente
  • get-environment - Obter detalhes de um ambiente específico
  • update-environment - Atualizar ambiente existente
  • delete-environment - Excluir um ambiente

Segmentos

  • list-segments - Listar segmentos de usuários
  • create-segment - Criar um novo segmento
  • get-segment - Obter detalhes de um segmento específico
  • update-segment - Atualizar segmento existente
  • delete-segment - Excluir um segmento

Chaves de SDK

  • get-sdk-keys - Obter chaves de SDK para configuração/ambiente

Webhooks

  • list-webhooks - Listar webhooks
  • get-webhook - Obter detalhes do webhook
  • replace-webhook - Substituir configuração do webhook
  • update-webhook - Atualizar webhook existente
  • delete-webhook - Excluir um webhook
  • get-webhook-signing-keys - Listar chaves de assinatura de webhook
  • create-webhook - Criar um novo webhook

Integrações

  • list-integrations - Listar integrações
  • create-integration - Criar uma nova integração
  • get-integration - Obter detalhes da integração
  • update-integration - Atualizar integração existente
  • delete-integration - Excluir uma integração

Referências de código

  • get-code-references - Obter referências de código

Diagnóstico

Registros de auditoria

  • list-auditlogs - Obter registros de auditoria do produto
  • list-organization-auditlogs - Obter registros de auditoria da organização

Flags zumbis (obsoletas)

  • list-staleflags - Obter relatório de feature flags obsoletas

Uso e cota

  • get-organization-usage-and-quota - Obter informações atuais de uso e cota de uma organização

Metadados de feature flags

Feature flags e configurações

  • list-settings - Listar feature flags de uma configuração
  • create-setting - Criar uma nova feature flag
  • list-predefined-variations - Listar variações predefinidas
  • update-predefined-variations - Atualizar variações predefinidas
  • get-setting - Obter detalhes de uma feature flag específica
  • replace-setting - Substituir configuração da feature flag
  • update-setting - Atualizar feature flag existente
  • delete-setting - Excluir uma feature flag

Tags

  • list-tags - Listar tags de um produto
  • create-tag - Criar uma nova tag
  • list-settings-by-tag - Obter feature flags por tag
  • get-tag - Obter detalhes de uma tag específica
  • update-tag - Atualizar tag existente
  • delete-tag - Excluir uma tag

Valores de feature flags e configurações (APIs v1 e v2)

  • get-setting-value - Obter valor da feature flag
  • update-setting-value - Atualizar valor da feature flag
  • replace-setting-value - Substituir valor da feature flag
  • get-setting-values - Obter vários valores de configuração
  • post-setting-values - Atualizar vários valores de configuração
  • Variantes V2: *-v2 versões das ferramentas acima para Config V2

Solicitações de alteração

  • get-change-request - Retorna os detalhes de uma Solicitação de alteração específica
  • update-change-request - Atualiza os metadados de uma Solicitação de alteração, como título, observação, agendamento etc.
  • list-change-requests - Lista Solicitações de alteração
  • get-change-request-proposed-changes - Retorna as alterações propostas nas Configurações incluídas em uma Solicitação de alteração
  • update-change-request-proposed-change - Atualiza as alterações propostas nas Configurações incluídas em uma Solicitação de alteração
  • add-change-request-comment - Adiciona um novo comentário à Solicitação de alteração
  • apply-change-request - Aplica a Solicitação de alteração
  • approve-change-request - Adiciona sua aprovação à Solicitação de alteração
  • claim-change-request-ownership - Assume a propriedade da Solicitação de alteração
  • close-change-request - Fecha a Solicitação de alteração sem aplicá-la
  • create-change-request - Cria uma nova Solicitação de alteração para a Configuração e o Ambiente especificados
  • remove-change-request-approval - Remove sua aprovação existente da Solicitação de alteração
  • resolve-change-request-setting-conflicts - Atualiza as alterações propostas em uma Configuração incluída na Solicitação de alteração para resolver conflitos causados por alterações publicadas simultaneamente
  • update-change-request-comment - Atualiza um comentário existente da Solicitação de alteração
  • delete-change-request-comment - Exclui um comentário da Solicitação de alteração
  • delete-change-request-proposed-change - Remove uma configuração de uma Solicitação de alteração

Documentação dos SDKs

  • get-sdk-documentation - Obtenha documentação abrangente dos SDKs e exemplos de código para implementar feature flags no seu projeto com facilidade.

Limites de taxa da API

A API pública do ConfigCat tem limites de taxa. O servidor respeitará esses limites e retornará mensagens de erro apropriadas caso eles sejam excedidos.

Nota de segurança

Este servidor foi projetado apenas para operações de gerenciamento. Não o use para avaliar valores de feature flags em aplicações de produção — use os SDKs do ConfigCat ou o ConfigCat Proxy em vez disso.

Precisa de ajuda?

https://configcat.com/support

Contribuições

Contribuições são bem-vindas. Para mais informações, leia as Diretrizes de contribuição.

Sobre o ConfigCat