IDE Agent에게 설정을 맡길까요? 이 가이드를 JetBrains AI Assistant에 전달하고 MCP 항목을 준비하며 변경 사항을 설명하도록 요청하세요. API 키는 직접 로컬에서 입력하고 채팅에 붙여넣지 마세요.
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 등에서 검색 서버를 한 프로젝트에만 연결할지 모든 프로젝트에서 쓸지 선택할 수 있습니다. 여기서는 기존 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가 그 파일을 읽도록 설정합니다.
{
"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는 도구를 사용할 수 없습니다.
일반 AI Assistant 채팅에서 최신 공개 정보가 필요한 구체적인 질문을 던져 보세요. 예: “이 프로젝트 프레임워크의 최신 안정 버전 공식 문서를 찾고 페이지를 가져온 다음 사용한 요구 사항을 출처와 함께 인용해 줘.” 도구 활동에서 Search와 Fetch가 모두 실행되고 인용 내용이 가져온 페이지와 일치하는지 확인합니다. Search 요약은 후보를 찾는 단서일 뿐이며 Fetch로 사실을 검증해야 합니다.
ACP 클라이언트가 IDE 서버 설정을 항상 자동 상속하지는 않습니다.
답변 하나만 필요하면 IDE 터미널 사용하기
한 번 검색할 때는 MCP를 영구 등록하지 않고 IDE 터미널에서 직접 Search를 호출할 수 있습니다. 가장 간단하지만 유료 API 요청이며 AI Assistant에서 재사용 도구로 제공되지는 않습니다.
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 가이드에 두 요청 형식과 최신 요금이 나옵니다. 가격은 달라질 수 있으므로 비용 산정 전에 확인하세요.
연결뿐 아니라 Agent에 도구가 전달됐는지 점검하기
연결이 끊겼다면 Help | Show Log in Finder/Explorer에서 MCP 로그를 보고 Node 명령과 두 절대 경로가 유효한지 확인합니다. AI Assistant에는 도구가 보이는데 ACP Agent에는 없다면 Pass custom MCP servers를 확인하고 Agent를 재시작하세요. Search 결과만 있고 답변에 근거가 없다면 먼저 1차 페이지를 Fetch하고 URL을 인용하도록 요청합니다.
선택한 JetBrains 채팅 화면에 DeepSeek 도구 두 개가 표시되고 최신 정보 질문에서 Search와 Fetch가 실행되며 최종 답변이 가져온 페이지를 인용하면 설정이 완료됩니다. 키는 저장소와 채팅 밖에 보관하세요.
작성자 Alice Monroe. Auspia의 AI SEO 도구 분석가로 150개 이상의 도구를 다루며 AI 검색 제품과 실용적인 소프트웨어 워크플로를 씁니다.
도구 검색과 DeepSeek API 인증은 서로 다른 확인 단계입니다.
DeepSeek Search 설정 가이드 더 보기
관련 가이드: Hermes Agent에서 DeepSeek Search 사용하기 · Kilo Code에 DeepSeek Search 설정하기
