ictdialer-mcp

ictdialer-mcp

ICT Innovationsが提供するクラウド型自動ダイヤラーおよびプレディクティブダイヤラー プラットフォーム、ICTDialer 向けの Model Context Protocol サーバーです。ICTDialer.comはICTContactの ホステッド版で、同じエンジンを使用しているため、このサーバーは同じAPIに接続します。

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

インストール

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

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

設定

変数	必須	デフォルト
ICTDIALER_BASE_URL	はい		/restサフィックスを除いたサーバーのベースURL。例：https://your-ictdialer
ICTDIALER_USERNAME	はい		APIアカウントのユーザー名
ICTDIALER_PASSWORD	はい		アカウントのパスワード
ICTDIALER_MCP_ALLOW_WRITE	いいえ	false	キャンペーンの開始／停止を有効化します（「安全性」を参照）
ICTDIALER_TIMEOUT_MS	いいえ	30000	リクエストごとのタイムアウト
ICTDIALER_TLS_INSECURE	いいえ	false	TLS検証をスキップします — 自己署名のテストサーバーのみ

Claude Desktopの設定例

{
  "mcpServers": {
    "ictdialer": {
      "command": "npx",
      "args": ["-y", "ictdialer-mcp"],
      "env": {
        "ICTDIALER_BASE_URL": "https://your-ictdialer",
        "ICTDIALER_USERNAME": "admin",
        "ICTDIALER_PASSWORD": "your-password"
      }
    }
  }
}

ツール

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

ツール	説明
ictdialer_list_campaigns	キャンペーンの一覧（IDと名前）を取得します
ictdialer_campaign_status	キャンペーンの現在のステータス（実行中、停止）を取得します
ictdialer_campaign_summary	件数の概要：応答済み、失敗、人間と機械の内訳
ictdialer_campaign_result	通話ごとの結果（連絡先、応答、AMD、DNC）を取得します

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

ツール	説明
ictdialer_start_campaign	キャンペーンを開始します — アウトバウンドへの実際の発信を開始します
ictdialer_stop_campaign	実行中のキャンペーンを停止します

安全性

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

接続方法

ICTDialerは{base}/rest/<Method>でフォームエンコードされたRPC APIを公開しています。各呼び出しには アカウントのユーザー名とパスワードが必要で、サーバーが代わりに送信します。別途プロビジョニングする トークンはありません。

概要

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

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