ConfigCat

Servidor MCP de ConfigCat

El servidor del Protocolo de Contexto de Modelos (MCP) de ConfigCat proporciona acceso a la API pública de gestión de ConfigCat para la administración de feature flags y configuraciones. También permite que tu editor de código comprenda tus feature flags, integre el SDK de ConfigCat adecuado en tu proyecto o incluso cree nuevos feature flags directamente en tu 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 fluida de feature flags en tu proyecto.

Configuración

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

Variable de entorno	Requerida	Predeterminado	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. Agrega 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 ahora debería estar 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. Agrega 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 específicos del producto
• 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 específicos de la configuración
• 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 específicos del entorno
• 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 específicos del segmento
• 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ósticos

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

Flags zombis (obsoletos)

• list-staleflags - Obtener informe de feature flags obsoletos

Metadatos de Feature Flags

Feature Flags y Configuraciones

• list-settings - Listar feature flags de una configuración
• create-setting - Crear un nuevo feature flag
• list-predefined-variations - Listar variaciones predefinidas
• update-predefined-variations - Actualizar variaciones predefinidas
• get-setting - Obtener detalles específicos del feature flag
• replace-setting - Reemplazar configuración del feature flag
• update-setting - Actualizar feature flag existente
• delete-setting - Eliminar un 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 específicos de la etiqueta
• 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 del feature flag
• update-setting-value - Actualizar valor del feature flag
• replace-setting-value - Reemplazar valor del 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

Solicitudes de Cambio

• get-change-request - Devuelve los detalles de una Solicitud de Cambio específica
• update-change-request - Actualiza los metadatos de una Solicitud de Cambio, como título, nota, programación, etc.
• list-change-requests - Listar Solicitudes de Cambio
• get-change-request-proposed-changes - Devuelve los cambios propuestos a las Configuraciones incluidas en una Solicitud de Cambio
• update-change-request-proposed-change - Actualiza los cambios propuestos a las Configuraciones incluidas en una Solicitud de Cambio
• add-change-request-comment - Agrega un nuevo comentario a la Solicitud de Cambio
• apply-change-request - Aplica la Solicitud de Cambio
• approve-change-request - Agrega tu aprobación a la Solicitud de Cambio
• claim-change-request-ownership - Reclama la propiedad de la Solicitud de Cambio
• close-change-request - Cierra la Solicitud de Cambio sin aplicarla
• create-change-request - Crea una nueva Solicitud de Cambio para la Configuración y el Entorno especificados
• remove-change-request-approval - Elimina tu aprobación existente de la Solicitud de Cambio
• resolve-change-request-setting-conflicts - Actualiza los cambios propuestos a una Configuración incluida en la Solicitud de Cambio para resolver conflictos causados por cambios publicados simultáneamente
• update-change-request-comment - Actualiza un comentario existente de la Solicitud de Cambio
• delete-change-request-comment - Elimina un comentario de la Solicitud de Cambio
• delete-change-request-proposed-change - Elimina una configuración de una Solicitud de Cambio

Documentación del SDK

• update-sdk-documentation - Obtén documentación completa del SDK y ejemplos de código para una implementación fluida 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 los límites.

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 de producción; usa los SDKs de ConfigCat o el Proxy de ConfigCat en su lugar.

¿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