Hackle

Hackle MCP Server

警告

⚠️ 此本地 npm 包已弃用 — 请使用远程 MCP 服务

Hackle MCP 服务现已作为远程服务提供，此本地 npm 包已弃用。远程服务无需配置 npm 或 Node.js，会自动更新，可在浏览器中使用，并且所有新工具（例如消息统计信息和 Kakao/Text 消息查询）都将在此服务中推出。

此软件包将不再获得更新或新工具。 现有安装目前仍可正常使用，但请迁移到远程服务。

👉 迁移指南：https://docs.hackle.io/external-link/model-context-protocol/migration

如何连接到远程服务

1. 在 claude.ai（网页端）或 Claude Desktop 中，通过 Customization → Connectors → + Add Custom Connector 添加自定义连接器，并使用远程 MCP 服务 URL：

   https://mcp.hackle.io/mcp
   

2. 在身份验证页面中输入你的现有 Hackle API key — 你的 API key 保持不变。

3. 连接后，你可以选择从 claude_desktop_config.json 中移除本地服务条目。

一个用于 Hackle API 的 Model Context Protocol 服务，提供查询 A/B 测试数据的工具和资源。

功能

工具

实验列表工具

• 名称：experiment-list
• 说明：获取支持搜索功能的分页 A/B 测试实验列表。
• 参数：
  • pageNumber：页码（默认值：1）
  • pageSize：每页项目数（默认值：100）
  • searchKeyword：搜索关键词（可选）

实验详情工具

• 名称：experiment-detail
• 说明：获取指定 A/B 测试实验的详细信息。
• 参数：
  • experimentId：实验 ID

应用内消息列表工具

• 名称：in-app-message-list
• 说明：获取支持搜索功能的分页应用内消息列表。
• 参数：
  • pageNumber：页码（默认值：1）
  • pageSize：每页项目数（默认值：100）
  • searchKeyword：搜索关键词（可选）

应用内消息详情工具

• 名称：in-app-message-detail
• 说明：获取指定应用内消息的详细信息。
• 参数：
  • inAppMessageId：应用内消息 ID

推送消息列表工具

• 名称：push-message-list
• 说明：获取支持搜索功能的分页推送消息列表。
• 参数：
  • pageNumber：页码（默认值：1）
  • pageSize：每页项目数（默认值：100）
  • searchKeyword：搜索关键词（可选）

推送消息详情工具

• 名称：push-message-detail
• 说明：获取指定推送消息的详细信息。
• 参数：
  • pushMessageId：推送消息 ID

活跃用户序列工具

• 名称：active-user-series
• 说明：获取活跃用户的时间序列数据。支持按日、周和月统计。
• 参数：
  • unit：时间单位（DAY、WEEK、MONTH）（默认值：DAY）
  • date：日期（可选）

留存序列工具

• 名称：retention-series
• 说明：获取用户留存的时间序列数据。支持按日、周和月统计。
• 参数：
  • unit：时间单位（DAY、WEEK、MONTH）（默认值：DAY）
  • date：日期（可选）

粘性序列工具

• 名称：stickiness-series
• 说明：获取用户粘性（回访频率）的时间序列数据。支持按周和月统计。
• 参数：
  • unit：时间单位（WEEK、MONTH）（默认值：WEEK）
  • date：日期（可选）

数据报告列表工具

• 名称：data-report-list
• 描述：获取所有数据报告元数据。

数据报告详情工具

• 名称：data-report-detail
• 描述：获取单个数据报告的详情。它会提供数据报告中分析图表的 ID 和类型。建议使用分析图表详情工具获取每个图表的更多信息。
• 参数：
  • dataReportId：数据报告的 ID。可在数据报告列表工具的响应中找到。

分析图表列表工具

• 名称：analytics-chart-list
• 描述：获取数据分析图表的元数据列表。
• 参数：
  • pageNumber：页码（默认值：1）（可选）
  • pageSize：每页项目数（默认值：100）（可选）
  • searchKeyword：搜索关键词（可选）（可选）
  • chartType：Hackle 提供的图表类型：FUNNEL、DATA_INSIGHT、RETENTION 和 USER_PATH。（可选）

分析图表详情工具

• 名称：analytics-chart-detail
• 描述：获取数据分析图表的详情。你可以使用此工具的结果将图表可视化。
• 参数：
  • chartId：分析图表的 ID。可在数据报告详情工具或分析图表列表工具的响应中找到。
  • chartType：分析图表的类型（FUNNEL、DATA_INSIGHT、RETENTION、USER_PATH）。可在数据报告详情工具或分析图表列表工具的响应中找到。

