ConfigCat MCP Server

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).

GitHub
16

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 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.

Funcionalidades

  • Ferramentas:
    • Conjunto completo de ferramentas para operações da API pública de gerenciamento do ConfigCat. Você pode Criar, Ler, Atualizar e Excluir quaisquer entidades, como Feature Flags, Configurações, Ambientes ou Produtos dentro do ConfigCat.
    • Obtenha documentação abrangente do SDK e exemplos de código para uma 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 ambienteObrigatóriaPadrãoDescrição
CONFIGCAT_API_USER☑Nome de usuário de autenticação básica da API de Gerenciamento do ConfigCat.
CONFIGCAT_API_PASS☑Senha de 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 agora deve 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 Membros

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ão

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

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 SDK

  • get-sdk-keys - Obter chaves 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

Logs de auditoria

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

Flags zumbis (obsoletas)

  • 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çã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 Flag e Configuração (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 múltiplos valores de configuração
  • post-setting-values - Atualizar múltiplos valores de configuração
  • Variantes V2: *-v2 versões das ferramentas acima para Config V2

Documentação do SDK

  • update-sdk-documentation - Obtenha documentação abrangente do SDK e exemplos de código para uma 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 utilize para avaliar valores de feature flags em aplicações de produção - use os SDKs do ConfigCat ou o ConfigCat Proxy.

Precisa de ajuda?

https://configcat.com/support

Contribuindo

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

Sobre o ConfigCat