clevertap-mcp
clevertap-mcp
CleverTap REST API用のModel Context Protocol (MCP)サーバーです。CleverTapのユーザープロファイル、イベント、キャンペーン、レポートを、MCP互換のAIアシスタント(Claude、Cursorなど)が直接呼び出せるツールとして公開します。
機能
マルチプロジェクト — 単一のサーバーインスタンスから複数のCleverTapアカウントを管理
ガイド付きセットアップ — プロジェクトが設定されていない場合、
clevertap_configureがプロセスを案内完全なAPIカバレッジ — イベント、プロファイル、キャンペーン、レポート
非同期ポーリング — 長時間実行される操作(イベント/プロファイルのカウント)は自動的にポーリング
ツール
メタ
ツール | 説明 |
| プロジェクトの追加や |
| 設定済みの全プロジェクトとそのリージョンを一覧表示 |
イベント
ツール | 説明 |
| ユーザーのイベントを1つ以上アップロード |
| フィルターを使用してイベントデータをクエリ |
| カーソルを使用してイベント結果の次のページを取得 |
| イベントの合計数を取得(非同期ポーリングを使用) |
プロファイル
ツール | 説明 |
| ユーザープロファイルの作成または更新 |
| ID、メールアドレス、またはobjectIdで単一のユーザーを検索 |
| 特定のイベントを実行したユーザーのプロファイルを取得 |
| カーソルを使用してプロファイル結果の次のページを取得 |
| ユーザープロファイルを削除 |
| ユーザーのプッシュトークンを登録 |
| セグメントに一致するプロファイルをカウント |
| マージされたプロファイルを分割 |
| ユーザーのチャネル購読/購読解除 |
| プロファイルから電話番号を削除 |
キャンペーン
ツール | 説明 |
| 指定期間内のキャンペーンを一覧表示 |
| キャンペーンの配信およびエンゲージメント統計を取得 |
| 実行中のキャンペーンを停止 |
| キャンペーンを作成して開始 |
レポート
ツール | 説明 |
| メッセージレベルの配信レポート |
| イベントのプロパティ値のカウント上位を取得 |
| イベントの日次/週次/月次トレンド |
| デイリーアクティブユーザー(DAU)のトレンド |
| アンインストールトレンドレポート |
| リアルタイムのアクティブユーザー数 |
汎用
ツール | 説明 |
| 任意の生のREST APIリクエストを実行 |
|
|
Web / ブラウザ
ツール | 説明 |
| Chromiumウィンドウを開き、手動ログイン後にダッシュボードのセッションCookieとCSRFトークンをキャプチャ(SSOおよび2FAをサポート) |
| プロジェクトのWebセッションがキャプチャされているか、いつ取得されたかを確認 |
| キャプチャしたセッションを使用して、CleverTapダッシュボードの任意のエンドポイントへ認証済みリクエストを実行 |
| ダッシュボードUI APIからキャンペーンを一覧表示 — REST APIよりも豊富なデータ(ステータス、送信数、インプレッション、クリック、編集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=us1Claude 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
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Tools
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