crm.config.get
read讀取 CRM 基本設定，包括啟用模組、必填欄位、語言、時區、貨幣、重複檢查規則及治理設定。
建議先讀取
無需前置工具。
治理與審批
只讀工具；不會建立審批請求。
安全說明
後續寫入必須以此工具回傳的設定為準，不得自行假設必填欄位或貨幣。
CRM 客戶關係管理 MCP 工具
本頁列出 CRM 模組規劃中的 MCP 工具，涵蓋線索進件、去重、資格評估、聯絡人與公司資料、商機管道、客戶互動、任務、通訊同意及批量匯入治理。
crm.pipelines.list
read列出可用銷售管道、階段、排序、成功/失敗狀態及預設機率。
建議先讀取
crm.config.get
治理與審批
只讀工具；不會建立審批請求。
安全說明
只使用回傳的 pipeline_id 及 stage_id；不得以顯示名稱自行推斷識別碼。
crm.sources.list
read列出線索來源及渠道，例如網站表單、WhatsApp、電話、電郵、轉介、廣告或匯入。
建議先讀取
crm.config.get
治理與審批
只讀工具；不會建立審批請求。
安全說明
建立線索時必須保留真實來源；未知來源應標記為待確認，不應亂填。
crm.owners.list
read列出可分派的負責人、團隊及可見性範圍，供線索、任務及商機分派使用。
建議先讀取
crm.config.get
治理與審批
只讀工具；不會建立審批請求。
安全說明
不得把記錄分派給回傳清單以外的使用者或停用帳戶。
crm.custom_fields.list
read讀取 CRM 自訂欄位、欄位類型、選項、驗證規則及適用物件。
建議先讀取
crm.config.get
治理與審批
只讀工具；不會建立審批請求。
安全說明
寫入自訂欄位前必須確認欄位類型及允許值。
crm.leads.search
read按姓名、公司、電話、電郵、來源或狀態搜尋線索，作為建立或更新前的去重步驟。
建議先讀取
crm.config.get
治理與審批
只讀工具；不會建立審批請求。
安全說明
搜尋結果可能含個人資料；只回傳完成任務所需欄位。
crm.leads.get
read讀取單一線索的詳情、來源、狀態、負責人、最近活動及版本資料。
建議先讀取
crm.leads.search 或已知 lead_id
治理與審批
只讀工具；不會建立審批請求。
安全說明
後續更新必須使用回傳的 lead_id 及 base_version_token。
crm.leads.create
write建立新線索，適合處理網站表單、人工輸入、活動名單或已確認的客戶查詢。
建議先讀取
crm.config.get、crm.sources.list、crm.leads.search
治理與審批
寫入工具；可直接執行或依租戶政策建立審批請求。
安全說明
建立前必須先搜尋重複記錄；不得自行補作電話、電郵、來源、同意狀態或負責人。
crm.leads.update
write更新線索基本資料、狀態、來源備註、負責人、評分或自訂欄位。
建議先讀取
crm.leads.get、crm.custom_fields.list
治理與審批
寫入工具；敏感欄位可要求審批。
安全說明
只更新使用者明確指定欄位；不要覆蓋人工備註或未讀取欄位。
crm.leads.score_preview
preview根據來源、公司資料、查詢內容、互動歷史及自訂規則預覽線索評分建議。
建議先讀取
crm.leads.get、crm.activities.list
治理與審批
預覽工具；不會寫入資料。
安全說明
評分只是建議；不得把預覽結果當成已確認商機價值。
crm.leads.score_update
write寫入已確認的線索評分、評分原因及下一步建議。
建議先讀取
crm.leads.score_preview、crm.leads.get
治理與審批
寫入工具；可按租戶政策直接執行或審批。
安全說明
必須保存評分原因；資料不足時不得提高分數。
crm.leads.duplicate_preview
preview比對線索、聯絡人及公司記錄，預覽可能重複項目及合併風險。
建議先讀取
crm.leads.search、crm.contacts.search、crm.companies.search
治理與審批
預覽工具；不會寫入資料。
安全說明
不得只憑相似名稱判定重複；電話、電郵、公司域名及來源都要納入判斷。
crm.leads.merge
write合併重複線索，保留主要記錄、來源、活動歷史及重要欄位。
建議先讀取
crm.leads.duplicate_preview、crm.leads.get
治理與審批
高風險寫入；建議建立審批請求。
安全說明
必須指定 master_lead_id；不得刪除未映射欄位或活動歷史。
crm.leads.qualify
write將線索標記為已合資格，設定下一步、負責人、預計需求及是否建立商機。
建議先讀取
crm.leads.get、crm.pipelines.list、crm.owners.list
治理與審批
寫入工具；可按租戶政策審批。
安全說明
沒有明確需求、聯絡方式或下一步時，不得強行標記為合資格。
crm.leads.disqualify
write將線索標記為不合資格，記錄原因、後續處理及是否保留再營銷資格。
建議先讀取
crm.leads.get
治理與審批
寫入工具；原因欄位必填。
安全說明
必須保存失敗或不合資格原因；不得刪除原始查詢內容。
crm.leads.convert_preview
preview預覽線索轉換為聯絡人、公司及商機時的欄位映射、重複風險及必要資料。
建議先讀取
crm.leads.get、crm.contacts.search、crm.companies.search、crm.pipelines.list
治理與審批
預覽工具；不會寫入資料。
安全說明
如發現既有聯絡人或公司，應提示連結而非新建。
crm.leads.convert
write將合資格線索轉換為聯絡人、公司及可選商機。
建議先讀取
crm.leads.convert_preview
治理與審批
高風險寫入；建議建立審批請求或要求明確確認。
安全說明
必須使用預覽結果的映射；不得自動建立未確認公司或商機金額。
crm.contacts.search
read按姓名、電話、電郵、公司、標籤或最近互動搜尋聯絡人。
建議先讀取
crm.config.get
治理與審批
只讀工具；不會建立審批請求。
安全說明
搜尋輸出應避免暴露與任務無關的敏感資料。
crm.contacts.get
read讀取單一聯絡人的資料、公司關係、同意狀態、活動歷史及版本資料。
建議先讀取
crm.contacts.search 或已知 contact_id
治理與審批
只讀工具；不會建立審批請求。
安全說明
後續更新必須使用回傳的 contact_id 及 base_version_token。
crm.contacts.create
write建立聯絡人，通常由合資格線索、人工輸入、匯入或客戶自助流程產生。
建議先讀取
crm.contacts.search、crm.companies.search、crm.consent.get
治理與審批
寫入工具；可按租戶政策直接執行或審批。
安全說明
建立前必須檢查重複；不得自行設定同意狀態或未確認公司關係。
crm.contacts.update
write更新聯絡人基本資料、職銜、公司關係、標籤、自訂欄位或偏好。
建議先讀取
crm.contacts.get、crm.custom_fields.list
治理與審批
寫入工具；敏感欄位可要求審批。
安全說明
不得覆蓋未讀取欄位；電郵及電話變更應保留稽核記錄。
crm.companies.search
read按公司名稱、域名、電話、行業、地區或標籤搜尋公司資料。
建議先讀取
crm.config.get
治理與審批
只讀工具；不會建立審批請求。
安全說明
公司重複判斷應同時參考域名、電話及地址，不應只看名稱。
crm.companies.get
read讀取公司資料、關聯聯絡人、商機、活動、地址、行業及版本資料。
建議先讀取
crm.companies.search 或已知 company_id
治理與審批
只讀工具；不會建立審批請求。
安全說明
後續更新必須使用回傳的 company_id 及 base_version_token。
crm.companies.create
write建立公司記錄，適合 B2B 線索轉換、人工建立或匯入後確認。
建議先讀取
crm.companies.search
治理與審批
寫入工具；可按租戶政策直接執行或審批。
安全說明
不得自行推斷公司法人名稱、地址或行業；不確定時應標記為待確認。
crm.companies.update
write更新公司資料、行業、地區、標籤、負責團隊或自訂欄位。
建議先讀取
crm.companies.get、crm.custom_fields.list
治理與審批
寫入工具；敏感欄位可要求審批。
安全說明
不得覆蓋關聯聯絡人或商機；只更新指定公司欄位。
crm.deals.list
read按管道、階段、負責人、公司、聯絡人、預計成交日期或狀態列出商機。
建議先讀取
crm.pipelines.list
治理與審批
只讀工具；不會建立審批請求。
安全說明
查詢範圍應受租戶及負責人權限限制。
crm.deals.get
read讀取單一商機的金額、階段、機率、關聯客戶、活動、任務及版本資料。
建議先讀取
crm.deals.list 或已知 deal_id
治理與審批
只讀工具；不會建立審批請求。
安全說明
後續更新必須使用回傳的 deal_id 及 base_version_token。
crm.deals.create
write建立商機，通常由合資格線索、既有客戶查詢或銷售人員確認後產生。
建議先讀取
crm.pipelines.list、crm.contacts.get 或 crm.companies.get
治理與審批
寫入工具；可按租戶政策審批。
安全說明
不得自行估算金額、成交日期或機率；缺少資料時應建立待確認欄位。
crm.deals.update_stage
write更新商機階段、機率、下一步及階段變更原因。
建議先讀取
crm.deals.get、crm.pipelines.list
治理與審批
寫入工具；關鍵階段可要求審批。
安全說明
只能移動至同一管道內允許的階段；不得跳過必要審批或必填原因。
crm.deals.close_won
write將商機標記為成交，記錄成交金額、日期、關聯訂單或後續交付要求。
建議先讀取
crm.deals.get
治理與審批
高風險寫入；建議建立審批請求或要求明確確認。
安全說明
成交金額及日期必須來自已確認資料；不得由代理程式自行推算。
crm.deals.close_lost
write將商機標記為失敗，記錄失敗原因、競爭對手、後續培育安排及再跟進日期。
建議先讀取
crm.deals.get
治理與審批
寫入工具；原因欄位必填。
安全說明
不得刪除商機；失敗原因必須保留，方便後續分析。
crm.activities.log
write記錄電話、會議、WhatsApp 摘要、電郵摘要、備註或其他客戶互動。
建議先讀取
crm.leads.get、crm.contacts.get 或 crm.deals.get
治理與審批
寫入工具；一般可直接執行。
安全說明
只記錄已發生或已確認的互動；外部訊息發送不應由此工具執行。
crm.activities.list
read讀取線索、聯絡人、公司或商機的活動時間線。
建議先讀取
已知 lead_id、contact_id、company_id 或 deal_id
治理與審批
只讀工具；不會建立審批請求。
安全說明
活動可能含個人資料或商業敏感內容；只回傳任務所需摘要。
crm.tasks.create
write建立跟進任務，例如回電、發送報價、安排會議、補充資料或主管審批。
建議先讀取
crm.owners.list 及相關記錄讀取工具
治理與審批
寫入工具；通常可直接執行。
安全說明
必須有負責人、到期日、關聯記錄及明確任務內容。
crm.tasks.update_status
write更新任務狀態、完成時間、完成備註或重新安排跟進日期。
建議先讀取
crm.tasks.list 或已知 task_id
治理與審批
寫入工具；通常可直接執行。
安全說明
不得把未完成任務標記為完成；完成備註應反映真實結果。
crm.tasks.list
read列出指定負責人、客戶、商機或日期範圍內的跟進任務。
建議先讀取
crm.owners.list 或相關記錄讀取工具
治理與審批
只讀工具；不會建立審批請求。
安全說明
任務列表應遵守使用者可見性，不應跨團隊暴露資料。
crm.consent.get
read讀取聯絡人的通訊同意、退訂、渠道偏好及資料來源記錄。
建議先讀取
crm.contacts.get 或已知 contact_id
治理與審批
只讀工具；不會建立審批請求。
安全說明
同意狀態會影響外部通訊；不得只憑備註推斷。
crm.consent.update
write更新通訊同意、退訂、渠道偏好、同意來源及時間。
建議先讀取
crm.consent.get、crm.contacts.get
治理與審批
高風險寫入；建議建立審批請求或要求明確確認。
安全說明
必須保存同意來源；不得由代理程式自行把未確認客戶標記為已同意。
crm.imports.preview
preview預覽 CSV 或外部名單匯入，檢查欄位映射、重複資料、必填缺漏及格式錯誤。
建議先讀取
crm.custom_fields.list、crm.sources.list、crm.owners.list
治理與審批
預覽工具；不會寫入資料。
安全說明
匯入前必須檢查重複及同意來源；不得把未確認名單直接寫入。
crm.imports.commit
write在預覽通過後提交名單匯入，建立或更新線索、聯絡人或公司記錄。
建議先讀取
crm.imports.preview
治理與審批
高風險批量寫入；建議建立審批請求。
安全說明
必須使用預覽批次的 import_id；不得繞過重複檢查或同意檢查。