Hackle

Consulta datos de pruebas A/B usando la API de Hackle.

GitHub
3
Prueba este MCPPatrocinado

Documentación

Servidor MCP de Hackle

smithery badge

[!ADVERTENCIA]

⚠️ Este paquete npm local está obsoleto: use el servidor MCP remoto

El servidor MCP de Hackle ahora está disponible como servidor remoto, y este paquete npm local está obsoleto. El servidor remoto no requiere configuración de npm ni Node.js, se actualiza automáticamente, funciona en el navegador y es donde se publican todas las nuevas herramientas (como estadísticas de mensajería y consultas de mensajes de Kakao/Texto).

Este paquete ya no recibirá actualizaciones ni nuevas herramientas. Las instalaciones existentes seguirán funcionando por ahora, pero migre al servidor remoto.

👉 Guía de migración: https://docs.hackle.io/external-link/model-context-protocol/migration

Cómo conectarse al servidor remoto

  1. Agregue un conector personalizado en claude.ai (web) o Claude Desktop mediante Personalización → Conectores → + Agregar conector personalizado, usando la URL del servidor MCP remoto:

    https://mcp.hackle.io/mcp

  2. Ingrese su clave API de Hackle existente en la pantalla de autenticación: su clave API permanece sin cambios.

  3. Una vez conectado, puede eliminar opcionalmente la entrada del servidor local de su claude_desktop_config.json.

Un servidor de Protocolo de Contexto de Modelo para la API de Hackle que proporciona herramientas y recursos para consultar datos de pruebas A/B.

hackle-mcp MCP server

Características

Herramientas

Herramienta de Lista de Experimentos

  • Nombre: experiment-list
  • Descripción: Obtiene una lista paginada de experimentos de pruebas A/B con funcionalidad de búsqueda.
  • Parámetros:
    • pageNumber: Número de página (predeterminado: 1)
    • pageSize: Cantidad de elementos por página (predeterminado: 100)
    • searchKeyword: Palabra clave de búsqueda (opcional)

Herramienta de Detalle de Experimento

  • Nombre: experiment-detail
  • Descripción: Recupera información detallada de un experimento de prueba A/B específico.
  • Parámetros:
    • experimentId: ID del experimento

Herramienta de Lista de Mensajes Dentro de la Aplicación

  • Nombre: in-app-message-list
  • Descripción: Obtiene una lista paginada de mensajes dentro de la aplicación con funcionalidad de búsqueda.
  • Parámetros:
    • pageNumber: Número de página (predeterminado: 1)
    • pageSize: Cantidad de elementos por página (predeterminado: 100)
    • searchKeyword: Palabra clave de búsqueda (opcional)

Herramienta de Detalle de Mensaje Dentro de la Aplicación

  • Nombre: in-app-message-detail
  • Descripción: Recupera información detallada de un mensaje específico dentro de la aplicación.
  • Parámetros:
    • inAppMessageId: ID del mensaje dentro de la aplicación

Herramienta de Lista de Mensajes Push

  • Nombre: push-message-list
  • Descripción: Obtiene una lista paginada de mensajes push con funcionalidad de búsqueda.
  • Parámetros:
    • pageNumber: Número de página (predeterminado: 1)
    • pageSize: Cantidad de elementos por página (predeterminado: 100)
    • searchKeyword: Palabra clave de búsqueda (opcional)

Herramienta de Detalle de Mensaje Push

  • Nombre: push-message-detail
  • Descripción: Recupera información detallada de un mensaje push específico.
  • Parámetros:
    • pushMessageId: ID del mensaje push

Herramienta de Serie de Usuarios Activos

  • Nombre: active-user-series
  • Descripción: Recupera datos de series temporales de usuarios activos. Disponible en unidades diarias, semanales y mensuales.
  • Parámetros:
    • unit: Unidad de tiempo (DAY, WEEK, MONTH) (predeterminado: DAY)
    • date: Fecha (opcional)

