ictbroadcast-mcp

ictbroadcast-mcp

Model Context Protocol サーバーです。 ICTBroadcast は、ICT Innovations が提供する音声、SMS、FAXの一斉配信およびコールセンタープラットフォームです。

AI アシスタントで発信キャンペーンを監視できます。キャンペーンの一覧表示、ステータスの確認、概要や通話ごとの結果の取得が可能です。また、書き込みを有効にした場合に限り、キャンペーンの開始と停止も行えます。

インストール

npx -y ictbroadcast-mcp      # no install
npm install -g ictbroadcast-mcp

Node.js 18 以降が必要です。

設定

変数	必須	デフォルト
ICTBROADCAST_BASE_URL	はい		/rest を除いたサーバーのベース URL。例：https://your-ictbroadcast
ICTBROADCAST_USERNAME	はい		API アカウントのユーザー名
ICTBROADCAST_PASSWORD	はい		そのアカウントのパスワード
ICTBROADCAST_MCP_ALLOW_WRITE	いいえ	false	キャンペーンの開始／停止を有効にします（「安全性」を参照）
ICTBROADCAST_TIMEOUT_MS	いいえ	30000	リクエストごとのタイムアウト
ICTBROADCAST_TLS_INSECURE	いいえ	false	TLS 検証をスキップします。自己署名のテストサーバーでのみ使用してください

Claude Desktop の設定例

{
  "mcpServers": {
    "ictbroadcast": {
      "command": "npx",
      "args": ["-y", "ictbroadcast-mcp"],
      "env": {
        "ICTBROADCAST_BASE_URL": "https://your-ictbroadcast",
        "ICTBROADCAST_USERNAME": "admin",
        "ICTBROADCAST_PASSWORD": "your-password"
      }
    }
  }
}

ツール

読み取りツールは常に利用できます。

ツール	機能
ictbroadcast_list_campaigns	キャンペーンの一覧表示（ID と名前）
ictbroadcast_campaign_status	キャンペーンのリアルタイムステータス（実行中、停止）
ictbroadcast_campaign_summary	合計：応答あり、失敗、人間と機械の内訳
ictbroadcast_campaign_result	通話ごとの結果（連絡先、応答、AMD、DNC）

書き込みツールは、ICTBROADCAST_MCP_ALLOW_WRITE=true の場合にのみ表示されます。

ツール	機能
ictbroadcast_start_campaign	キャンペーンを開始します。発信が開始されます
ictbroadcast_stop_campaign	実行中のキャンペーンを停止します

安全性

このサーバーは、デフォルトでは読み取り専用です。キャンペーンを開始すると発信が開始され、実際の費用が発生する可能性があります。そのため、ICTBROADCAST_MCP_ALLOW_WRITE=true を設定しない限り、ictbroadcast_start_campaign と ictbroadcast_stop_campaign は登録されません。

接続方法

ICTBroadcast は、{base}/rest/<Method> でフォーム形式の RPC API を公開しています。各呼び出しにはアカウントのユーザー名とパスワードが必要です。サーバーがそれらを代わりに送信します。別途用意するトークンはありません。（ICTBroadcast REST API は、Service Provider エディションに同梱されています。）

概要

ICTBroadcast、ICTContact、ICTDialer、ICTFax、ICTPBXを手がけるチーム、ICT Innovations の Tahir Almas が開発しました。詳しくはictbroadcast.comをご覧ください。

MIT ライセンスです。github.com/ictinnovations/ictbroadcast-mcp で Issue や PR を歓迎します。