ChatPush MCPサーバー
コミット 2026年11月2日AIエージェントによるWhatsApp、Telegram、SMS、VK/OK、MAXへのメッセージ、ファイル、および一括メール送信を可能にします。
別名 ChatPush/mcp-chatpush
- スター
- 0
- ツール
- 11
- ダウンロード数(30日間)
- —
- 最新バージョン
- —
- 最終コミット
- 2026年11月2日
- ライセンス
- MIT
ChatPush MCPとは
AIエージェントによるWhatsApp、Telegram、SMS、VK/OK、MAXへのメッセージ、ファイル、および一括メール送信を可能にします。 11個のツールを提供しており、get_account, get_balance, get_utm_tagsなどがあります。
プロジェクトのREADMEから生成された概要
ChatPush MCP server について
mcp-chatpushは、AIエージェント内から複数の通信チャネルにわたってメッセージを送信することを可能にします。開発者はこのMCP serverを使用することで、WhatsApp、Telegram、SMS、VK/OK、およびMAXを介してテキスト、ファイル、一括メールを配信できます。予約配信、優先設定、および最初の試行が失敗した場合の異なるチャネルへのカスケード処理を含む、複雑なメッセージングワークフローをサポートしています。
ユーザーは、環境に応じてこのサーバーを2つの異なる方法で実行できます。Claude Desktop、Claude Code、Cursor、またはVS Codeを使用したローカル開発では、CHATPUSH_TOKENを使用してstdio経由で動作します。URL接続を必要とするYandexなどのプラットフォーム向けには、streamable HTTPを使用したリモートモードを提供します。リモート設定では、呼び出し側がAuthorizationヘッダーに独自のトークンを提供するため、ホストされたインスタンスはステートレスかつ安全に保たれます。
ツールセットには、アカウント残高の管理、配信ステータスの確認、および最大100 MBのファイル転送を処理する機能が含まれています。また、QRコードリンクを介したメッセンジャー接続の管理や、サブカスタマーを使用したマルチアカウント構成の整理も可能です。
できること
- 1自動マルチチャネル通知WhatsApp経由でメッセージを送信し、失敗した場合はSMSにフォールバックするようにAIに指示します。
- 2予約アポイントメントリマインダー特定の日時にメッセージを送信するようエージェントにスケジュールさせます。
- 3チャット経由のファイル配布ローカルパスまたはURLを使用して、AIにドキュメントや画像を送信させます。
- 4メッセンジャーアカウントの接続QRコードを介して個人のWhatsAppまたはTelegramアカウントを接続するためのリンクを生成します。
- 5一括メッセージングキャンペーン大量の電話番号リストに対して、単一のメッセージを送信するようエージェントに命じます。
プロジェクトの README から作成されています。すべてのユースケースは、その引用と照らし合わせて確認されています。
ChatPush MCPツール 11
READMEから検出get_accountget_balanceget_utm_tagssend_messagesend_bulksend_fileget_delivery_statusdelete_deliveryget_phone_infoset_chat_client_nameget_messenger_auth_link
| get_account | — | |
| get_balance | — | |
| get_utm_tags | — | |
| send_message | — | |
| send_bulk | — | |
| send_file | — | |
| get_delivery_status | — | |
| delete_delivery | — | |
| get_phone_info | — | |
| set_chat_client_name | — | |
| get_messenger_auth_link | — |
設定
CHATPUSH_TOKEN
| 名前 | 説明 | 種類 |
|---|---|---|
| CHATPUSH_TOKEN | — |
自動チェック
実行日 2026年11月14日完全なレポート →まだ検証されていません。サーバーには80点のスコア、重大な問題がないこと、および検証に必要な十分なデータが必要です。 チェックの仕組み · 点数を上げるための改善点
- ソースリポジトリがリンクされており、アクセス可能chatpush/mcp-chatpush is public and reachablegithub.com/chatpush/mcp-chatpush ↗合格
- パッケージがこのリポジトリをソースとして指定未チェック
- ビルドの来歴 (Sigstore 証明)未チェック
- オープンソースライセンス (OSI)MITspdx.org/licenses/MIT.html ↗合格
- 過去1年以内にコミットまたはリリースありLast commit or release 2026-11-02github.com/chatpush/mcp-chatpush ↗合格
- OpenSSF Scorecard未チェック
- パッケージ名が有名なパッケージに酷似していない未チェック
- パッケージおよびその依存関係に重大な勧告なし未チェック
- モデルへの隠れた指示がない11 tool descriptions and the README read; no override phrases, credential paths or hidden characters合格
- 破壊的なツールがラベル付けされている未チェック
- リモートエンドポイントが MCP ハンドシェイクに応答未チェック
README
GitHubで見るChatPush MCP Server
Official MCP server for ChatPush — send WhatsApp, Telegram, SMS, VK/OK and MAX messages, files and bulk mailings from AI agents.
It runs in two modes from the same codebase:
| Mode | Transport | Who it is for | Token |
|---|---|---|---|
| Remote | Streamable HTTP, hosted at https://mcp.chatpush.ru/mcp |
Yandex and other platforms that connect to a URL; users with no local Node.js | Each caller sends their own token in the Authorization header |
| Local | stdio, npx -y chatpush-mcp-server |
Claude Desktop, Claude Code, Cursor, VS Code | CHATPUSH_TOKEN in the client config |
Tools
| Tool | Description |
|---|---|
get_account |
Full account info: balance, dispatch routing, sender names, subscription, WhatsApp/Telegram session status |
get_balance |
Balance, customer ID, dispatch routing channels and registered sender names |
get_utm_tags |
UTM tags used to track dispatches |
send_message |
Send a text via WhatsApp, Telegram (tdlib), Telegram Bot, SMS, VK/OK or MAX — with cascade, scheduling, priority and reply-to |
send_bulk |
Send the same message to many phone numbers at once |
send_file |
Send a document, image, audio or video from a local path, URL or base64 (up to 100 MB) |
get_delivery_status |
Status and details of a delivery, explained in plain words |
delete_delivery |
Delete a delivered WhatsApp/Telegram message on all recipient devices |
get_phone_info |
Country, operator and normalized format of a phone number |
create_webhook · get_webhook · list_webhooks · update_webhook · delete_webhook |
Subscribe your backend to incoming messages, delivery statuses and login events |
set_chat_client_name |
Rename a contact in the ChatPush web messenger |
get_messenger_auth_link |
Link to the QR page that connects WhatsApp or a personal Telegram account |
create_sub_customer · list_sub_customers · get_sub_customer |
Multi-account: create and inspect sub-clients, each with its own token |
Get a token
Sign up at chatpush.ru and copy the API token from the dashboard. To send through WhatsApp or Telegram, connect the messenger in the dashboard first — or call get_messenger_auth_link and scan the QR code.
Remote mode (hosted)
The hosted server exposes one MCP endpoint:
POST https://mcp.chatpush.ru/mcp
Authorization: Bearer <ChatPush API token>
- Transport: Streamable HTTP (MCP protocol 2025-06-18), JSON responses enabled.
- Stateless: a fresh server instance per request, so it scales horizontally behind any proxy.
- No credentials on the server: the token is read from the request header and used only for that request. Nothing is stored or logged.
GET /healthzreturns{"status":"ok",...}without a token, for load-balancer checks.
Connecting from a client that supports remote MCP servers:
{
"url": "https://mcp.chatpush.ru/mcp",
"headers": { "Authorization": "Bearer your_token_here" }
}
Deployment
docker build -t chatpush-mcp-server .
docker run -p 3000:3000 -e CHATPUSH_ALLOWED_HOSTS=mcp.chatpush.ru chatpush-mcp-server
Without Docker: npm ci && npm run build && npm run start:http.
Put TLS in front (nginx, Traefik, a cloud load balancer) and point mcp.chatpush.ru at it. The service needs no database, no disk and no secrets.
| Variable | Default | Description |
|---|---|---|
PORT |
3000 |
Port to listen on |
HOST |
0.0.0.0 |
Interface to bind |
CHATPUSH_MCP_PATH |
/mcp |
Path of the MCP endpoint |
CHATPUSH_BASE_URL |
https://api.chatpush.ru |
ChatPush API host |
CHATPUSH_ALLOWED_HOSTS |
— | Comma-separated Host values to accept, e.g. mcp.chatpush.ru. Set it in production: it blocks DNS-rebinding attacks |
CHATPUSH_ALLOWED_ORIGIN |
* |
Value for Access-Control-Allow-Origin |
CHATPUSH_DEBUG |
0 |
1 logs every request to stderr |
Local mode (stdio)
Requires Node.js 20 or newer.
Claude Desktop
Settings → Developer → Edit Config (claude_desktop_config.json):
{
"mcpServers": {
"chatpush": {
"command": "npx",
"args": ["-y", "chatpush-mcp-server"],
"env": { "CHATPUSH_TOKEN": "your_token_here" }
}
}
}
Claude Code
claude mcp add chatpush --env CHATPUSH_TOKEN=your_token_here -- npx -y chatpush-mcp-server
Cursor
Add the same mcpServers block to ~/.cursor/mcp.json.
VS Code
.vscode/mcp.json — VS Code asks for the token and keeps it out of the file:
{
"inputs": [
{ "type": "promptString", "id": "chatpush_token", "description": "ChatPush token", "password": true }
],
"servers": {
"chatpush": {
"type": "stdio",
"command": "npx",
"args": ["-y", "chatpush-mcp-server"],
"env": { "CHATPUSH_TOKEN": "${input:chatpush_token}" }
}
}
}
Channels
dispatch_routing is an ordered list of channels. ChatPush tries them one by one and moves to the next only if delivery through the previous one fails. Without it, the default routing from your dashboard is used.
| Value | Channel | Recipient |
|---|---|---|
whatsapp |
phone or whatsapp_lid |
|
tdlib |
Personal Telegram account | phone, username or tdlib_user_id (negative ID = group chat) |
telegram |
Telegram Bot | phone |
sms |
SMS | phone |
notify |
VK / OK notifications | phone |
max |
MAX messenger | phone |
Usage examples
| Say | Tool |
|---|---|
| "Send a WhatsApp message to +7 999 123-45-67: your order has shipped." | send_message |
| "Try WhatsApp first, then SMS: your code is 4821." | send_message (cascade) |
| "Remind 79991234567 tomorrow at 09:00 UTC about the appointment." | send_message (scheduled) |
| "Send invoice.pdf to 79991234567." | send_file |
| "Was message 94396942 delivered?" | get_delivery_status |
| "Connect my WhatsApp." | get_messenger_auth_link |
| "Create a sub-client called Acme." | create_sub_customer |
| "Rename the contact 79991234567 to Ivan from Acme." | set_chat_client_name |
Behaviour
- Parameters go in the URL query string, as the ChatPush API expects;
send_fileuploads the file asmultipart/form-data. - Incompatible parameters (a Telegram
usernamewithout thetdlibchannel,scheduled_atin the past) are rejected before any request is sent. - HTTP 429 is retried up to 3 times with exponential backoff, honouring
Retry-After; 5xx twice — except for requests that send messages, so nothing is sent twice. - Requests time out after 30 seconds.
- Errors come back as readable tool errors, e.g.
Invalid ChatPush token. Check your CHATPUSH_TOKEN. - All logs go to stderr; stdout carries the MCP protocol in stdio mode.
Development
npm install
cp .env.example .env # put your token in .env
npm run build
npm run dev # stdio
npm run dev:http # remote, http://localhost:3000/mcp
| Script | What it does |
|---|---|
npm run check |
Versions in sync across package.json / server.json / manifest.json and all 19 tools exposed |
npm run build:mcpb |
Build the Claude Desktop extension into build/chatpush-mcp-server.mcpb |
npm run inspector |
Open the MCP Inspector against the local server |
License
ChatPush MCPのよくある質問
ChatPush MCPが提供するツールは
11個のツールを提供しており、get_account, get_balance, get_utm_tags, send_message, send_bulkなどがあります。
WhatsAppやTelegramのアカウントはどうやって接続しますか?
ChatPushダッシュボードでメッセンジャーを接続するか、get_messenger_auth_linkツールを呼び出してQRコードをスキャンすることで接続できます。
ChatPush MCP server経由でファイルを送信できますか?
はい、ローカルパス、URL、またはbase64を使用して、最大100 MBまでのドキュメント、画像、音声、またはビデオファイルを送信できます。
あるチャネルでメッセージの配信に失敗した場合、どうなりますか?
カスケードルーティングを使用して、複数のチャネルを順番に試行できます。前のチャネルでの配信に失敗した場合のみ、サーバーは次のチャネルへ移行します。