Herramienta de Serie de Retención

  • Nombre: retention-series
  • Descripción: Recupera datos de series temporales de retención de usuarios. Disponible en unidades diarias, semanales y mensuales.
  • Parámetros:
    • unit: Unidad de tiempo (DAY, WEEK, MONTH) (predeterminado: DAY)
    • date: Fecha (opcional)

Herramienta de Serie de Adherencia

  • Nombre: stickiness-series
  • Descripción: Recupera datos de series temporales de adherencia de usuarios (frecuencia de visitas de retorno). Disponible en unidades semanales y mensuales.
  • Parámetros:
    • unit: Unidad de tiempo (WEEK, MONTH) (predeterminado: WEEK)
    • date: Fecha (opcional)

Herramienta de Lista de Informes de Datos

  • Nombre: data-report-list
  • Descripción: Recupera todos los metadatos de informes de datos.

Herramienta de Detalle de Informe de Datos

  • Nombre: data-report-detail
  • Descripción: Recupera el detalle de un único informe de datos. Proporcionará el ID y tipo de gráfico analítico dentro del informe de datos. Se recomienda usar la Herramienta de Detalle de Gráfico Analítico para obtener más información de cada gráfico.
  • Parámetros:
    • dataReportId: ID del informe de datos. Se puede encontrar en la respuesta de la Herramienta de Lista de Informes de Datos.

Herramienta de Lista de Gráficos Analíticos

  • Nombre: analytics-chart-list
  • Descripción: Recupera la lista de metadatos de gráficos analíticos de datos.
  • Parámetros:
    • pageNumber: Número de página (predeterminado: 1) (opcional)
    • pageSize: Cantidad de elementos por página (predeterminado: 100) (opcional)
    • searchKeyword: Palabra clave de búsqueda (opcional) (opcional)
    • chartType: Tipos de gráficos que proporciona Hackle: FUNNEL, DATA_INSIGHT, RETENTION y USER_PATH. (opcional)

Herramienta de Detalle de Gráfico Analítico

  • Nombre: analytics-chart-detail
  • Descripción: Recupera el detalle del gráfico analítico de datos. Puede visualizar el gráfico usando el resultado de esta herramienta.
  • Parámetros:
    • chartId: ID del gráfico analítico. Se puede encontrar en la respuesta de la Herramienta de Detalle de Informe de Datos o de la Herramienta de Lista de Gráficos Analíticos.
    • chartType: Tipo del gráfico analítico (FUNNEL, DATA_INSIGHT, RETENTION, USER_PATH). Se puede encontrar en la respuesta de la Herramienta de Detalle de Informe de Datos o de la Herramienta de Lista de Gráficos Analíticos.

Herramienta de Lista de Configuración Remota

  • Nombre: remote-config-list
  • Descripción: Recupera la lista de configuraciones remotas.
  • Parámetros:
    • pageNumber: Número de página (predeterminado: 1)
    • pageSize: Cantidad de elementos por página (predeterminado: 100)
    • searchKeyword: Palabra clave de búsqueda (opcional)
    • status: Estado de la configuración remota: ACTIVE, ARCHIVED (predeterminado: 'ACTIVE')

Herramienta de Detalle de Configuración Remota

  • Nombre: remote-config-detail
  • Descripción: Recupera el detalle de la configuración remota.
  • Parámetros:
    • remoteConfigId: ID de la configuración remota. Puede obtener esta información usando la Herramienta de Lista de Configuración Remota.

Herramienta de Creación de Configuración Remota

  • Nombre: remote-config-create
  • Descripción: Crea una configuración remota vacía. Se recomienda actualizar primero una RC existente si hay una RC asociada con la que desea crear, ya que el número total de RC es limitado.
  • Parámetros:
    • body: Cuerpo de la solicitud.
      • key: Nombre de la configuración remota.
      • description: Descripción de la configuración remota.
      • dataType: Tipo del valor de la configuración remota: STRING, JSON, NUMBER, BOOLEAN.
      • userIdentifierCriteria: Criterio de identificación de usuario para la segmentación. Puede usar criterios proporcionados por Hackle ($deviceId, $userId) o sus propios criterios creados en el sitio web del panel de Hackle. (predeterminado: '$deviceId')

