聯絡人 MCP 憑證設定

實現個人化的 MCP 工具憑證管理，確保資料安全隔離

一、功能背景介紹

什麼是 MCP 憑證功能

MCP 憑證功能就像是「幫每個客戶設定專屬的通行證」。當多個客戶需要使用同一個工具查詢他們自己的資料時，每個人需要有自己的「鑰匙」（憑證），這樣才能確保每個人只能看到自己的資料，不會看到別人的。

簡單比喻 就像公寓大樓，所有住戶都用同一個電梯（MCP 工具），但每個人要刷自己的門禁卡（憑證）才能進入自己的樓層。

為什麼需要此功能

• 保護客戶隱私 — 每個客戶使用自己的憑證，確保資料不會混在一起

• 個別化服務 — 不同客戶可以有不同的使用權限

• 方便管理 — 當客戶的憑證過期或需要更換時，只需要更新那一個客戶的設定

使用場景舉例

場景 1：個人資料查詢 客戶 A 和客戶 B 都要查詢自己的消費記錄，但他們各自有不同的帳號密碼

場景 2：部門權限管理 不同部門使用同一個查詢工具，但有不同的查看權限

場景 3：分級服務 VIP 客戶可以查詢更詳細的資料，一般客戶只能查詢基本資料

---

二、功能位置與使用準備

在哪裡找到這個功能

操作路徑 聯絡人管理 → 點擊編輯聯絡人 → 切換到「MCP 憑證」標籤頁

重要提醒 需要先建立並儲存聯絡人後，才能設定 MCP 憑證（確保憑證能正確綁定到聯絡人）

使用前的準備

在開始設定之前，請確認以下事項：

1. 系統中已經有建立好的 MCP 工具（AI功能 → 工具 → MCP）

   
2. 要配置憑證的聯絡人已經建立並儲存

3. 已經拿到該聯絡人的憑證資訊（通常由客戶或有權限的人員提供）

權限說明 系統管理員可以根據組織需求，彈性分配「工具」和「聯絡人」的功能權限。

---

三、操作說明

3.1 查看可以設定的工具

操作步驟

1. 點開要編輯的聯絡人

2. 點擊上方的「MCP 憑證」標籤

3. 會看到所有可以設定的工具列表

工具列表說明

每個工具會顯示：

• 工具名稱（例如：「客戶資料庫查詢」）

• 工具說明（如果有的話，會以灰色小字顯示在名稱下方）

• 編輯按鈕（右側的鉛筆圖示）

如何分辨設定狀態

• 已設定過 → 工具名稱右邊會出現綠色的「已設定」標籤

• 還沒設定 → 工具名稱右邊沒有任何標籤

---

3.2 新增或修改憑證

步驟 1：打開設定區

點擊工具右邊的「編輯」按鈕（鉛筆圖示），會展開設定區域

步驟 2：填寫 Headers（憑證資訊）

在文字框中貼上憑證資訊，格式是 JSON：

{"Authorization": "Bearer 這裡是鑰匙代碼"}

不確定格式的話，可以點「格式化 JSON」按鈕自動整理

什麼是 Headers？ Headers 就是「身份證明文件」，裡面包含了這個聯絡人的專屬鑰匙。就像你去銀行辦事需要帶身份證，系統需要這個 Headers 來確認「這個人是誰」。

什麼是 JSON？ JSON 是一種資料格式，看起來像：{"欄位名稱": "內容"}。不用擔心，通常會有人直接提供給你，你只需要複製貼上就好。

步驟 3：注意事項

• Headers 是必填的（有紅色 * 號標記）

• 填入的 Headers 會取代工具原本的預設設定

重要：不同 MCP 工具需要的 Headers 格式不一樣，請務必確認你拿到的憑證格式跟這個工具相符

步驟 4：儲存或取消

儲存設定

• 確認沒問題後，點右下角的「儲存」按鈕

• 系統會檢查格式是否正確

• 儲存成功後：

  • 編輯區會自動收起

  • 工具名稱右邊會出現綠色的「已設定」標籤（第一次設定時才會新出現）

取消編輯

