ictcrm-mcp

ictcrm-mcp

ICT Innovations の ICTCRM 用 Model Context Protocol サーバーです。

ictcrm.com は ICTContact バックエンド上で動作するため、このサーバーはその RPC インターフェイスと通信します。 AI アシスタントで連絡先グループを読み取れます。また、書き込みを有効にした場合に限り、連絡先の作成と削除、連絡先のキャンペーンへの追加ができます。

インストール

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

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

設定

変数	必須	デフォルト
ICTCRM_BASE_URL	はい		/rest のサフィックスを除いたサーバーのベース URL。例：https://your-ictcrm
ICTCRM_USERNAME	はい		API アカウントのユーザー名
ICTCRM_PASSWORD	はい		アカウントのパスワード
ICTCRM_MCP_ALLOW_WRITE	いいえ	false	連絡先の書き込みツールを有効にします（「安全性」を参照）
ICTCRM_TIMEOUT_MS	いいえ	30000	リクエストごとのタイムアウト
ICTCRM_TLS_INSECURE	いいえ	false	TLS 検証をスキップします — 自己署名のテストサーバーでのみ使用してください

Claude Desktop の設定例

{
  "mcpServers": {
    "ictcrm": {
      "command": "npx",
      "args": ["-y", "ictcrm-mcp"],
      "env": {
        "ICTCRM_BASE_URL": "https://your-ictcrm",
        "ICTCRM_USERNAME": "admin",
        "ICTCRM_PASSWORD": "your-password"
      }
    }
  }
}

ツール

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

ツール	機能
ictcrm_list_contact_groups	連絡先グループ（ID、名前、説明）を一覧表示します

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

ツール	機能
ictcrm_create_contact	グループ内に連絡先を作成します。連絡先 ID を返します
ictcrm_delete_contact	ID を指定して連絡先を削除します
ictcrm_add_contact_to_campaign	連絡先を作成し、キャンペーンに追加します

安全性

このサーバーはデフォルトでは読み取り専用です。ICTCRM_MCP_ALLOW_WRITE=true を設定すると、連絡先を作成および削除できるようになります。

連絡先の一覧表示について

ICTCRM が利用する ICTContact バックエンドは、連絡先グループの取得と連絡先の作成・削除に対応していますが、「連絡先の一覧表示」メソッドはサーバー側でエラーになるため、このサーバーには連絡先一覧表示ツールがありません。連絡先の管理と連絡先グループの読み取りには対応していますが、現時点では API 経由で個々の連絡先を一覧表示できません。

接続方法

各リクエストにはアカウントのユーザー名とパスワードが含まれ、フォーム形式でエンコードされた RPC API の {base}/rest/<Method> に送信されます。別途発行が必要なトークンはありません。

概要

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

MIT ライセンスです。問題の報告やプルリクエストは github.com/ictinnovations/ictcrm-mcp までお寄せください。