ictcontact-mcp

ictcontact-mcp

ICT Innovations が提供する同じコンタクトセンターエンジン、ICTContact およびそのホステッド版 ICTDialer.com 用の Model Context Protocol サーバーです。

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

インストール

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

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

設定

変数	必須	デフォルト
ICTCONTACT_BASE_URL	はい		/rest サフィックスを含まないサーバーのベース URL。例：https://your-ictcontact
ICTCONTACT_USERNAME	はい		API アカウントのユーザー名
ICTCONTACT_PASSWORD	はい		アカウントのパスワード
ICTCONTACT_MCP_ALLOW_WRITE	いいえ	false	キャンペーンの開始・停止を有効化します（「安全性」を参照）
ICTCONTACT_TIMEOUT_MS	いいえ	30000	リクエストごとのタイムアウト
ICTCONTACT_TLS_INSECURE	いいえ	false	TLS 検証をスキップします（自己署名のテストサーバーでのみ使用）

Claude Desktop の設定例

{
  "mcpServers": {
    "ictcontact": {
      "command": "npx",
      "args": ["-y", "ictcontact-mcp"],
      "env": {
        "ICTCONTACT_BASE_URL": "https://your-ictcontact",
        "ICTCONTACT_USERNAME": "admin",
        "ICTCONTACT_PASSWORD": "your-password"
      }
    }
  }
}

ツール

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

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

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

ツール	機能
ictcontact_start_campaign	キャンペーンを開始します。ライブのアウトバウンド通話が始まります
ictcontact_stop_campaign	実行中のキャンペーンを停止します

安全性

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

接続方法

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

概要

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

MIT ライセンスです。github.com/ictinnovations/ictcontact-mcp で課題報告やプルリクエストを歓迎します。