Hackle

Hackle MCP Server

警告

⚠️ このローカル npm パッケージは非推奨です — リモート MCP サーバーをご利用ください

Hackle MCP サーバーはリモートサーバーとして利用可能になりました。このローカル npm パッケージは非推奨です。リモートサーバーは npm や Node.js のセットアップが不要で、自動更新され、ブラウザーで動作します。また、メッセージ統計や Kakao／テキストメッセージのクエリなど、新しいツールはすべてこちらで提供されます。

このパッケージに今後、更新や新しいツールが追加されることはありません。 既存のインストールは当面そのまま動作しますが、リモートサーバーへの移行をお願いします。

👉 移行ガイド：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 キーを入力します。API キーはそのまま変更されません。

3. 接続後、必要に応じて claude_desktop_config.json からローカルサーバーのエントリーを削除できます。

A/B テストデータをクエリするためのツールとリソースを提供する、Hackle API 用の Model Context Protocol サーバーです。

機能

ツール

実験リストツール

• 名前: experiment-list
• 説明: 検索機能付きで、A/B テストの実験一覧をページ単位で取得します。
• パラメーター:
  • pageNumber: ページ番号（デフォルト: 1）
  • pageSize: 1 ページあたりの項目数（デフォルト: 100）
  • searchKeyword: 検索キーワード（任意）

実験詳細ツール

• 名前: experiment-detail
• 説明: 特定の A/B テスト実験の詳細情報を取得します。
• パラメーター:
  • experimentId: 実験 ID

アプリ内メッセージリストツール

• 名前: in-app-message-list
• 説明: 検索機能付きで、アプリ内メッセージの一覧をページ単位で取得します。
• パラメーター:
  • pageNumber: ページ番号（デフォルト: 1）
  • pageSize: 1 ページあたりの項目数（デフォルト: 100）
  • searchKeyword: 検索キーワード（任意）

アプリ内メッセージ詳細ツール

• 名前: in-app-message-detail
• 説明: 特定のアプリ内メッセージの詳細情報を取得します。
• パラメーター:
  • inAppMessageId: アプリ内メッセージ ID

プッシュメッセージリストツール

• 名前: push-message-list
• 説明: 検索機能付きで、プッシュメッセージの一覧をページ単位で取得します。
• パラメーター:
  • pageNumber: ページ番号（デフォルト: 1）
  • pageSize: 1 ページあたりの項目数（デフォルト: 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
• 説明: 1件のデータレポートの詳細を取得します。データレポート内の分析チャートの ID とタイプが含まれます。各チャートの詳細情報をさらに取得するには、分析チャート詳細ツールの使用をおすすめします。
• パラメーター:
  • dataReportId: データレポートの ID です。データレポート一覧ツールのレスポンスで確認できます。

分析チャート一覧ツール

• 名前: analytics-chart-list
• 説明: データ分析チャートのメタデータ一覧を取得します。
• パラメーター:
  • pageNumber: ページ番号（デフォルト：1）（任意）
  • pageSize: 1ページあたりの項目数（デフォルト：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: 1ページあたりの項目数（デフォルト：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: type が HACKLE_PROPERTY または USER_PROPERTY の場合はプロパティ名、AB_TEST の場合は実験キー、FEATURE_FLAG の場合は機能フラグキーです。type が COHORT または SEGMENT の場合は、空でない任意の文字列を指定できます。
          • match
            • operator: 条件のキーと値の照合に使用する演算子。
            • valueType: ターゲティング条件の値の型：NUMBER、STRING、BOOLEAN、VERSION。
            • values: ターゲティング条件のキーの値。次の特別なケースがあります。SEGMENT を使用する場合、値は名前として扱われます。AB_TEST の場合、文字列「A」と「B」のみ指定できます。FEATURE_FLAG の場合、ブール値のみ指定できます。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 サーバーを使用するには、API キーが必要です。API キーを取得するには、次の手順に従ってください。

1. Hackle Slack Community から Hackle チームに直接お問い合わせください。
2. MCP サーバーへのアクセスに必要な API キーをリクエストしてください。
3. Hackle チームから専用の API キーが提供されます。

重要：API キーを共有したり、公開リポジトリにコミットしたりしないでください。API キーは機密性の高い認証情報として取り扱ってください。

ライセンス

MIT