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 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
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 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 deverá 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ção
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 de SDK
get-sdk-keys- Obter chaves de 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 de 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
Registros de auditoria
list-auditlogs- Obter registros de auditoria do produtolist-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çã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 vários valores de configuraçãopost-setting-values- Atualizar vários valores de configuração- Variantes V2:
*-v2versõ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íficaupdate-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çãoget-change-request-proposed-changes- Retorna as alterações propostas nas Configurações incluídas em uma Solicitação de alteraçãoupdate-change-request-proposed-change- Atualiza as alterações propostas nas 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- Assume 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 o 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 em 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 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?
Contribuições
Contribuições são bem-vindas. Para mais informações, leia as Diretrizes de contribuição.