Ictcrm Mcp

io.github.ictinnovations由 GitHub 账号 ictinnovations 发布v0.1.1更新于 Oct 26, 2026

Read CRM contact groups and manage contacts on ICTCRM (ICTContact backend).

已验证STDIO仅桌面沟通与协作商业与电商

概览

AI 生成的概览

面向 ICTCRM 的 MCP 服务器，可让助手列出 CRM 联系人分组，并在开启写入后创建、删除联系人及将其加入活动。

可以做什么
  • 列出 CRM 中的联系人分组及其 id、名称和描述
  • 在分组中创建联系人并返回联系人 id（仅写入模式）
  • 按 id 删除联系人（仅写入模式）
  • 创建联系人并将其加入某个活动（仅写入模式）
适用场景
当你使用 ICTCRM（ICTContact 后端）实例，并希望助手查询联系人分组，或在明确授权下新增、删除联系人并加入活动时适用。由于后端列出联系人的方法会报错，无法逐个列出联系人。
运行要求
通过 npx 或全局 npm 安装在本机运行，需要 Node.js 18 或更高版本。需要设置 ICTCRM_BASE_URL、ICTCRM_USERNAME 和 ICTCRM_PASSWORD 环境变量以提供 API 账号，并能访问该服务器。可选：ICTCRM_MCP_ALLOW_WRITE、ICTCRM_TIMEOUT_MS（默认 30000）、ICTCRM_TLS_INSECURE。
安装前请注意
账号密码通过 ICTCRM_PASSWORD 提供，并随每次 RPC 调用发送，建议使用专用 API 账号。写入工具默认关闭；设置 ICTCRM_MCP_ALLOW_WRITE=true 会开放创建、删除联系人和将联系人加入活动，从而改动 CRM 数据。ICTCRM_TLS_INSECURE 会跳过证书校验，仅应用于自签名的测试服务器。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Ictcrm Mcp，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

ictcrm-mcp

A Model Context Protocol server for ICTCRM from ICT Innovations.

ictcrm.com runs on the ICTContact backend, so this server speaks that RPC surface. It lets an AI assistant read contact groups and — only when you turn writes on — create and delete contacts and add a contact to a campaign.

Install

bash
npx -y ictcrm-mcp      # no installnpm install -g ictcrm-mcp

Requires Node.js 18 or newer.

Configure

VariableRequiredDefault
ICTCRM_BASE_URLyesServer base URL, without the /rest suffix, e.g. https://your-ictcrm
ICTCRM_USERNAMEyesAPI account username
ICTCRM_PASSWORDyesPassword for that account
ICTCRM_MCP_ALLOW_WRITEnofalseUnlock the contact write tools (see Safety)
ICTCRM_TIMEOUT_MSno30000Per-request timeout
ICTCRM_TLS_INSECUREnofalseSkip TLS verification — self-signed test servers only

Claude Desktop example

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

Tools

Read tools are always available:

ToolWhat it does
ictcrm_list_contact_groupsList contact groups (id, name, description)

Write tools appear only when ICTCRM_MCP_ALLOW_WRITE=true:

ToolWhat it does
ictcrm_create_contactCreate a contact in a group; returns the contact id
ictcrm_delete_contactDelete a contact by id
ictcrm_add_contact_to_campaignCreate a contact and attach it to a campaign

Safety

The server is read-only by default. Creating and deleting contacts only becomes possible when you set ICTCRM_MCP_ALLOW_WRITE=true.

A note on listing contacts

The ICTContact backend that ICTCRM runs on exposes contact groups and contact creation/deletion, but its "list contacts" method errors server-side, so this server does not offer a contact-listing tool. It manages contacts and reads contact groups; listing individual contacts is not available over the API today.

How it connects

Calls go to a form-encoded RPC API at {base}/rest/<Method>, each carrying the account username and password. There is no separate token to provision.

About

Built by Tahir Almas at ICT Innovations — the team behind ICTCRM, ICTContact, ICTDialer, ICTBroadcast, ICTFax and ICTPBX. Learn more at ictcrm.com.

MIT licensed. Issues and PRs welcome at github.com/ictinnovations/ictcrm-mcp.

来源：README.md，提交 48376ea

工具

1

ictcrm_list_contact_groups

List contact groups

List the contact groups (contact lists) in the CRM, each with its id, name and description. Use a group id when creating a contact.

无需输入参数。

版本历史

2
  1. v0.1.1最新Oct 26, 2026
  2. v0.1.0Sep 16, 2026

评分

已满足适用检查项的 90%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分
  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分