在 JetBrains AI Assistant 中接入 DeepSeek Search:MCP 設定

重點摘要

在 JetBrains AI Assistant 設定本機 DeepSeek Search MCP 伺服器,選擇專案或全域範圍,並在 IDE 中驗證工具與來源。

想讓 IDE Agent 幫你配置? 把這篇指南發給 JetBrains AI Assistant,讓它準備 MCP 配置、逐項解釋變更,並把 API 金鑰留給你在本地輸入。不要把金鑰貼進聊天。
text
Use this guide to add DeepSeek Search to JetBrains AI Assistant in this IDE.
Inspect the current MCP settings first and preserve all existing servers. Prefer
project scope unless I ask for global access. Do not read, print, or save my
DeepSeek key in project files or chat. Prepare the local Node command using a
private env file, show me the exact settings entry, and wait for me to enter
the key. Verify that the server connects and both tools are listed. Do not
make a billable request until I approve it.

JetBrains AI Assistant 在 IDE 設定中管理 MCP,不要求使用特定的倉庫配置規範。無論你使用 IntelliJ IDEA、PyCharm、WebStorm 還是其他 JetBrains IDE,都可以選擇搜尋伺服器只對當前專案生效,或對整個賬號可用。本指南會把已有的 DeepSeek Search 橋接程式作為本地程序新增,不會替代 JetBrains 內建的文件或程式碼庫上下文。

在 AI Assistant 設定中新增本地伺服器

開啟 Settings | Tools | AI Assistant | Model Context Protocol (MCP),選擇 Add,再選本地 STDIO 傳輸並輸入 JSON 配置。JetBrains 支援專案級和全域性伺服器,首次測試建議使用當前專案範圍。具體對話方塊可能隨 IDE 版本略有差別。官方 MCP 設定指南介紹了 JSON 格式、傳輸選項、範圍選擇器和 Apply 步驟。

複用 Claude Code DeepSeek 指南中的輕量 Node 介面卡。把金鑰放在倉庫之外的私密檔案中,例如 /Users/you/.config/deepseek-search/.env,再讓 Node 讀取該檔案:

json
{
  "mcpServers": {
    "deepseek-search": {
      "command": "node",
      "args": [
        "--env-file=/Users/you/.config/deepseek-search/.env",
        "/Users/you/tools/deepseek-search/server.mjs"
      ]
    }
  }
}

使用絕對路徑可以確保 IDE 開啟不同專案時伺服器都能正常啟動。配置只包含金鑰檔案的路徑,不包含金鑰本身。在共享電腦上使用私有目錄並限制檔案許可權。如果組織透過 IDE Services 集中管理設定,管理員可能會限制新增個人 MCP 伺服器。

點選 OK,再點選 Apply。如果伺服器沒有自動啟動,可在同一設定頁開啟 Automatically enable new and changed MCP servers,或選中伺服器後點選 Reconnect。狀態列應顯示連線成功。開啟伺服器工具列表,確認 deepseek_search 和 deepseek_fetch 均已出現。

確認當前 Agent 能看到伺服器

AI Assistant 可以將已配置的 MCP 工具提供給整合 Agent。如果你在 JetBrains AI Chat 面板中使用 Claude Agent、Codex 或 GitHub Copilot 等 ACP Agent,還需開啟 Settings | Tools | AI Assistant | Agents,為該 Agent 啟用 Pass custom MCP servers。JetBrains 在Agent 設定文件中把它列為單獨的控制項。MCP 頁面顯示伺服器已連線,並不代表 ACP Agent 一定能使用;傳遞選項關閉時,Agent 仍無法訪問。

在普通 AI Assistant 聊天中,提出一個需要實時公開資料的具體問題,例如:“查詢這個專案框架最新穩定版本的官方文件,抓取該頁面,並引用你使用的要求。”觀察工具活動記錄:成功結果應包含 Search、Fetch,以及與抓取頁面相符的引用。Search 摘要只用於發現候選網頁;Fetch 才能核對結論。

JetBrains MCP 設定中的伺服器需要透過單獨的選項傳遞給 ACP Agent。

ACP 客戶端不會自動繼承 IDE 中的全部伺服器。

只需要一個答案時使用終端請求

單次查詢可以跳過持久化 MCP 配置,直接在 IDE 終端中發起 Search。這是最短路徑,但請求會產生費用,而且 DeepSeek 不會成為可重複呼叫的 AI Assistant 工具:

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":"site:youtrack.jetbrains.com/help AI Assistant MCP settings","count":3,"need_content":false}'

將一個結果 URL 傳送到 POST /v1/tools/fetch,檢查頁面文字。DeepSeek 的 Search 與 Fetch API 指南列出兩種請求格式和當前費用。費率可能變化,預算前先檢查實時頁面。

檢查工具傳遞,而不只是連線狀態

如果伺服器顯示斷開,在 Help | Show Log in Finder/Explorer 檢視 MCP 日誌,再檢查 Node 命令和兩個絕對路徑。如果 AI Assistant 能看到工具,但 ACP Agent 看不到,請確認 Pass custom MCP servers 已啟用,並重啟 Agent。如果 Search 正常但回答沒有證據,在提示中要求先 Fetch 一手來源並引用 URL。

當所選 JetBrains 聊天介面列出兩個 DeepSeek 工具、實時資訊任務實際呼叫 Search 和 Fetch,且最終回答引用抓取頁面時,接入就透過了。金鑰應留在倉庫和聊天記錄之外。

作者 Alice Monroe,Auspia AI SEO 工具分析師,評測超過 150 款工具,關注 AI 搜尋產品和實用軟體工作流。

JetBrains 發現本地伺服器後,只有明確傳遞時 ACP 客戶端才會獲得工具。

工具發現與 DeepSeek API 認證是兩個獨立環節。

探索更多 DeepSeek Search 接入指南

瀏覽 Agent 接入總指南

相關平臺指南:在 Hermes Agent 中使用 DeepSeek Search · 在 Kilo Code 中配置 DeepSeek Search

探索此主題

繼續閱讀相同的成長脈絡