Herramienta de Actualización de Contenido de Configuración Remota

  • Nombre: remote-config-update
  • Descripción: Actualiza el contenido de la configuración remota.
  • Parámetros:
    • remoteConfigId: ID de la configuración remota.
    • body: Cuerpo de la solicitud.
      • dataType: Tipo del valor de la configuración remota: STRING, JSON, NUMBER, BOOLEAN. La solicitud no se aceptará si dataType y los valores de la configuración remota no coinciden.
      • remoteConfigDefaultValue: Valor predeterminado de la configuración remota. El tipo de este valor debe coincidir con el campo dataType.
      • conditionalValues: Matriz de valores condicionales de configuración remota con segmentación por grupo de usuarios.
        • ruleName: Nombre de la regla de condición de segmentación.
        • remoteConfigValue: Valor de la configuración remota. El tipo de este valor debe coincidir con el campo dataType.
        • target
          • conditions: Reglas de segmentación. Los usuarios que cumplan todas las condiciones de esta matriz verán el valor de configuración remota de esta regla.
            • key
              • type: Tipo de condición: HACKLE_PROPERTY, USER_PROPERTY, AB_TEST, FEATURE_FLAG, COHORT, SEGMENT.
              • name: Nombre de la propiedad si el tipo es HACKLE_PROPERTY o USER_PROPERTY. Clave del experimento si el tipo es AB_TEST. Clave del feature flag si el tipo es FEATURE_FLAG. Puede poner cualquier cadena no vacía si el tipo es COHORT o SEGMENT.
            • match
              • operator: Operadores que se usarán para comparar la clave y los valores de la condición.
              • valueType: Tipo del valor de la condición de segmentación: NUMBER, STRING, BOOLEAN, VERSION.
              • values: Valores de la clave de la condición de segmentación. Los siguientes son algunos casos especiales: los valores se tratarán como nombres si usa SEGMENT. Solo se permiten las cadenas 'A' y 'B' si el tipo es AB_TEST. Solo se aceptan valores booleanos si el tipo es FEATURE_FLAG. Debe poner el ID de la cohorte si el tipo es COHORT.

Herramienta de Actualización de Criterios de Identificación de Usuario de Configuración Remota

  • Nombre: remote-config-update-user-identifier-criteria
  • Descripción: Actualiza los criterios de identificación de usuario de la configuración remota. El cambio se aplicará tanto al entorno de producción como al de desarrollo.
  • Parámetros:
    • remoteConfigId: ID de la configuración remota.
    • body: Cuerpo de la solicitud.
      • userIdentifierCriteria: Criterio de identificación de usuario para la segmentación. Puede usar criterios proporcionados por Hackle ($deviceId, $userId) o sus propios criterios creados en el sitio web del panel de Hackle. (predeterminado: '$deviceId')

Herramienta de Actualización de Descripción de Configuración Remota

  • Nombre: remote-config-update-description
  • Descripción: Actualiza la descripción de la configuración remota. El cambio se aplicará tanto al entorno de producción como al de desarrollo.
  • Parámetros:
    • remoteConfigId: ID de la configuración remota.
    • body: Cuerpo de la solicitud.
      • description: Descripción de la configuración remota.

Instalación

Agregue esta entrada a su claude_desktop_config.json:

  • En Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
  • En Windows: %APPDATA%\Claude\claude_desktop_config.json
  • En Linux: ~/.config/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "hackle-mcp": {
      "command": "npx",
      "args": ["-y", "@hackle-io/hackle-mcp@latest"],
      "env": {
        "API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Reinicie Claude si está en ejecución

Cómo Obtener Su Clave API

Para usar el Servidor MCP de Hackle, necesitará una clave API. Para obtener su clave API:

  1. Contacte directamente al equipo de Hackle a través de Comunidad Slack de Hackle
  2. Solicite una clave API para el acceso al Servidor MCP
  3. El equipo de Hackle le proporcionará una clave API única

Importante: Nunca comparta su clave API ni la confirme en repositorios públicos. Trate su clave API como una credencial sensible.

Licencia

MIT