ConfigCat MCP Server

Servidor MCP de ConfigCat

El servidor del Protocolo de Contexto de Modelo (MCP) de ConfigCat proporciona acceso a la API pública de gestión de ConfigCat para la administración de feature flags y configuración. También permite que tu editor de código entienda tus feature flags, integre el SDK de ConfigCat adecuado en tu proyecto o incluso cree nuevas feature flags directamente en tu base de código.

Características

• Herramientas:
  • Conjunto completo de herramientas para las operaciones de la API pública de gestión de ConfigCat. Puedes Crear, Leer, Actualizar y Eliminar cualquier entidad como Feature Flags, Configuraciones, Entornos o Productos dentro de ConfigCat.
  • Obtén documentación completa del SDK y ejemplos de código para una implementación perfecta de feature flags en tu proyecto.

Configuración

Puedes usar las siguientes variables de entorno para configurar el servidor MCP.

Variable de entorno	Requerida	Valor por defecto	Descripción
CONFIGCAT_API_USER	☑		Nombre de usuario de autenticación básica de la API de gestión de ConfigCat.
CONFIGCAT_API_PASS	☑		Contraseña de autenticación básica de la API de gestión de ConfigCat.
CONFIGCAT_BASE_URL		https://api.configcat.com	Host de la API de gestión de ConfigCat.

Las instrucciones a continuación muestran cómo conectar un cliente al servidor MCP.

Cursor

1. Abre Preferences -> Cursor Settings -> MCP & Integrations
2. Haz clic en Add Custom MCP
3. Añade la siguiente definición de servidor para el servidor MCP de ConfigCat:

{
  "mcpServers": {
    "ConfigCat": {
      "command": "npx",
      "args": ["-y", "@configcat/mcp-server"],
      "env": {
        "CONFIGCAT_API_USER": "YOUR_API_USER",
        "CONFIGCAT_API_PASS": "YOUR_API_PASSWORD"
      }
    }
  }
}

4. Guarda la configuración.

Visual Studio Code

1. Crea un archivo .vscode/mcp.json en la raíz de tu proyecto con el siguiente contenido:

{
  "servers": {
    "ConfigCat": {
      "command": "npx",
      "args": ["-y", "@configcat/mcp-server"],
      "env": {
        "CONFIGCAT_API_USER": "YOUR_API_USER",
        "CONFIGCAT_API_PASS": "YOUR_API_PASSWORD"
      }
    }
  }
}

2. Guarda el archivo de configuración. El servidor MCP debería estar ahora disponible en VS Code.

Claude Desktop

1. Abre Configuración → Desarrollador
2. Haz clic en Editar configuración
3. Abre claude_desktop_config.json
4. Añade la siguiente definición de servidor para el servidor MCP de ConfigCat:

{
  "mcpServers": {
    "ConfigCat": {
      "command": "npx",
      "args": ["-y", "@configcat/mcp-server"],
      "env": {
        "CONFIGCAT_API_USER": "YOUR_API_USER",
        "CONFIGCAT_API_PASS": "YOUR_API_PASSWORD"
      }
    }
  }
}

5. Guarda y reinicia Claude.

Herramientas disponibles

Gestión de membresías

Organizaciones

• list-organizations - Listar todas las organizaciones

Miembros

• list-organization-members - Listar miembros de la organización
• list-pending-invitations - Listar invitaciones pendientes
• list-pending-invitations-org - Listar invitaciones pendientes de la organización
• list-product-members - Listar miembros del producto
• invite-member - Invitar a un nuevo miembro
• update-member-permissions - Actualizar los permisos de un miembro
• delete-organization-member - Eliminar miembro de la organización
• delete-product-member - Eliminar miembro del producto
• delete-invitation - Cancelar invitación

Grupos de permisos

• list-permission-groups - Listar grupos de permisos
• create-permission-group - Crear un nuevo grupo de permisos
• get-permission-group - Obtener detalles del grupo de permisos
• update-permission-group - Actualizar grupo de permisos
• delete-permission-group - Eliminar grupo de permisos

General

Productos

