Hackle

Consulte dados de teste A/B usando a API do Hackle.

Documentação

Hackle MCP Server

[!WARNING]

⚠️ Este pacote npm local está obsoleto — use o servidor MCP remoto

O servidor MCP da Hackle agora está disponível como um servidor remoto, e este pacote npm local está obsoleto. O servidor remoto não requer configuração de npm ou Node.js, atualiza automaticamente, funciona no navegador e é onde todas as novas ferramentas (como estatísticas de mensagens e consultas de mensagens Kakao/Texto) são lançadas.

Este pacote não receberá mais atualizações ou novas ferramentas. As instalações existentes continuam funcionando por enquanto, mas migre para o servidor remoto.

👉 Guia de migração: https://docs.hackle.io/external-link/model-context-protocol/migration

Como conectar ao servidor remoto
Adicione um conector personalizado no claude.ai (web) ou no Claude Desktop via Personalização → Conectores → + Adicionar Conector Personalizado, usando a URL do servidor MCP remoto:
https://mcp.hackle.io/mcp
Insira sua chave de API Hackle existente na tela de autenticação — sua chave de API permanece inalterada.

Após conectar, você pode opcionalmente remover a entrada do servidor local do seu claude_desktop_config.json.

Um servidor de Model Context Protocol para a API da Hackle que fornece ferramentas e recursos para consultar dados de Teste A/B.

Recursos

Ferramentas

Ferramenta de Lista de Experimentos

Nome: experiment-list
Descrição: Busca uma lista paginada de experimentos de teste A/B com funcionalidade de pesquisa.
Parâmetros:
- pageNumber: Número da página (padrão: 1)
- pageSize: Número de itens por página (padrão: 100)
- searchKeyword: Palavra-chave de pesquisa (opcional)

Ferramenta de Detalhes do Experimento

Nome: experiment-detail
Descrição: Recupera informações detalhadas de um experimento de teste A/B específico.
Parâmetros:
- experimentId: ID do experimento

Ferramenta de Lista de Mensagens no Aplicativo

Nome: in-app-message-list
Descrição: Busca uma lista paginada de mensagens no aplicativo com funcionalidade de pesquisa.
Parâmetros:
- pageNumber: Número da página (padrão: 1)
- pageSize: Número de itens por página (padrão: 100)
- searchKeyword: Palavra-chave de pesquisa (opcional)

Ferramenta de Detalhes da Mensagem no Aplicativo

Nome: in-app-message-detail
Descrição: Recupera informações detalhadas de uma mensagem no aplicativo específica.
Parâmetros:
- inAppMessageId: ID da mensagem no aplicativo

Ferramenta de Lista de Mensagens Push

Nome: push-message-list
Descrição: Busca uma lista paginada de mensagens push com funcionalidade de pesquisa.
Parâmetros:
- pageNumber: Número da página (padrão: 1)
- pageSize: Número de itens por página (padrão: 100)
- searchKeyword: Palavra-chave de pesquisa (opcional)

Ferramenta de Detalhes da Mensagem Push

Nome: push-message-detail
Descrição: Recupera informações detalhadas de uma mensagem push específica.
Parâmetros:
- pushMessageId: ID da mensagem push

Ferramenta de Série de Usuários Ativos

Nome: active-user-series
Descrição: Recupera dados de série temporal de usuários ativos. Disponível em unidades diárias, semanais e mensais.
Parâmetros:
- unit: Unidade de tempo (DAY, WEEK, MONTH) (padrão: DAY)
- date: Data (opcional)

Ferramenta de Série de Retenção

Nome: retention-series
Descrição: Recupera dados de série temporal de retenção de usuários. Disponível em unidades diárias, semanais e mensais.
Parâmetros:
- unit: Unidade de tempo (DAY, WEEK, MONTH) (padrão: DAY)
- date: Data (opcional)

Ferramenta de Série de Aderência

Nome: stickiness-series
Descrição: Recupera dados de série temporal de aderência do usuário (frequência de visitas de retorno). Disponível em unidades semanais e mensais.
Parâmetros:
- unit: Unidade de tempo (WEEK, MONTH) (padrão: WEEK)
- date: Data (opcional)

Ferramenta de Lista de Relatórios de Dados

Nome: data-report-list
Descrição: Recupera todos os metadados de relatórios de dados.

Ferramenta de Detalhes do Relatório de Dados

Nome: data-report-detail
Descrição: Recupera os detalhes de um único relatório de dados. Ele fornecerá o ID e o tipo do gráfico de análise dentro do relatório de dados. É recomendado usar a Ferramenta de Detalhes do Gráfico de Análise para obter mais informações de cada gráfico.
Parâmetros:
- dataReportId: ID do relatório de dados. Isso pode ser encontrado na resposta da Ferramenta de Lista de Relatórios de Dados.

Ferramenta de Lista de Gráficos de Análise

Nome: analytics-chart-list
Descrição: Recupera a lista de metadados do gráfico de análise de dados.
Parâmetros:
- pageNumber: Número da página (padrão: 1) (opcional)
- pageSize: Número de itens por página (padrão: 100) (opcional)
- searchKeyword: Palavra-chave de pesquisa (opcional) (opcional)
- chartType: Tipos de gráfico que a Hackle fornece: FUNNEL, DATA_INSIGHT, RETENTION e USER_PATH. (opcional)

Ferramenta de Detalhes do Gráfico de Análise

