왜 필요한가?
Claude 의 학습 데이터에는 시점 컷오프가 있어, 최신 뉴스·문서·릴리스 정보가 필요한 질문에는 직접 답을 만들 수 없습니다. 보통 별도 검색 도구나 브라우저를 띄워 결과를 직접 옮기는 흐름이 반복됐는데, Perplexity MCP 는 Claude 안에서 바로 실시간 웹 검색·리서치를 수행할 수 있게 해 그 분리된 흐름을 없앱니다.
특히 Perplexity 의 Sonar 모델은 검색 결과를 그대로 던지는 게 아니라 답을 합성하므로, Claude 가 검색 결과 페이지를 다시 일일이 읽지 않아도 됩니다.
핵심 기능 — 4 가지 도구
-
perplexity_search— 직접 웹 검색Perplexity Search API 로 랭크된 검색 결과를 그대로 반환합니다. 가공 없이 원본 결과가 필요할 때 사용합니다.
-
perplexity_ask— 실시간 웹 검색 기반 대화형 답변sonar-pro모델이 검색 + 답 합성을 한 번에 수행합니다. 일반 질의응답에 가장 자주 사용되는 기본 도구입니다. -
perplexity_research— 심층 리서치sonar-deep-research모델로 여러 출처를 종합한 긴 호흡의 리서치 결과를 생성합니다. 단일 질문이 아니라 주제 전반을 다룰 때 적합합니다. -
perplexity_reason— 고급 추론sonar-reasoning-pro모델이 검색 결과 위에서 추가 추론 단계를 거쳐 답합니다.
perplexity_research 와 perplexity_reason 은 strip_thinking (boolean) 옵션을 받아 thinking 태그를 제거해 토큰 사용량을 줄일 수 있습니다.
설치 방법
Claude Code (권장) — 한 줄로 설치·등록.
claude mcp add perplexity \
--env PERPLEXITY_API_KEY="your_key_here" \
-- npx -y @perplexity-ai/mcp-serverCodex — 동일 패턴.
codex mcp add perplexity \
--env PERPLEXITY_API_KEY="your_key_here" \
-- npx -y @perplexity-ai/mcp-serverCursor · Claude Desktop · Kiro · Windsurf · VS Code — 각 클라이언트의 mcpServers JSON 설정에 추가 (파일 위치는 클라이언트마다 다름).
Docker · HTTP 서버 — 공유 환경·클라우드 배포용. docker build 후 docker run -p 8080:8080 -e PERPLEXITY_API_KEY=... 로 띄우거나, npm install && npm run build && npm run start:http 로 직접 HTTP 모드 실행.
환경 변수
| 변수 | 필수 | 기본값 | 설명 |
|---|---|---|---|
PERPLEXITY_API_KEY | ✅ | — | API 키. https://www.perplexity.ai/account/api/group 에서 발급 |
PERPLEXITY_TIMEOUT_MS | 5 분 | API 호출 타임아웃 | |
PERPLEXITY_BASE_URL | https://api.perplexity.ai | 커스텀 엔드포인트 | |
PERPLEXITY_LOG_LEVEL | ERROR | DEBUG·INFO·WARN·ERROR 중 선택 | |
PERPLEXITY_PROXY / HTTPS_PROXY / HTTP_PROXY | — | 사내 프록시 환경에서 사용. 형식: https://[username:password@]host:port |
HTTP 서버 배포 시 추가: PORT (기본 8080), BIND_ADDRESS (기본 0.0.0.0), ALLOWED_ORIGINS.
알아두면 좋은 점
- 공식 Perplexity 운영 —
github.com/perplexityai조직이 직접 배포·유지하므로 비공식 래퍼와 구분됩니다. - API 사용량은 Perplexity 측에서 별도 과금 — Anthropic 의 Claude 토큰과 별개로 Perplexity API 호출량이 누적됩니다. 비용 추적이 중요한 환경에서는 두 플랫폼의 대시보드를 별도로 확인하세요.
- 사내 프록시 지원 —
PERPLEXITY_PROXY/HTTPS_PROXY/HTTP_PROXY어느 변수에 넣어도 인식됩니다. strip_thinking으로 토큰 절감 — research / reason 도구는 기본적으로 thinking 태그를 결과에 포함합니다. 최종 답만 필요할 때는 옵션을 켜 토큰을 줄이는 게 안전합니다.- MIT 라이선스 — 영리 사용 포함 자유 활용 가능.