在 Kilo Code 中設定 DeepSeek Search

重點摘要

了解如何在 Kilo Code 擴充功能或 CLI 中連接 DeepSeek Search,並選擇正確的 MCP 設定位置、權限與驗證方式。

想請 Kilo 替你準備設定? 將本指南分享給 Kilo,並告訴它你使用哪種介面。請它先檢查該介面的設定,而且只草擬設定。你應在本機私密環境檔中輸入 DeepSeek 金鑰,絕不要貼到聊天裡。
text
依照本指南將 DeepSeek Search 連接到 Kilo Code。先確認我使用的是 VS Code 擴充功能還是 Kilo CLI,再檢查該介面的設定,並保留現有 MCP 項目。加入一個從本機私密環境檔載入金鑰的 Node 伺服器,將工具權限設為 Ask,並告訴我如何使用正確的重新載入和列出命令確認工具。不要讀取、列印或提交我的金鑰。發出可能計費的測試請求前,先徵求我的同意。

設定 MCP 前,Kilo Code 使用者需要先確認自己使用的是 VS Code 擴充功能還是 Kilo CLI。兩者共用 Kilo 的 MCP 模型,但官方文件所列的設定位置與重新載入流程不同。如果設定放錯位置,內容看似正確,Agent 卻仍可能看不到工具。

Kilo Code 擴充功能與 CLI 各自的設定路徑,最後匯入受監督的 Search 與 Fetch 工具。

Kilo Code 擴充功能與 CLI 使用不同的設定入口,最後都會連接至受監督的 Search 與 Fetch 工具。

選擇 Kilo 介面與設定位置

使用 VS Code 擴充功能時,開啟 Settings → Agent Behaviour → MCP Servers,並在此編輯設定。Kilo 擴充功能文件列出的使用者層級位置為 ~/.config/kilo/kilo.jsonc;專案層級則為 kilo.jsonc 或 .kilo/kilo.jsonc。若工具只屬於特定工作區,請採用專案層級;若你要在多個專案中重複使用,則可採用全域設定。官方 Kilo MCP 指南說明了擴充功能的設定位置。

Kilo CLI 1.x 使用 CLI 設定檔:全域的 ~/.config/kilo/kilo.json(或 .jsonc),或專案中的 kilo.json/kilo.jsonc。在該工作區中,專案設定優先。將項目加入頂層 mcp 物件,並保留其他設定:

jsonc
{
  "mcp": {
    "deepseek-search": {
      "type": "local",
      "command": [
        "node",
        "--env-file=/Users/you/.config/deepseek-search/.env",
        "/Users/you/tools/deepseek-search/server.mjs"
      ],
      "enabled": true
    }
  }
}

CLI 文件採用類似 OpenCode 的 mcp 物件與命令陣列。對擴充功能而言,Settings 面板是確認目前安裝版本所需確切結構的最佳位置。Kilo 的 CLI 平台指南列出最新 CLI 設定與命令。

請在儲存庫之外建立環境檔,寫入 DEEPSEEK_API_KEY=... 並限制存取權限。Node 程序會在啟動時讀取金鑰;金鑰本身不該放在 kilo.jsonc。Kilo 文件說明可在受信任的全域設定中使用環境變數插值,但專案設定通常會共用或提交,因此本指南建議使用私密環境檔。

重新載入並確認 MCP 工具

在 Kilo CLI 執行 /mcps 檢視並切換 MCP 伺服器,編輯設定後執行 /reload。在擴充功能中,返回 MCP Servers 設定面板;如果項目沒有出現,使用面板中的重新載入或重新連線控制項。確認伺服器已啟用,而且工具清單同時列出 Search 和 Fetch。如果 Kilo 的權限設定詢問允許或拒絕工具呼叫,首次測試請維持 Ask;不要為了讓整合看似正常而採用廣泛的自動核准模式。

可以讓 Kilo 執行一個小型研究任務:搜尋某個目前框架問題的官方解答,擷取它選中的官方文件頁面,並引用 URL。檢查 Agent 活動紀錄中是否同時包含兩項操作,以及擷取頁面是否支持答案。程序即使成功連線,API 金鑰仍可能無效;只有工具呼叫才能確認驗證狀態。

只需要查一次?使用 cURL

你也可以在 Kilo 終端機中搜尋,而不註冊 MCP 工具。這適合偶爾查詢,但 Kilo 無法把它當成受管理工具呼叫,而且你需要自行檢查結果。成功的 API 請求會計費:

bash
read -r -s DEEPSEEK_API_KEY
export DEEPSEEK_API_KEY
curl --fail-with-body --max-time 20 \
  https://api.deepseek.com/v1/tools/search \
  -H "Authorization: Bearer $DEEPSEEK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"official Kilo Code CLI MCP configuration /mcps reload","count":3,"need_content":false}'

對選定的 URL 使用 POST /v1/tools/fetch 檢查內容。DeepSeek 的 Search 與 Fetch API 指南列出目前的請求格式與價格;發送請求前請先確認。

如果 Kilo 仍然看不到伺服器

先確認你正在使用的介面:CLI 設定中的擴充功能項目,或擴充功能專用設定檔中的 CLI 項目,不一定會載入。接著檢查設定優先順序,並在 CLI 執行 /reload。確認 Node 位於程序的 PATH 中,而且環境檔與配接器路徑都是絕對路徑。如果 Kilo 列出伺服器,但 Agent 沒有使用它,請檢查伺服器是否啟用,以及權限規則是否阻擋呼叫。在信任整個流程之前,請讓搜尋和擷取請求都可供審核。

當正確的 Kilo 介面同時列出兩項工具、受監督的 Search-to-Fetch 任務能回傳有來源依據的答案,而且金鑰不在專案設定或聊天紀錄中時,設定才算完成。網頁內容是參考資料,不是要遵從的指令。

延伸閱讀:19 個 Agent 平台的 DeepSeek Search 接入總覽、Claude Code 設定指南與 Codex 設定指南。

作者:Victor Lane,Auspia GEO 稽核專家,完成過 300 多次準備度審查。Victor 專注於準備度稽核、檢查清單、評分卡與診斷分析。

探索此主題

繼續閱讀相同的成長脈絡