ictpbx-mcp

ictpbx-mcp

ICT Innovations の ICTCore フレームワーク上に構築された、マルチテナント対応のホワイトラベル IP-PBX である ICTPBX 向けの Model Context Protocol サーバーです。

ICTCore REST API を介して、AI アシスタントが内線番号、DID 番号、SIP トランクプロバイダー、テナント、リアルタイム統計などの PBX の状態を読み取れるようにします。読み取り専用で、通話の発信や設定の変更は行いません。

インストール

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

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

設定

変数	必須	デフォルト
ICTPBX_BASE_URL	はい		ICTCore REST のベース URL。通常は /api で終わります。例：https://your-ictpbx/api
ICTPBX_USERNAME	はい		API アカウントのメールアドレス（ICTCore はメールアドレスでログインします）
ICTPBX_PASSWORD	はい		そのアカウントのパスワード
ICTPBX_TIMEOUT_MS	いいえ	30000	リクエストごとのタイムアウト
ICTPBX_TLS_INSECURE	いいえ	false	TLS 検証をスキップします。自己署名のテストサーバーでのみ使用してください

Claude Desktop の例

{
  "mcpServers": {
    "ictpbx": {
      "command": "npx",
      "args": ["-y", "ictpbx-mcp"],
      "env": {
        "ICTPBX_BASE_URL": "https://your-ictpbx/api",
        "ICTPBX_USERNAME": "[email protected]",
        "ICTPBX_PASSWORD": "your-password"
      }
    }
  }
}

ツール

ツール	機能
ictpbx_pbx_statistics	内線、デバイス、リンググループ、キュー、IVR、ボイスメール、会議、ゲートウェイの数
ictpbx_list_extensions	ユーザー名、名前、テナントを含む SIP 内線
ictpbx_list_dids	DID（着信）番号、有効状態、テナント
ictpbx_list_providers	SIP トランクプロバイダー（上位通信事業者）
ictpbx_list_tenants	PBX 上のテナント（顧客組織）

接続方法

ICTPBX は ICTCore 上で動作します。ICTCore は POST /authenticate から取得した JWT で認証し、Authorization: Bearer ヘッダーからそのトークンを読み取ります。サーバーは初回使用時にトークンを取得し、自動的に更新します。

詳細

ICTPBX、ICTContact、ICTDialer、ICTFax、およびこれらの製品で共通して使用される ICTCore フレームワークを開発するチームである ICT Innovations の Tahir Almas が開発しました。詳しくは ictpbx.com をご覧ください。

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