Goose Desktop과 CLI에서 DeepSeek Search 사용하기

설정이 어렵다면 이 가이드를 Goose에 전달해 구성을 요청하세요. 먼저 기존 확장 목록을 확인하고 어댑터 항목을 준비하되, API 키는 로컬 비밀 입력란에 직접 넣도록 하세요. 키를 대화에 붙여 넣지 마세요.

Use this guide to add DeepSeek Search to Goose. Inspect my existing extension
configuration first and preserve it. Add the local adapter as a stdio MCP
extension, read the API key from a private env file or Goose's extension
secrets, and keep it disabled by default until I choose a session. Do not
print the secret or make any billable request without my approval. Show me how
to verify Search and Fetch.

Goose에서는 MCP 서버를 확장 프로그램으로 취급합니다. 따라서 확장 프로그램 목록에 계속 등록해 두거나, 선택한 세션에서만 켜거나, CLI 한 번 실행에만 연결할 수 있습니다. 마지막 방법은 기본 확장 프로그램 구성을 바꾸지 않고 가끔 조사할 때 편리합니다. Goose는 데스크톱 확장 프로그램 관리자와 CLI의 goose configure를 모두 지원합니다.Goose 확장 프로그램 문서

어댑터를 한 번 설치하기

DeepSeek Search는 HTTP API입니다. Goose에서 호출 가능한 두 개의 별도 도구로 사용하려면 로컬 MCP 어댑터가 필요합니다. 전체 코드와 터미널 도우미는 Claude Code DeepSeek Search 가이드를 참고하세요. Node.js 22 이상을 사용해 비공개 전용 디렉터리에 고정 버전 의존성을 설치합니다. 비공개 환경 파일에 DEEPSEEK_API_KEY=...를 넣고, Goose YAML 파일이나 공유 프로젝트에 키를 저장하지 마세요.

계속 사용하려면 Goose의 ~/.config/goose/config.yaml 파일에 extensions 맵을 설정할 수 있습니다. 기존 파일을 덮어쓰지 말고 다음 항목을 병합한 뒤 절대 경로를 실제 환경에 맞게 바꾸세요.

extensions:
  deepseek-search:
    name: DeepSeek Search
    cmd: node
    args:
      - --env-file=/Users/you/.config/deepseek-search/.env
      - /Users/you/.local/share/deepseek-search/server.mjs
    enabled: false
    type: stdio
    timeout: 60

enabled: false를 사용하면 새 세션마다 확장 프로그램이 기본으로 로드되지 않습니다. 이 확장 프로그램은 표준 입력/출력으로 연결하는 MCP 서버이므로 API 전용 플러그인은 필요하지 않습니다. Goose 문서에는 stdio 확장 프로그램의 cmd, args, type, enabled, timeout 필드가 설명되어 있습니다.Goose 확장 설정

사용할 화면을 선택하기

Goose Desktop에서 Extensions를 열고 Add custom extension을 선택한 뒤 어댑터 명령과 인수를 입력하고 Standard IO 유형을 지정합니다. 확장 프로그램 양식에 키를 직접 주입할 때만 환경 변수도 추가하세요. 그렇지 않으면 명령 인수에서 환경 파일 경로를 지정하면 됩니다. 적절한 시간 제한을 설정하고 저장한 뒤 Extensions 패널에서 활성화 여부를 전환할 수 있습니다.

Goose CLI에서는 goose configure를 실행하고 Add Extension, 다음으로 Command-Line Extension을 선택합니다. ID는 deepseek-search, 명령은 node로 지정하고 각 인수를 별도로 추가합니다. 기본 목록에서 비활성 상태로 두었다면 여러 세션에서 사용할 때 Toggle Extensions 흐름으로 켜세요.Goose CLI 확장 설정

한 세션에서만 사용하려면 기본 확장 프로그램으로 설치할 필요가 없습니다. 현재 CLI는 로컬 확장 명령을 지정해 세션을 시작할 수 있습니다.

goose session --with-extension "deepseek-search: node --env-file=/Users/you/.config/deepseek-search/.env /Users/you/.local/share/deepseek-search/server.mjs"

