ConfigCat
oficialinterage 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 feature flags — Peça ao seu assistente para criar, atualizar ou excluir feature flags e configurações via
create-setting,update-settingoudelete-setting. - Controlar valores de flags — Use
get-setting-valueouupdate-setting-valuepara ler ou alterar valores de feature flags em diferentes ambientes. - Lidar com solicitações de alteração — Crie, aprove, aplique ou comente em solicitações de alteração com ferramentas como
create-change-requesteapply-change-request. - Obter orientação do SDK — Solicite
update-sdk-documentationpara exemplos de código e orientação de implementação para o SDK do seu projeto. - Gerenciar acesso da equipe — Convide membros, atualize permissões ou liste membros da organização usando
invite-memberelist-organization-members. - Acompanhar a saúde das flags — Gere relatórios de flags obsoletas com
list-staleflagsou revise logs de auditoria vialist-auditlogs.
Documentação
Servidor MCP do ConfigCat
O servidor do Model Context Protocol (MCP) do ConfigCat fornece acesso à API pública de gerenciamento do ConfigCat para 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 no seu 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 qualquer entidade como Feature Flags, Configurações, Ambientes ou Produtos dentro do ConfigCat.
- Obtenha documentação abrangente do SDK e exemplos de código para implementação perfeita de feature flags no seu projeto.
Configuração
Você pode usar as seguintes variáveis de ambiente para configurar o servidor MCP.
| Variável de ambiente | Obrigatória | Padrão | Descriçã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_URL | https://api.configcat.com | Host da API de gerenciamento do ConfigCat. |
As instruções abaixo mostram como conectar um cliente ao servidor MCP.
Cursor
- Abra
Preferences->Cursor Settings->MCP & Integrations - Clique em
Add Custom MCP - 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"
}
}
}
}
- Salve as configurações.
Visual Studio Code
- Crie um arquivo
.vscode/mcp.jsonna 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"
}
}
}
}
- Salve o arquivo de configurações. O servidor MCP agora deve estar disponível no VS Code.
Claude Desktop
- Abra Configurações → Desenvolvedor
- Clique em Editar Configuração
- Abra
claude_desktop_config.json - 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"
}
}
}
}
- Salve e reinicie o Claude.
Ferramentas Disponíveis
Gerenciamento de Associações
Organizações
list-organizations- Listar todas as organizações
Membros
list-organization-members- Listar membros da organizaçãolist-pending-invitations- Listar convites pendenteslist-pending-invitations-org- Listar convites pendentes da organizaçãolist-product-members- Listar membros do produtoinvite-member- Convidar um novo membroupdate-member-permissions- Atualizar as permissões de um membrodelete-organization-member- Remover membro da organizaçãodelete-product-member- Remover membro do produtodelete-invitation- Cancelar convite
Grupos de Permissões
list-permission-groups- Listar grupos de permissõescreate-permission-group- Criar um novo grupo de permissõesget-permission-group- Obter detalhes do grupo de permissõesupdate-permission-group- Atualizar grupo de permissõesdelete-permission-group- Excluir grupo de permissões
Geral
Produtos
list-products- Listar todos os produtosget-product- Obter detalhes de um produto específicoupdate-product- Atualizar produto existentedelete-product- Excluir um produtoget-product-preferences- Obter preferências do produtoupdate-product-preferences- Atualizar preferências do produtocreate-product- Criar um novo produto
Configurações
list-configs- Listar configurações de um produtocreate-config- Criar uma nova configuraçãoget-config- Obter detalhes de uma configuração específicaupdate-config- Atualizar configuração existentedelete-config- Excluir uma configuração
Ambientes
list-environments- Listar ambientes de um produtocreate-environment- Criar um novo ambienteget-environment- Obter detalhes de um ambiente específicoupdate-environment- Atualizar ambiente existentedelete-environment- Excluir um ambiente
Segmentos
list-segments- Listar segmentos de usuárioscreate-segment- Criar um novo segmentoget-segment- Obter detalhes de um segmento específicoupdate-segment- Atualizar segmento existentedelete-segment- Excluir um segmento
Chaves do SDK
get-sdk-keys- Obter chaves do SDK para configuração/ambiente
Webhooks
list-webhooks- Listar webhooksget-webhook- Obter detalhes do webhookreplace-webhook- Substituir configuração do webhookupdate-webhook- Atualizar webhook existentedelete-webhook- Excluir um webhookget-webhook-signing-keys- Listar chaves de assinatura do webhookcreate-webhook- Criar um novo webhook
Integrações
list-integrations- Listar integraçõescreate-integration- Criar uma nova integraçãoget-integration- Obter detalhes da integraçãoupdate-integration- Atualizar integração existentedelete-integration- Excluir uma integração
Referências de Código
get-code-references- Obter referências de código
Diagnóstico
Logs de auditoria
list-auditlogs- Obter logs de auditoria do produtolist-organization-auditlogs- Obter logs de auditoria da organização
Flags obsoletas (zumbis)
list-staleflags- Obter relatório de feature flags obsoletas
Metadados de Feature Flags
Feature Flags e Configurações
list-settings- Listar feature flags de uma configuraçãocreate-setting- Criar uma nova feature flaglist-predefined-variations- Listar variações predefinidasupdate-predefined-variations- Atualizar variações predefinidasget-setting- Obter detalhes de uma feature flag específicareplace-setting- Substituir configuração da feature flagupdate-setting- Atualizar feature flag existentedelete-setting- Excluir uma feature flag
Tags
list-tags- Listar tags de um produtocreate-tag- Criar uma nova taglist-settings-by-tag- Obter feature flags por tagget-tag- Obter detalhes de uma tag específicaupdate-tag- Atualizar tag existentedelete-tag- Excluir uma tag
Valores de Feature Flags e Configurações (APIs v1 e v2)
get-setting-value- Obter valor da feature flagupdate-setting-value- Atualizar valor da feature flagreplace-setting-value- Substituir valor da feature flagget-setting-values- Obter múltiplos valores de configuraçãopost-setting-values- Atualizar múltiplos valores de configuração- Variantes V2: versões
*-v2das ferramentas acima para Config V2
Solicitações de Alteração
get-change-request- Retorna os detalhes de uma Solicitação de Alteração específicaupdate-change-request- Atualiza os metadados de uma Solicitação de Alteração, como título, nota, agendamento, etc.list-change-requests- Listar Solicitações de Alteraçãoget-change-request-proposed-changes- Retorna as alterações propostas para as Configurações incluídas em uma Solicitação de Alteraçãoupdate-change-request-proposed-change- Atualiza as alterações propostas para as Configurações incluídas em uma Solicitação de Alteraçãoadd-change-request-comment- Adiciona um novo comentário à Solicitação de Alteraçãoapply-change-request- Aplica a Solicitação de Alteraçãoapprove-change-request- Adiciona sua aprovação à Solicitação de Alteraçãoclaim-change-request-ownership- Reivindica a propriedade da Solicitação de Alteraçãoclose-change-request- Fecha a Solicitação de Alteração sem aplicá-lacreate-change-request- Cria uma nova Solicitação de Alteração para a Configuração e Ambiente especificadosremove-change-request-approval- Remove sua aprovação existente da Solicitação de Alteraçãoresolve-change-request-setting-conflicts- Atualiza as alterações propostas para uma Configuração incluída na Solicitação de Alteração para resolver conflitos causados por alterações publicadas simultaneamenteupdate-change-request-comment- Atualiza um comentário existente da Solicitação de Alteraçãodelete-change-request-comment- Exclui um comentário da Solicitação de Alteraçãodelete-change-request-proposed-change- Remove uma configuração de uma Solicitação de Alteração
Documentação do SDK
update-sdk-documentation- Obtenha documentação abrangente do SDK e exemplos de código para implementação perfeita de feature flags no seu projeto.
Limites de Taxa da API
A API pública do ConfigCat possui limites de taxa. O servidor respeitará esses limites e retornará mensagens de erro apropriadas se os limites forem 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?
Contribuindo
Contribuições são bem-vindas. Para mais informações, leia a Diretriz de Contribuição.