SupaTalker 文件
AI 技能與測試

MCP 伺服器金鑰

讓外部 AI 工具連進來管理知識庫:開立金鑰、限定可用工具、連線設定與撤銷

這一頁發的是給外部 AI 工具用的金鑰。Claude Code、Codex、claude.ai 這類 AI 工具, 可以透過 MCP 連進本平台管理知識庫,連線時要帶一把在這裡開立的金鑰。 每一把金鑰代表一個外部工具的通行證,並且可以限定它只能用哪些功能。

它和技能頁的「MCP 連接器」方向相反:連接器是本平台連出去使用別人的服務;金鑰是讓外部工具連進來。

目前開放的範圍

目前只開放知識庫相關的管理與操作,未來會陸續開放平台其他內容的管理與操作。

先知道兩件事

  • 只有 Owner 看得到這一頁,跟管理員帳號一樣
  • 白名單勾了什麼,就是對方能對知識庫做的全部

金鑰列表

MCP 伺服器金鑰列表

欄位內容
名稱你自己取的名字,下面一行是這筆金鑰的識別碼(不是金鑰本身)
前綴辨識金鑰開頭的幾個字,用來對照某個工具正在用哪一把
可用工具白名單這把金鑰連到哪裡(例如「知識庫」)與可用的工具數;按眼睛圖示看完整清單
有效期限到期時間
最後請求上一次被使用的時間,還沒被用過時顯示「從未請求」。可用來判斷這把還有沒有在用
狀態啟用中,或已撤銷
連線說明Claude Code、Codex、claude.ai 三種工具的連線設定(見下方「連線說明」)
操作撤銷與刪除;已撤銷的金鑰,「撤銷」會變成「恢復」

檢視工具清單

新增金鑰

按右上角的「新增金鑰」:

新增金鑰

欄位說明
金鑰名稱最多 50 字。建議寫清楚是給誰用的,例如「Claude Desktop(唯讀)」
適用路由這把金鑰能連到哪裡。目前只有「知識庫」;一把金鑰只能綁一個路由
工具白名單預設全部勾選,至少要留一項。旁邊有「全選」「不含發佈」「清除」
有效期限30 天、90 天、365 天,或永不過期

按「確認新增」建立金鑰。

有效期限選單

**「不含發佈」**會拿掉讓內容對外生效的三項工具(發佈、編輯並發佈、上下架), 適合只讓 AI 工具建立草稿,要不要讓訪客看到由人決定:

不含發佈

金鑰只會顯示一次

關閉視窗後就再也看不到這把金鑰

建立完成後畫面會跳出金鑰,當下就要複製並妥善保管。

關掉之後列表上只看得到前綴,沒有任何地方能再查出完整金鑰。弄丟了只能撤銷舊的、重新發一把。

「金鑰新增成功」視窗裡,按「複製金鑰」複製;「如何連線」下的三顆按鈕會打開各工具的連線說明。確認保管好之後再按「關閉」:

金鑰新增成功

可以開放哪些工具

目前有十五項,全部都是知識庫相關:

類型工具
讀取kb_list_entries、kb_get_entry、kb_list_categories、kb_list_tags
建立與修改(不會對外生效)kb_create_draft、kb_update_entry、kb_import、kb_delete_draft、kb_create_category、kb_delete_category、kb_create_tag、kb_delete_tag
發佈與上下架(會對外生效)kb_publish_entry、kb_edit_and_publish、kb_set_listed

只勾讀取那四項,就是一把唯讀金鑰。要給外部工具寫入權限之前,先想清楚有沒有必要—— 金鑰一旦交出去,對方能做的事就是白名單上的全部。透過金鑰發佈的內容,一樣會經過知識庫同步前的內容審查。

連線說明

列表上「連線說明」欄的三顆按鈕,分別打開 Claude Code、Codex、claude.ai 的連線設定, 內容有這個站台的端點網址,以及可以直接複製的設定範例。範例裡的「<您的金鑰>」要換成新增時取得的金鑰。

Claude Code 連線設定 Codex 連線設定

claude.ai 是從網路上連進來,端點必須是站台公開的 HTTPS 網址:

claude.ai 連線設定

外部工具這一端怎麼新增連線,以各工具的官方說明為準: Claude Code、 Codex、 claude.ai。

撤銷與刪除

兩個動作都在每一列的最右側,按下後都會先跳出確認視窗。

動作結果能不能恢復
撤銷這把金鑰停止生效,狀態變成「已撤銷」可以,按鈕會變成「恢復」
刪除把這筆記錄整個移除不能,永久刪除

不論哪一種,使用這把金鑰的工具都會連不進來, 所以動手前先確認沒有人還在用——「最後請求」那一欄可以幫你判斷。

撤銷金鑰的確認視窗 永久刪除金鑰的確認視窗

本頁內容