• 如果不想儲存，點「取消」即可

---

3.3 重置憑證（清除已設定的憑證）

什麼時候會用到？

當憑證設定錯誤，或是不再需要這個憑證時，可以重置。

如何操作

1. 點擊工具的「編輯」按鈕，展開編輯區

2. 如果這個工具已經設定過憑證（有綠色「已設定」標籤），左下角會出現紅色的「重置憑證」按鈕

3. 點擊後確認，憑證就會被清除

4. 清除後，工具名稱右邊的綠色「已設定」標籤會消失

⚠️ 重要提醒

• 重置後無法復原

• 建議重置前先把 Headers 內容複製保存

• 如果只是要修改內容，直接編輯就好，不需要重置

---

四、操作範例

範例 1：為客戶設定資料庫查詢憑證

情境說明

客戶 A 要查詢他自己的消費記錄，你拿到了一組憑證代碼。

Headers 內容

{
  "apikey": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "Authorization": "Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
}

操作步驟

1. 找到聯絡人「客戶 A」，點擊編輯

2. 切換到「MCP 憑證」標籤

3. 找到「客戶資料庫查詢」工具，點編輯按鈕

4. 把憑證代碼貼上

5. 點「格式化 JSON」確保格式整齊

6. 點儲存

---

範例 2：為部門設定專用查詢憑證

情境說明

業務部需要查客戶資料，但只能看基本資料，不能看財務資料。

Headers 內容

{
  "X-API-Key": "dept_sales_abc123",
  "X-Department": "sales"
}

欄位說明

• X-API-Key — 業務部的專用鑰匙

• X-Department — 標示這是業務部在用

---

範例 3：設定多個欄位的憑證

Headers 內容

{
  "Authorization": "Bearer token_xyz",
  "X-Client-ID": "client_12345",
  "Content-Type": "application/json"
}

欄位說明

• Authorization — 主要的身份驗證鑰匙

• X-Client-ID — 客戶編號

• Content-Type — 資料格式說明（通常固定是這個）

---

五、聯絡人 MCP vs 工具 MCP 的差異

功能比較表

比較項目	工具 → MCP	聯絡人 → MCP 憑證
是什麼	建立工具本身	幫個別聯絡人設定專屬憑證
設定範圍	整個系統都能用	只給特定聯絡人用
設定內容	• 工具的網址 • 預設的憑證 • 可以做哪些事	• 只設定這個人的憑證 • 會取代預設憑證
什麼時候用	第一次要接入新工具時	每個客戶要用不同憑證時
誰可以操作	有權限即可操作	有權限即可操作
在哪裡設定	工具管理頁面	聯絡人編輯頁面
常見用途	• 新增一個查詢工具 • 設定工具的基本資料	• 每個客戶用自己的帳密 • VIP 客戶有特殊權限

簡單理解：電腦教室比喻

想像一下學校的電腦教室：

工具 MCP（有權限的人員建立）

• 在電腦教室安裝軟體

• 設定所有電腦都能用這個軟體

• 決定軟體有哪些功能

聯絡人 MCP 憑證

• 幫每個學生建立自己的帳號

• 每個學生用自己的帳號登入

• 不同學生可以有不同的使用權限

實際工作流程

第一步：建立 MCP 工具（有建立工具權限的人員）
    ↓
建立「客戶資料庫查詢」工具
- 設定工具網址
- 設定預設憑證（如果有的話）
    ↓
第二步：為每個聯絡人設定專屬憑證（有設定憑證權限的人員）
    ↓
客戶 A：設定 A 的專屬憑證
客戶 B：設定 B 的專屬憑證
客戶 C：設定 C 的專屬憑證
    ↓
結果：大家用同一個工具，但各自用自己的憑證

權限彈性 系統管理員可以根據組織需求，決定誰可以建立工具、誰可以設定憑證。可以是同一批人，也可以分開管理。

重點整理

• 工具 MCP — 先有「工具」才能用

• 聯絡人 MCP 憑證 — 再給每個人「鑰匙」

---

六、常見問題

Q1：為什麼我看不到「MCP 憑證」標籤？