Nome: analytics-chart-detail
Descrição: Recupera os detalhes do gráfico de análise de dados. Você pode visualizar o gráfico usando o resultado desta ferramenta.
Parâmetros:
- chartId: ID do gráfico de análise. Pode ser encontrado na resposta da Ferramenta de Detalhes do Relatório de Dados ou da Ferramenta de Lista de Gráficos de Análise.
- chartType: Tipo do gráfico de análise (FUNNEL, DATA_INSIGHT, RETENTION, USER_PATH). Pode ser encontrado na resposta da Ferramenta de Detalhes do Relatório de Dados ou da Ferramenta de Lista de Gráficos de Análise.

Ferramenta de Lista de Configurações Remotas

Nome: remote-config-list
Descrição: Recupera a lista de configurações remotas.
Parâmetros:
- pageNumber: Número da página (padrão: 1)
- pageSize: Número de itens por página (padrão: 100)
- searchKeyword: Palavra-chave de pesquisa (opcional)
- status: Status da configuração remota: ACTIVE, ARCHIVED (padrão: 'ACTIVE')

Ferramenta de Detalhes da Configuração Remota

Nome: remote-config-detail
Descrição: Recupera os detalhes da configuração remota.
Parâmetros:
- remoteConfigId: ID da configuração remota. Você pode obter essas informações usando a Ferramenta de Lista de Configurações Remotas.

Ferramenta de Criação de Configuração Remota

Nome: remote-config-create
Descrição: Cria uma configuração remota vazia. É recomendado atualizar uma RC existente primeiro se houver uma RC associada à que você deseja criar, pois o número total de RCs é limitado.
Parâmetros:
- body: Corpo da solicitação.
  - key: Nome da configuração remota.
  - description: Descrição da configuração remota.
  - dataType: Tipo do valor da configuração remota: STRING, JSON, NUMBER, BOOLEAN.
  - userIdentifierCriteria: Critérios de identificador de usuário para segmentação. Você pode usar critérios fornecidos pela Hackle($deviceId, $userId) ou seus próprios critérios criados no site do painel da Hackle. (padrão: '$deviceId')

Ferramenta de Atualização de Conteúdo da Configuração Remota

Nome: remote-config-update
Descrição: Atualiza o conteúdo da configuração remota.
Parâmetros:
- remoteConfigId: ID da configuração remota.
- body: Corpo da solicitação.
  - dataType: Tipo do valor da configuração remota: STRING, JSON, NUMBER, BOOLEAN. A solicitação não será aceita se o dataType e os valores da configuração remota não corresponderem.
  - remoteConfigDefaultValue: Valor padrão da configuração remota. O tipo deste valor deve corresponder ao campo dataType.
  - conditionalValues: Matriz de valores condicionais da configuração remota com segmentação por grupo de usuários.
    - ruleName: Nome da regra de condição de segmentação.
    - remoteConfigValue: Valor da configuração remota. O tipo deste valor deve corresponder ao campo dataType.
    - target
      - conditions: Regras de segmentação. Usuários que satisfazem todas as condições nesta matriz verão o valor da configuração remota desta regra.
        
        key
        
        type: Tipo da condição: HACKLE_PROPERTY, USER_PROPERTY, AB_TEST, FEATURE_FLAG, COHORT, SEGMENT.
        
        name: Nome da propriedade se o tipo for HACKLE_PROPERTY ou USER_PROPERTY. Chave do experimento se o tipo for AB_TEST. Chave do feature flag se o tipo for FEATURE_FLAG. Você pode colocar qualquer string não vazia se o tipo for COHORT ou SEGMENT.
        
        match
        
        operator: Operadores que serão usados para corresponder a chave e os valores da condição.
        
        valueType: Tipo do valor da condição de segmentação: NUMBER, STRING, BOOLEAN, VERSION.
        
        values: Valores da chave da condição de segmentação. A seguir estão alguns casos especiais: Os valores serão tratados como nomes se você estiver usando SEGMENT. Apenas as strings 'A' e 'B' são permitidas se o tipo for AB_TEST. Apenas valores booleanos são aceitos se o tipo for FEATURE_FLAG. Você deve colocar o ID do coorte se o tipo for COHORT.

Ferramenta de Atualização de Critérios de Identificador de Usuário da Configuração Remota

Nome: remote-config-update-user-identifier-criteria
Descrição: Atualiza os critérios de identificador de usuário da configuração remota. A alteração será aplicada tanto no ambiente de produção quanto no de desenvolvimento.
Parâmetros:
- remoteConfigId: ID da configuração remota.
- body: Corpo da solicitação.
  - userIdentifierCriteria: Critérios de identificador de usuário para segmentação. Você pode usar critérios fornecidos pela Hackle($deviceId, $userId) ou seus próprios critérios criados no site do painel da Hackle. (padrão: '$deviceId')

Ferramenta de Atualização de Descrição da Configuração Remota

Nome: remote-config-update-description
Descrição: Atualiza a descrição da configuração remota. A alteração será aplicada tanto no ambiente de produção quanto no de desenvolvimento.
Parâmetros:
- remoteConfigId: ID da configuração remota.
- body: Corpo da solicitação.
  - description: Descrição da configuração remota.

Instalação

Adicione esta entrada ao seu claude_desktop_config.json:

No Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
No Windows: %APPDATA%\Claude\claude_desktop_config.json
No 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 o Claude se estiver em execução

Obtendo Sua Chave de API

Para usar o Servidor MCP da Hackle, você precisará de uma chave de API. Para obter sua chave de API:

Entre em contato com a equipe da Hackle diretamente através da Comunidade Hackle no Slack
Solicite uma chave de API para acesso ao Servidor MCP
A equipe da Hackle fornecerá uma chave de API exclusiva para você

Importante: Nunca compartilhe sua chave de API nem a envie para repositórios públicos. Trate sua chave de API como uma credencial sensível.

Licença

MIT