setup

Setup

[MARKET-RESEARCH SETUP 활성화]

목표

market-research 플러그인의 필수 도구(Brave Search MCP 서버)를 설치함.

활성화 조건

사용자가 /market-research:setup 호출 시.

사용자 상호작용

AskUserQuestion 도구를 활용하여 설정 옵션을 확인함:

• Brave Search API Key 입력 안내

워크플로우

Step 1: 사전 확인

1. gateway/install.yaml을 읽어 설치 대상 확인
2. 이미 설치된 MCP 서버가 있는지 확인 (claude mcp list)

Step 2: Brave Search MCP 서버 설치

1. 사용자에게 Brave Search API Key 보유 여부 확인
   • 미보유 시: https://brave.com/search/api/ 에서 API Key 발급 안내
2. gateway/mcp/brave-search.json 설정 파일을 참조하여 MCP 서버 등록
3. 설치 명령 실행:

   claude mcp add-json brave-search '{"command":"npx","args":["-y","@brave/brave-search-mcp-server"],"env":{"BRAVE_API_KEY":"<사용자 입력 API Key>"}}'  --scope user
   

4. 설치 결과 확인 (claude mcp list)

Step 3: 설치 완료 확인

설치 결과 요약 보고:

• Brave Search MCP 서버 설치 상태
• /market-research:help로 사용 가능한 명령 확인 안내

문제 해결

문제	해결 방법
npx 미설치	npm install -g npx 실행 안내
API Key 오류	https://brave.com/search/api/ 에서 재발급 안내
MCP 등록 실패	claude mcp remove brave-search 후 재등록 안내