JetAPI

JetAPI MCP サーバー

JetAPI 公式の MCP サーバーです。Claude、Cursor、VS Code などの AI エージェントから、WhatsApp、Telegram、SMS、MAX のメッセージやファイルの送信、一括配信を実行できます。

ツール

ツール	説明
get_account	アカウントの全情報：残高、配信ルーティング、送信者名、サブスクリプション、WhatsApp／Telegram のセッション状態（トークンはマスクされます）
get_balance	残高、顧客 ID、配信ルーティングのチャネル、登録済み送信者名
get_utm_tags	配信の追跡に使用する UTM タグの一覧
send_message	WhatsApp、Telegram（tdlib）、Telegram Bot、SMS、VK／OK、MAX でテキストを送信します。カスケード、予約送信、優先度、返信先、コールバックに対応しています
send_bulk	同じメッセージを複数の電話番号に一括送信します
get_delivery_status	配信のステータスと詳細を、わかりやすい言葉で説明します
delete_delivery	受信者すべてのデバイスから、配信済みの WhatsApp／Telegram メッセージを削除します
get_phone_info	電話番号の国、通信事業者、正規化された形式
send_file	ローカルパス、URL、または base64 からドキュメント、画像、音声、動画を送信します（最大 100 MB）
create_webhook	URL をイベントに登録します：受信メッセージ、WhatsApp のステータス、ログイン／ログアウト
get_webhook	1 件の webhook の詳細
list_webhooks	登録済み webhook の一覧
delete_webhook	webhook を削除します
update_webhook	webhook の URL および／またはイベントタイプを変更します

トークンの取得

jetapi.io に登録し、ダッシュボードから API トークンをコピーしてください。WhatsApp または Telegram 経由で送信するには、先にダッシュボードでメッセンジャーを接続してください。

インストール

Claude Desktop — ワンクリック

1. 最新リリースから jetapi-mcp-server.mcpb をダウンロードします。
2. ダブルクリックします（または Claude Desktop → Settings → Extensions にドラッグします）。
3. 求められたら JetAPI トークンを貼り付けます。トークンは Claude Desktop によって安全に保存されます。

Claude Desktop — 設定ファイル

Node.js 18.17 以降が必要です。Settings → Developer → Edit Config（claude_desktop_config.json）を開き、以下を追加します。

{
  "mcpServers": {
    "jetapi": {
      "command": "npx",
      "args": ["-y", "jetapi-mcp-server"],
      "env": { "JETAPI_TOKEN": "your_token_here" }
    }
  }
}

Claude Desktop を再起動します。

Claude Code

claude mcp add jetapi -- npx -y jetapi-mcp-server

サーバーには JETAPI_TOKEN が必要なため、追加時に渡します。

claude mcp add jetapi --env JETAPI_TOKEN=your_token_here -- npx -y jetapi-mcp-server

Cursor

~/.cursor/mcp.json（またはプロジェクト内の .cursor/mcp.json）に追加します。

{
  "mcpServers": {
    "jetapi": {
      "command": "npx",
      "args": ["-y", "jetapi-mcp-server"],
      "env": { "JETAPI_TOKEN": "your_token_here" }
    }
  }
}

VS Code

.vscode/mcp.json に追加します。VS Code がトークンの入力を求め、ファイルには保存しません。

{
  "inputs": [
    { "type": "promptString", "id": "jetapi_token", "description": "JetAPI token", "password": true }
  ],
  "servers": {
    "jetapi": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "jetapi-mcp-server"],
      "env": { "JETAPI_TOKEN": "${input:jetapi_token}" }
    }
  }
}

MCP Registry

このサーバーは、io.github.jetapi/jetapi-mcp-server として公式 MCP Registryに登録されているため、レジストリを参照するクライアントやカタログから直接インストールできます。

その他の MCP クライアント

stdio サーバーに対応する任意のクライアントで利用できます。

{
  "command": "npx",
  "args": ["-y", "jetapi-mcp-server"],
  "env": { "JETAPI_TOKEN": "your_token_here" }
}

設定

変数	必須	デフォルト	説明
JETAPI_TOKEN	はい	—	JetAPI ダッシュボードで取得した Bearer トークン
JETAPI_BASE_URL	いいえ	https://api.jetapi.io	API ホスト
JETAPI_DEBUG	いいえ	0	1 にすると、すべてのリクエストを stderr に記録します

チャネル