远程配置列表工具

• 名称：remote-config-list
• 描述：获取远程配置列表。
• 参数：
  • pageNumber：页码（默认值：1）
  • pageSize：每页项目数（默认值：100）
  • searchKeyword：搜索关键词（可选）
  • status：远程配置的状态：ACTIVE、ARCHIVED（默认值：'ACTIVE'）

远程配置详情工具

• 名称：remote-config-detail
• 描述：获取远程配置的详情。
• 参数：
  • remoteConfigId：远程配置的 ID。你可以使用远程配置列表工具获取此信息。

远程配置创建工具

• 名称：remote-config-create
• 描述：创建一个空的远程配置。如果你要创建的配置已有相关联的 RC，建议先更新现有 RC，因为 RC 的总数有限。
• 参数：
  • body：请求正文。
    • key：远程配置的名称。
    • description：远程配置的描述。
    • dataType：远程配置值的类型：STRING、JSON、NUMBER、BOOLEAN。
    • userIdentifierCriteria：用于定向的用户标识符条件。你可以使用 Hackle 提供的条件（$deviceId、$userId），也可以使用在 Hackle 仪表板网站上创建的自定义条件。（默认值：'$deviceId'）

远程配置内容更新工具

• 名称：remote-config-update
• 描述：更新远程配置的内容。
• 参数：
  • remoteConfigId：远程配置的 ID。
  • body：请求正文。
    • dataType：远程配置值的类型：STRING、JSON、NUMBER、BOOLEAN。如果 dataType 与远程配置值不匹配，请求将不会被接受。
    • remoteConfigDefaultValue：远程配置的默认值。此值的类型应与 dataType 字段匹配。
    • conditionalValues：包含用户组定向的条件远程配置值数组。
      • ruleName：定向条件规则的名称。
      • remoteConfigValue：远程配置的值。此值的类型应与 dataType 字段匹配。
      • target
        • conditions：定向规则。满足此数组中所有条件的用户将看到此规则的远程配置值。
          • key
            • type：条件类型：HACKLE_PROPERTY、USER_PROPERTY、AB_TEST、FEATURE_FLAG、COHORT、SEGMENT。
            • name：如果类型为 HACKLE_PROPERTY 或 USER_PROPERTY，则填写属性名称；如果类型为 AB_TEST，则填写实验键；如果类型为 FEATURE_FLAG，则填写功能标志键。如果类型为 COHORT 或 SEGMENT，可以填写任意非空字符串。
          • match
            • operator：用于匹配条件键和值的运算符。
            • valueType：定向条件值的类型：NUMBER、STRING、BOOLEAN、VERSION。
            • values：定向条件键的值。以下是一些特殊情况：使用 SEGMENT 时，这些值将被视为名称。类型为 AB_TEST 时，只允许使用字符串 'A' 和 'B'。类型为 FEATURE_FLAG 时，只接受布尔值。类型为 COHORT 时，应填写 cohort 的 ID。

远程配置用户标识符条件更新工具

• 名称：remote-config-update-user-identifier-criteria
• 描述：更新远程配置的用户标识符条件。此更改将应用于生产和开发环境。
• 参数：
  • remoteConfigId：远程配置的 ID。
  • body：请求正文。
    • userIdentifierCriteria：用于定向的用户标识符条件。你可以使用 Hackle 提供的条件（$deviceId、$userId），也可以使用在 Hackle 仪表板网站上创建的自定义条件。（默认值：'$deviceId'）

远程配置描述更新工具

• 名称：remote-config-update-description
• 描述：更新远程配置的描述。此更改将应用于生产和开发环境。
• 参数：
  • remoteConfigId：远程配置的 ID。
  • body：请求正文。
    • description：远程配置的描述。

安装

将此条目添加到 claude_desktop_config.json：

• Mac：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json
• 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"
      }
    }
  }
}

如果 Claude 正在运行，请重新启动

获取 API 密钥

要使用 Hackle MCP Server，你需要 API 密钥。获取 API 密钥的步骤如下：

1. 通过 Hackle Slack Community 直接联系 Hackle 团队
2. 申请用于访问 MCP Server 的 API 密钥
3. Hackle 团队会向你提供一个唯一的 API 密钥

重要：切勿分享 API 密钥，也不要将其提交到公开代码仓库。请将 API 密钥视为敏感凭据。

许可证

MIT