Skip to main content
Glama

clevertap-mcp

CleverTap REST API用のModel Context Protocol (MCP)サーバーです。CleverTapのユーザープロファイル、イベント、キャンペーン、レポートを、MCP互換のAIアシスタント(Claude、Cursorなど)が直接呼び出せるツールとして公開します。


機能

  • マルチプロジェクト — 単一のサーバーインスタンスから複数のCleverTapアカウントを管理

  • ガイド付きセットアップ — プロジェクトが設定されていない場合、clevertap_configureがプロセスを案内

  • 完全なAPIカバレッジ — イベント、プロファイル、キャンペーン、レポート

  • 非同期ポーリング — 長時間実行される操作(イベント/プロファイルのカウント)は自動的にポーリング


ツール

メタ

ツール

説明

clevertap_configure

プロジェクトの追加やCLEVERTAP_PROJECTS設定の生成を行うガイド付きセットアップ

clevertap_list_projects

設定済みの全プロジェクトとそのリージョンを一覧表示

イベント

ツール

説明

clevertap_upload_events

ユーザーのイベントを1つ以上アップロード

clevertap_get_events

フィルターを使用してイベントデータをクエリ

clevertap_get_events_cursor

カーソルを使用してイベント結果の次のページを取得

clevertap_get_event_count

イベントの合計数を取得(非同期ポーリングを使用)

プロファイル

ツール

説明

clevertap_upload_profiles

ユーザープロファイルの作成または更新

clevertap_get_profile

ID、メールアドレス、またはobjectIdで単一のユーザーを検索

clevertap_get_profiles_by_event

特定のイベントを実行したユーザーのプロファイルを取得

clevertap_get_profiles_cursor

カーソルを使用してプロファイル結果の次のページを取得

clevertap_delete_profile

ユーザープロファイルを削除

clevertap_upload_device_token

ユーザーのプッシュトークンを登録

clevertap_get_profile_count

セグメントに一致するプロファイルをカウント

clevertap_demerge_profiles

マージされたプロファイルを分割

clevertap_subscribe

ユーザーのチャネル購読/購読解除

clevertap_disassociate_phone

プロファイルから電話番号を削除

キャンペーン

ツール

説明

clevertap_get_campaigns

指定期間内のキャンペーンを一覧表示

clevertap_get_campaign_report

キャンペーンの配信およびエンゲージメント統計を取得

clevertap_stop_campaign

実行中のキャンペーンを停止

clevertap_create_campaign

キャンペーンを作成して開始

レポート

ツール

説明

clevertap_get_message_report

メッセージレベルの配信レポート

clevertap_get_top_property_count

イベントのプロパティ値のカウント上位を取得

clevertap_get_event_trend

イベントの日次/週次/月次トレンド

clevertap_get_dau

デイリーアクティブユーザー(DAU)のトレンド

clevertap_get_uninstall_report

アンインストールトレンドレポート

clevertap_get_real_time_counts

リアルタイムのアクティブユーザー数

汎用

ツール

説明

clevertap_request

任意の生のREST APIリクエストを実行

clevertap_poll

req_idを使用して保留中の非同期リクエストをポーリング

Web / ブラウザ

ツール

説明

clevertap_web_login

Chromiumウィンドウを開き、手動ログイン後にダッシュボードのセッションCookieとCSRFトークンをキャプチャ(SSOおよび2FAをサポート)

clevertap_web_session_status

プロジェクトのWebセッションがキャプチャされているか、いつ取得されたかを確認

clevertap_web_request

キャプチャしたセッションを使用して、CleverTapダッシュボードの任意のエンドポイントへ認証済みリクエストを実行

clevertap_get_campaigns_ui

ダッシュボードUI APIからキャンペーンを一覧表示 — REST APIよりも豊富なデータ(ステータス、送信数、インプレッション、クリック、編集URL)

clevertap_send_test_push

特定のデバイストークンにテストプッシュ通知を送信。clevertap_get_profileから取得したプッシュトークン(platformInfo[].push_token)、ターゲットプラットフォーム(ios/android)、プッシュチャネル名、およびオプションのディープリンクURLを受け取ります。

Webツールの前提条件: npm installの後に、Playwright Chromiumバイナリを一度インストールしてください:

npx playwright install chromium

インストール

git clone https://github.com/your-org/clevertap-mcp.git
cd clevertap-mcp
npm install
npx playwright install chromium   # required for web/browser tools
npm run build

設定

サーバーはCLEVERTAP_PROJECTS環境変数からプロジェクトの認証情報を読み取ります。これはプロジェクトオブジェクトのJSON配列です:

[
  {
    "name": "My App - Production",
    "account_id": "XXX-XXX-XXXX",
    "passcode": "YYY-YYY-YYYY",
    "region": "us1"
  },
  {
    "name": "My App - Staging",
    "account_id": "AAA-AAA-AAAA",
    "passcode": "BBB-BBB-BBBB",
    "region": "us1"
  }
]

サポートされているリージョン: in1, us1, eu1, sg1, aps3, mec1

単一プロジェクトのフォールバック

単一プロジェクトの場合は、個別の環境変数を使用することもできます:

CLEVERTAP_ACCOUNT_ID=XXX-XXX-XXXX
CLEVERTAP_PASSCODE=YYY-YYY-YYYY
CLEVERTAP_REGION=us1

Claude Desktopへの追加

claude_desktop_config.json(または~/.claude.json)に以下を記述します:

{
  "mcpServers": {
    "clevertap": {
      "command": "node",
      "args": ["/absolute/path/to/clevertap-mcp/dist/index.js"],
      "env": {
        "CLEVERTAP_PROJECTS": "[{\"name\":\"My App\",\"account_id\":\"XXX-XXX-XXXX\",\"passcode\":\"YYY-YYY-YYYY\",\"region\":\"us1\"}]"
      }
    }
  }
}

重要: CLEVERTAP_PROJECTSは、envブロック内で(ネイティブのJSONオブジェクトではなく)シリアライズされたJSON文字列である必要があります。


開発

npm run build      # compile TypeScript → dist/
npm run dev        # watch mode
npm start          # run compiled server

プロジェクト構造

src/
  index.ts          # MCP server entry point, project config, tool registration
  client.ts         # CleverTap REST API HTTP client
  tools/
    events.ts       # Event upload and query tools
    profiles.ts     # Profile management tools
    campaigns.ts    # Campaign tools
    reports.ts      # Analytics and report tools
    generic.ts      # Raw request / poll tools
    web.ts          # Browser session tools via Playwright (login, campaigns UI, test push)

ライセンス

MIT

Install Server
A
security – no known vulnerabilities
F
license - not found
A
quality - A tier

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/ralphcorleone/clevertap-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server