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 分