ictcrm-mcp

ictcrm-mcp

一个用于 ICTCRM 的 模型上下文协议 服务，由 ICT Innovations 提供。

ictcrm.com 运行在 ICTContact 后端上，因此此服务使用该后端的 RPC 接口。 它允许 AI 助手读取联系人组；只有启用写入功能后，才能创建和删除联系人，以及将联系人添加到营销活动中。

安装

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

需要 Node.js 18 或更高版本。

配置

变量	必填	默认值
ICTCRM_BASE_URL	是		服务的基础 URL，不带 /rest 后缀，例如 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 列出单个联系人。

连接方式

调用会发送到 {base}/rest/<Method> 上的表单编码 RPC API，每次调用都会携带账户用户名和密码。无需单独配置令牌。

关于

由 Tahir Almas 在 ICT Innovations 开发——该团队还开发了 ICTCRM、ICTContact、ICTDialer、ICTBroadcast、ICTFax 和 ICTPBX。详情请访问 ictcrm.com。

采用 MIT 许可证。欢迎在 github.com/ictinnovations/ictcrm-mcp 提交问题和 PR。