Roo가 설정을 준비하게 하고 싶으신가요? 이 가이드를 Roo Code에 전달하고, 먼저 전역 및 프로젝트 MCP 설정을 모두 확인한 뒤 최소 변경안을 제안해 달라고 요청하세요. API 키는 로컬 환경 파일에 보관하고, 저장 전에 변경 내용을 검토합니다.
Help me add DeepSeek Search to Roo Code using this guide. First tell me whether
this project should use a project-level or global MCP entry, then inspect the
existing configuration at that scope. Preserve other servers. Add the local
Node adapter with the key loaded from a private env file, keep alwaysAllow
empty, and show me the JSON diff. Do not reveal the key or make a paid request
without asking me first.Roo Code에서 중요한 선택은 설정 범위입니다. 전역 MCP 서버는 여러 워크스페이스에서 사용할 수 있고, .roo/mcp.json은 서버를 한 프로젝트에만 둡니다. 양쪽에 같은 이름의 서버가 있으면 프로젝트 설정이 우선합니다. 모든 저장소에 웹 검색이 필요한 것은 아니므로 프로젝트 범위로 시작하고, 다른 곳에서도 계속 필요할 때 전역 설정으로 옮기세요. Roo Code MCP 설정
Roo 설정 범위 선택하기
Roo Code MCP 설정 패널에서 Edit Project MCP 또는 Edit Global MCP를 엽니다. 팀 프로젝트용이라면 비밀 정보가 포함되지 않은 것을 확인한 뒤에만 프로젝트 파일을 커밋하세요. 아래 어댑터 설정은 환경 파일을 경로로 참조하므로 키를 공유하지 않고도 설정을 공유할 수 있습니다.
{
"mcpServers": {
"deepseek-search": {
"command": "node",
"args": [
"--env-file=/Users/you/.config/deepseek-search/.env",
"/Users/you/.local/share/deepseek-search/server.mjs"
],
"alwaysAllow": [],
"disabled": false,
"timeout": 60
}
}
}설정은 Roo가 문서화한 command, args, alwaysAllow, disabled, timeout 필드를 사용합니다. 처음 통합을 시험할 때는 alwaysAllow를 비워 두어 각 도구 호출마다 Roo가 허가를 요청하게 하세요. 예시 경로를 절대 경로로 바꾸고 Node.js 22 이상을 사용합니다. Claude Code 가이드에 따라 신뢰할 수 있는 디렉터리에 어댑터와 고정 버전 종속성을 설치하고 DEEPSEEK_API_KEY=...가 있는 비공개 환경 파일을 만듭니다.
Roo는 인수에서 ${env:VARIABLE_NAME} 같은 환경 변수 치환을 지원하고 env를 통해 값을 전달할 수도 있습니다. 단, VS Code 프로세스가 해당 변수를 상속해야 합니다. 셸 환경 변수를 물려받지 않는 데스크톱 런처에서 Roo를 시작한다면 --env-file 방식이 더 예측 가능합니다.
커넥터를 한 워크스페이스에 한정하려면 프로젝트 파일을 사용하세요.
필요한 워크스페이스에서 서버 불러오기
.roo/mcp.json을 저장한 다음 Roo MCP 설정으로 돌아가 서버가 연결되었는지 확인합니다. 프로젝트 설정은 프로젝트 루트에서 읽으므로 VS Code에서 .roo/mcp.json을 포함한 저장소를 열어야 합니다. 전역 파일을 수정했다면 해당 전역 항목을 확인하세요. 이름이 충돌하면 프로젝트 설정이 우선합니다.
Roo는 mcp 도구 그룹이 포함된 모드에서 MCP 도구를 사용할 수 있습니다. 기본 Ask, Architect, Code 모드에는 MCP 접근 권한이 있습니다. 사용자 지정 모드라면 서버 자체를 조사하기 전에 도구 권한을 확인하고 그 모드에서 MCP를 활성화하세요. Roo 모드와 도구 그룹
서버가 표시되지 않으면 현재 활성 모드를 먼저 확인하세요.
승인을 확인하며 작은 근거 테스트 실행하기
Roo에 범위가 좁은 조사 작업을 요청합니다. 특정 패키지 기능의 공식 문서를 찾아 가장 적절한 결과를 Fetch한 다음, 출처 URL과 함께 답을 설명하게 합니다. Search와 Fetch 요청을 각각 한 번 승인하고 도구 메시지를 살펴보세요. 검색 요약을 최종 근거로 삼지 않고 Fetch한 페이지의 본문이 답을 뒷받침하는지 확인합니다.
어댑터는 deepseek_search와 deepseek_fetch를 공개합니다. 도구 ID는 Roo가 서버에서 탐색한 이름과 일치해야 합니다. 서버 연결은 성공해도 disabledTools의 오타나 모드 권한 때문에 원하는 기능이 보이지 않을 수 있습니다. 동작에 익숙해질 때까지 alwaysAllow를 비워 두세요. 프롬프트를 줄여야 한다면 정책에 따라 특정 읽기 전용 도구만 자동 허용합니다. Roo는 disabledTools로 도구를 숨기고 alwaysAllow로 자동 승인을 설정합니다. Roo MCP 서버 필드
연결 점검은 DeepSeek에 요청을 보내지 않습니다. 도구가 API 요청을 보낼 때 인증이 확인되고 요금이 발생합니다. 여러 요청을 실행하기 전에 DeepSeek의 최신 Search 및 Fetch 가이드를 읽어 보세요.
일회성 셸 검색을 Roo 도구와 분리하기
가끔만 검색한다면 Roo 터미널이나 개인 터미널에서 Claude Code 설정 가이드의 헬퍼를 실행합니다.
node --env-file=/Users/you/.config/deepseek-search/.env \
/Users/you/.local/share/deepseek-search/search-cli.mjs \
search "Roo Code MCP project configuration" 3선택한 URL은 헬퍼의 fetch 명령으로 가져옵니다. 이 방법은 Roo에 호출 가능한 도구를 추가하지 않습니다. 작업 중 Roo가 직접 조사하길 원한다면 MCP를 사용하세요. API 요청 본문을 직접 살펴보고 싶다면 cURL로 한 번만 요청할 수도 있습니다.
실패한 설정 계층 바로잡기
Roo에 서버가 연결되지 않았다고 표시되면 VS Code를 실행하는 동일한 계정에서 Node, 어댑터, 환경 파일 경로를 확인합니다. 서버는 연결되었는데 Search 도구가 없다면 올바른 워크스페이스를 열었는지, 같은 이름의 프로젝트 항목이 전역 설정을 덮어쓰는지, 현재 모드에 MCP가 포함되는지 확인하세요. 도구는 있지만 인증 요청이 실패한다면 비공개 키 파일을 업데이트하고 서버를 다시 시작하거나 불러옵니다.
원하는 범위에 설정이 있고 Roo가 사용하는 모드에서 두 도구를 모두 찾으며, 검토된 Search → Fetch 테스트가 가져온 출처를 인용하면 설정이 끝난 것입니다. 비공개 검색어나 저장소 세부 정보를 공개 검색 프롬프트에 넣지 말고, 검색한 웹 페이지는 Roo에 대한 지시가 아니라 참고 자료로 취급하세요.
저자: Victor Lane. Auspia에서 300회 이상 GEO 준비도 리뷰를 수행한 감사 전문가입니다. AI 검색 워크플로를 위한 실용적인 준비 점검과 명확한 진단 가이드를 씁니다.
더 많은 DeepSeek Search 설정 가이드
관련 플랫폼 가이드: 범위를 지정한 MCP 도구로 OpenCode에 DeepSeek Search 추가하기 · Warp Agent에 MCP 및 Profile로 DeepSeek Search 추가하기