dispatch_routing はチャネルの順序付きリストです。JetAPI はチャネルを順番に試し、前のチャネルでの配信に失敗した場合にのみ次のチャネルに進みます。指定しない場合は、JetAPI ダッシュボードのデフォルトのルーティングが使用されます。

値	チャネル	宛先
whatsapp	WhatsApp	phone または whatsapp_lid
tdlib	個人の Telegram アカウント	phone、username または tdlib_user_id（負の ID はグループチャット）
telegram	Telegram Bot	phone
sms	SMS	phone
notify	VK / OK 通知	phone
max	MAX メッセンジャー	phone

使用例

Claude に自然な言葉で尋ねます。

言い方	ツール
「JetAPI アカウントを表示して — WhatsApp は接続されていますか？」	get_account
「JetAPI の残高はいくらですか？」	get_balance
「どの UTM タグを持っていますか？」	get_utm_tags
「+7 999 123-45-67 に WhatsApp メッセージを送信して：ご注文の商品を発送しました。」	send_message
「Telegram の @john_doe に、会議が午後3時に変更になったと伝えて。」	send_message (tdlib)
「まず WhatsApp を試し、それから SMS：コードは 4821 です。」	send_message (cascade)
「79991234567 に、明日の 09:00 UTC に予約についてリマインドして。」	send_message (scheduled)
「79991234567、79997654321、995598464533 に『セールは本日開始！』を送信して。」	send_bulk
「メッセージ 94396942 は配信されましたか？」	get_delivery_status
「メッセージ 94396942 を削除して。」	delete_delivery
「+995 598 464 533 の通信事業者はどこですか？」	get_phone_info
「~/Documents/invoice.pdf を WhatsApp で 79991234567 に送信して。」	send_file
「受信した WhatsApp メッセージを https://example.com/hook に送信して。」	create_webhook
「Webhook 57 を表示して。」	get_webhook
「自分の Webhook を一覧表示して。」	list_webhooks
「Webhook 57 を削除して。」	delete_webhook
「Webhook 57 の送信先を https://example.com/new-hook に変更して。」	update_webhook

動作

• JetAPI API が想定するように、パラメーターは URL クエリパラメーターとして送信されます。send_file はファイルを multipart/form-data としてアップロードします。
• 使用できないパラメーター（例：tdlib チャネルを指定せずに Telegram の username を指定する場合や、過去の日時を scheduled_at に指定する場合）は、リクエストを送信する前に拒否されます。
• HTTP 429 は Retry-After に従い、指数バックオフを用いて最大3回再試行されます。
• 5xx の応答は1秒後に2回再試行されます。ただし、メッセージの送信や Webhook の作成を行うリクエスト（send_message、send_bulk、send_file、create_webhook）は除きます。これにより、同じ内容が二重に送信されることを防ぎます。
• リクエストは30秒でタイムアウトします。
• エラーは読みやすいツールエラーとして返されます。例：Invalid JetAPI token. Check your JETAPI_TOKEN. または Validation error: text: the text cannot be empty。
• すべてのログは stderr に出力されます。stdout は MCP プロトコル専用です。

開発

git clone https://github.com/jetapi/jetapi-mcp-server.git
cd jetapi-mcp-server
npm install
cp .env.example .env   # put your token in .env
npm run build
npm start

スクリプト	内容
npm run dev	TypeScript のソースを直接実行します
npm run inspector	すべてのツールを含む MCP Inspector を起動します
npm run check	package.json／server.json／manifest.json のバージョンと、サーバーが14個すべてのツールを公開していることを確認します
npm run build:mcpb	Claude Desktop 拡張機能を build/jetapi-mcp-server.mcpb にビルドします

リリース

1. package.json、server.json（両方の version フィールド）、manifest.json のバージョンを更新し、CHANGELOG.md にエントリーを追加します。
2. main にマージしてから、タグをプッシュします：git tag v1.2.3 && git push origin v1.2.3。
3. リリースワークフロー により、npm への公開（provenance による信頼された公開）、.mcpb バンドルを含む GitHub リリースの作成、MCP Registry の更新が行われます。

プライバシーポリシー

この拡張機能はローカルで実行され、分析データやテレメトリを収集しません。また、リクエストされた操作を実行するために、データを JetAPI API にのみ送信します。API トークンは MCP クライアントによって保存されます（Claude Desktop では安全なストレージに保存されます）。

• JetAPI MCP Server のプライバシーポリシー — 拡張機能が取り扱い、保存、共有する情報
• JETAPI LLC のプライバシーポリシー — JetAPI サービスによる個人データの処理方法

お問い合わせ：[email protected]

ライセンス

MIT