• list-products - Listar todos los productos
• get-product - Obtener detalles de un producto específico
• update-product - Actualizar producto existente
• delete-product - Eliminar un producto
• get-product-preferences - Obtener preferencias del producto
• update-product-preferences - Actualizar preferencias del producto
• create-product - Crear un nuevo producto

Configuraciones

• list-configs - Listar configuraciones de un producto
• create-config - Crear una nueva configuración
• get-config - Obtener detalles de una configuración específica
• update-config - Actualizar configuración existente
• delete-config - Eliminar una configuración

Entornos

• list-environments - Listar entornos de un producto
• create-environment - Crear un nuevo entorno
• get-environment - Obtener detalles de un entorno específico
• update-environment - Actualizar entorno existente
• delete-environment - Eliminar un entorno

Segmentos

• list-segments - Listar segmentos de usuarios
• create-segment - Crear un nuevo segmento
• get-segment - Obtener detalles de un segmento específico
• update-segment - Actualizar segmento existente
• delete-segment - Eliminar un segmento

Claves SDK

• get-sdk-keys - Obtener claves SDK para configuración/entorno

Webhooks

• list-webhooks - Listar webhooks
• get-webhook - Obtener detalles del webhook
• replace-webhook - Reemplazar configuración del webhook
• update-webhook - Actualizar webhook existente
• delete-webhook - Eliminar un webhook
• get-webhook-signing-keys - Listar claves de firma de webhooks
• create-webhook - Crear un nuevo webhook

Integraciones

• list-integrations - Listar integraciones
• create-integration - Crear una nueva integración
• get-integration - Obtener detalles de la integración
• update-integration - Actualizar integración existente
• delete-integration - Eliminar una integración

Referencias de código

• get-code-references - Obtener referencias de código

Diagnóstico

Registros de auditoría

• list-auditlogs - Obtener registros de auditoría del producto
• list-organization-auditlogs - Obtener registros de auditoría de la organización

Banderas zombi (obsoletas)

• list-staleflags - Obtener informe de feature flags obsoletas

Metadatos de Feature Flags

Feature Flags y configuraciones

• list-settings - Listar feature flags de una configuración
• create-setting - Crear una nueva feature flag
• list-predefined-variations - Listar variaciones predefinidas
• update-predefined-variations - Actualizar variaciones predefinidas
• get-setting - Obtener detalles de una feature flag específica
• replace-setting - Reemplazar configuración de feature flag
• update-setting - Actualizar feature flag existente
• delete-setting - Eliminar una feature flag

Etiquetas

• list-tags - Listar etiquetas de un producto
• create-tag - Crear una nueva etiqueta
• list-settings-by-tag - Obtener feature flags por etiqueta
• get-tag - Obtener detalles de una etiqueta específica
• update-tag - Actualizar etiqueta existente
• delete-tag - Eliminar una etiqueta

Valores de Feature Flags y configuraciones (APIs v1 y v2)

• get-setting-value - Obtener valor de feature flag
• update-setting-value - Actualizar valor de feature flag
• replace-setting-value - Reemplazar valor de feature flag
• get-setting-values - Obtener múltiples valores de configuración
• post-setting-values - Actualizar múltiples valores de configuración
• Variantes V2: versiones *-v2 de las herramientas anteriores para Config V2

Documentación del SDK

• update-sdk-documentation - Obtén documentación completa del SDK y ejemplos de código para una implementación perfecta de feature flags en tu proyecto.

Límites de tasa de la API

La API pública de ConfigCat tiene límites de tasa. El servidor respetará estos límites y devolverá mensajes de error apropiados si se exceden.

Nota de seguridad

Este servidor está diseñado solo para operaciones de gestión. No lo uses para evaluar valores de feature flags en aplicaciones en producción; en su lugar, utiliza los SDKs de ConfigCat o el Proxy de ConfigCat.

¿Necesitas ayuda?

https://configcat.com/support

Contribuciones

Las contribuciones son bienvenidas. Para más información, lee la Guía de contribución.

Acerca de ConfigCat

• Documentación del servidor MCP de ConfigCat
• Documentación
• Blog