可能原因

• 你是在「新增聯絡人」（要先儲存聯絡人後，再進來編輯才看得到）

• 系統裡還沒有建立任何 MCP 工具

• 聯絡人資料還沒儲存

解決方法

1. 先把聯絡人基本資料填好並儲存

2. 確認系統有 MCP 工具（請有權限的人員確認）

3. 重新進入編輯模式

---

Q2：Headers 格式錯誤怎麼辦？

常見錯誤範例

• ❌ 錯誤：{'key': 'value'}（用了單引號）

• ❌ 錯誤：{key: value}（沒有引號）

• ❌ 錯誤：{"key": "value",}（最後多了逗號）

• ✅ 正確：{"key": "value"}

解決方法

1. 點「格式化 JSON」按鈕，系統會自動檢查

2. 如果還是有問題，請把憑證重新複製一次

3. 或是請提供憑證的人再確認一次格式

---

Q3：我怎麼知道要填什麼內容？

取得憑證的方式

1. 請客戶提供他們的憑證資訊

2. 請負責人員提供或協助建立

3. 詢問負責這個工具的同事

4. 參考其他已經設定成功的聯絡人（但不要直接複製！）

⚠️ 不要自己亂填

憑證都是有特定格式和內容的，填錯了工具會無法使用，還可能造成資料錯誤。

---

Q4：為什麼我看不到「已設定」標籤？

顯示條件

• 只有「已經設定過憑證」的工具才會顯示這個綠色標籤

• 第一次設定時，在儲存成功前不會看到

• 儲存成功後，標籤才會出現

工具列表都沒有標籤？

代表這個聯絡人還沒有設定過任何 MCP 憑證，這是正常的。

---

Q5：找不到「重置憑證」按鈕？

顯示條件（需同時滿足）

1. 這個工具已經設定過憑證（工具名稱右邊有綠色「已設定」標籤）

2. 你有點擊「編輯」按鈕展開編輯區

按鈕位置

展開編輯區後，紅色的「重置憑證」按鈕在左下角，「取消」和「儲存」按鈕在右下角。

工具還沒設定憑證？

不會有「重置憑證」按鈕，因為沒有憑證可以重置。這時候左下角會是空白的。

---

Q6：按了「重置憑證」會怎樣？

會發生的事

• 這個聯絡人的專屬憑證會被清除

• 工具名稱右邊的綠色「已設定」標籤會消失

• 如果工具有預設憑證，會改用預設的（但通常沒有）

• ⚠️ 刪除後無法復原

建議做法

• 先把 Headers 內容複製備份

• 想清楚是否真的要刪除

• 如果只是要修改內容，用「編輯」就好

---

Q7：多個聯絡人可以用同一組憑證嗎？

技術上可以

系統不會擋你複製同樣的憑證給不同人

但是不建議

• 沒辦法知道是誰在使用

• 資料可能會混在一起

• 有人出問題時，不知道是誰的問題

正確做法

• 每個聯絡人用自己的憑證

• 保持資料清楚分開

• 方便追蹤和管理

---

Q8：工具列表是空的，顯示「暫無可用工具」？

可能原因

• 系統還沒有建立 MCP 工具

• 所有工具都是「全域」類型（全域工具不需要個別設定憑證）

解決方法

1. 請有建立工具權限的人員確認是否已建立 MCP 工具

2. 確認工具類型設定正確

3. 如果都正常但還是看不到，請聯繫技術支援

---

附錄：操作檢查清單

設定前確認

• 聯絡人已經建立並儲存了

• 系統有可用的 MCP 工具

• 已經拿到憑證資訊（從客戶或負責人員那裡）

• 確認憑證格式正確

設定時確認

• Headers 格式正確（可以用格式化按鈕檢查）

• 該填的欄位都有填

• 沒有多餘或錯誤的內容

• 點格式化後沒有出現錯誤訊息

設定後確認

• 工具名稱右邊出現綠色「已設定」標籤

• 實際測試工具可以正常使用

• 把設定資訊記錄下來（日期、聯絡人、工具名稱）

• 如果需要，通知相關人員已完成設定