Goose CLI 참조 문서는 stdio 확장 프로그램에 --with-extension을 사용한다고 안내합니다. 원격 MCP 엔드포인트에는 --with-streamable-http-extension도 있습니다. 이 어댑터는 로컬 stdio 프로세스이므로 --with-extension을 사용하세요.Goose CLI 명령

DeepSeek Search를 기본으로 불러올지, 선택한 세션에서만 사용할지 정할 수 있습니다.

유료 요청 전에 도구 검색을 확인하기

확장 프로그램을 활성화하고 Goose의 새 세션을 시작한 다음 사용 가능한 DeepSeek 도구를 나열해 달라고 요청하세요. 어댑터는 deepseek_search와 deepseek_fetch를 제공해야 합니다. 이어서 범위를 좁혀 공식 문서를 검색하고 결과 중 한 페이지를 가져오게 한 뒤, 최종 답변에 가져온 URL을 인용하도록 요청하세요.

Goose는 세션 중 확장 프로그램 사용 가능 여부를 바꿀 수 있지만, 현재 세션에만 적용되는 전환과 다음 세션의 기본 설정은 다릅니다. 설정을 수정했다고 이미 열려 있는 채팅 상태까지 바뀌었을 것이라 가정하지 말고 현재 세션에서 확장 프로그램이 켜져 있는지 확인하세요. 확장 프로그램이 성공적으로 시작됐다는 사실은 Goose가 어댑터를 실행하고 도구를 찾았다는 의미일 뿐, DeepSeek API 인증에 성공했다는 뜻은 아닙니다. 실제 호출에는 본인의 키가 필요하며 DeepSeek의 최신 Search 및 Fetch API 요금이 적용될 수 있습니다.

확장 연결을 확인한 것만으로는 DeepSeek 실시간 API 요청이 이뤄지지 않습니다.

Goose에 도구가 필요 없다면 CLI 도우미 사용하기

직접 조사할 때는 Claude Code 튜토리얼의 공용 search-cli.mjs 유틸리티를 사용할 수 있습니다.

node --env-file=/Users/you/.config/deepseek-search/.env \
  /Users/you/.local/share/deepseek-search/search-cli.mjs \
  search "Goose custom MCP extension configuration" 3

선택한 URL은 같은 도우미의 fetch 명령으로 가져오면 됩니다. 결과를 직접 확인하거나 Goose 확장 프로그램을 추가로 켜고 싶지 않을 때 유용합니다. 별도로 명령 확장 프로그램을 만들지 않는 한 Goose는 이 셸 명령을 이름 있는 도구로 호출할 수 없습니다. 에이전트가 직접 검색하게 하려면 MCP 어댑터가 더 직관적인 방법입니다.

확장 프로그램이 시작되지 않으면 먼저 터미널에서 명령과 경로가 올바른지, Goose 프로세스가 환경 파일을 읽을 수 있는지 확인하세요. 도구가 표시되지 않으면 현재 세션에서 확장 프로그램이 활성화되어 있는지, 서버 ID와 명령이 올바르게 저장됐는지 점검합니다. API가 요청을 거부하면 로컬에서 키를 수정한 다음 확장 프로그램을 다시 시작하세요. 환경 파일을 공유하거나 요청 헤더를 Goose에 복사하지 마세요.

선택한 화면에서 Goose가 두 도구를 찾고, 확인 절차를 거친 Search → Fetch 테스트를 출처 URL과 함께 완료하면 설정이 끝납니다. 필요한 확장 프로그램만 접근을 허용하세요. Goose의 개발 도구는 파일을 수정하고 명령을 실행할 수 있으므로 웹 조사와 코드 작업을 함께 할 때 권한 제어를 사용하세요.

작성자: Camille Rhodes, Auspia에서 300개 이상의 AI 콘텐츠 워크플로를 설계했습니다. 실용적인 AI 지원 워크플로, 자동화, 안정적인 콘텐츠 게시 시스템을 다룹니다.

다른 DeepSeek Search Agent 설정 가이드

전체 Agent 설정 가이드 보기

관련 플랫폼 가이드: Google Antigravity에 DeepSeek Search 연결하기 · Hermes Agent에서 DeepSeek Search 사용하기.