클로드 코드(Claude Code)에 웹 검색을 붙여 보신 분이라면 한 번쯤 들어 보셨을 도구가 Perplexity입니다. 일반 키워드 검색을 넘어 “여러 출처를 종합해 정리된 답”을 돌려주는 데 강점이 있어서, 리서치·트러블슈팅·자료 조사 같은 작업에 자주 쓰입니다. 다행히 Perplexity는 공식 MCP 서버를 직접 배포하기 때문에 클로드 코드에 깔끔하게 연결할 수 있습니다. 설치, 키 발급, 도구별 차이, 실제 사용 패턴까지 한 번에 정리해 드립니다.
목차
Perplexity MCP가 뭔가요
Perplexity MCP는 클로드 코드 안에서 Perplexity API를 호출할 수 있게 해 주는 공식 서버입니다. 호출되면 Perplexity의 Sonar 계열 모델이 실시간 웹을 검색하고, 결과를 인용 번호와 함께 정리된 답으로 돌려줍니다.
핵심 특징은 다음 두 가지입니다.
- 검색 + AI 요약 일체형: 검색 결과를 그대로 던지지 않고, Perplexity가 한 번 정리·요약해서 답합니다.
- 인용 번호 표기: 답변에 [1][2] 같은 인용이 자동으로 붙어, 출처 추적이 쉽습니다.
그래서 단순 키워드 검색보다는 “정리된 결론”이 필요한 리서치 작업에서 빛이 납니다.
설치 전 준비물
설치 자체는 한 줄이지만 다음 두 가지를 먼저 갖추셔야 합니다.
- Node.js 18 이상:
node -v로 확인하시고, 미설치라면 nodejs.org에서 LTS를 받으십시오. - Perplexity API 키: Perplexity API 설정 페이지에서 발급. 카드 등록과 일정 크레딧 충전이 필요합니다.
발급받은 키는 pplx-로 시작하는 문자열입니다. 외부에 노출되지 않도록 환경변수나 설정 파일에서만 다루십시오.
설치 두 가지 방법
공식 npm 패키지명은 @perplexity-ai/mcp-server입니다. 어느 방식으로 설치하셔도 동일하게 동작합니다.
방법 1: claude mcp 명령으로 추가
가장 간단한 방법입니다. 클로드 코드 세션에서 한 줄로 끝납니다.
claude mcp add --scope user perplexity --env PERPLEXITY_API_KEY="pplx-..." -- npx -y @perplexity-ai/mcp-server
모든 프로젝트에서 쓰고 싶으시면 --scope user, 특정 프로젝트에만 두고 싶으시면 옵션을 빼거나 --scope local로 두십시오.
방법 2: .mcp.json 직접 편집
팀과 공유할 프로젝트라면 저장소 루트의 .mcp.json에 적어 두는 편이 깔끔합니다. 키는 환경변수 참조 형태로 분리해 두면 Git에 올라가도 노출되지 않습니다.
| 키 | 값 |
|---|---|
| command | /opt/homebrew/bin/npx (본인 시스템 npx 경로) |
| args | [“-y”, “@perplexity-ai/mcp-server”] |
| env.PERPLEXITY_API_KEY | ${PERPLEXITY_API_KEY} 환경변수 참조 권장 |
설치 후 확인
설치 직후 다음으로 정상 등록 여부를 확인하십시오.
- 등록 확인:
claude mcp list— perplexity가 활성 상태로 보여야 합니다. - 호출 테스트: 클로드 코드 세션을 새로 띄운 뒤 “Perplexity로 OpenAI 최신 모델 발표 정리해 줘”처럼 자연어로 요청. 자동완성에
mcp__perplexity__perplexity_ask같은 도구가 잡히면 정상입니다.
안 보이면 세션을 완전히 재시작하시고, 그래도 문제가 있으면 claude --debug로 띄워 어떤 MCP가 로드되는지 직접 확인하십시오.
제공되는 도구 4가지
Perplexity MCP는 한 가지 도구가 아니라 작업 성격에 따라 골라 쓸 수 있는 도구를 함께 제공합니다.
| 도구 | 역할 | 속도 | 대표 사용 시점 |
|---|---|---|---|
| perplexity_ask | 빠른 질문 답변 (Sonar Pro) | 빠름 | 일상적 사실 확인, 인용 포함 Q&A |
| perplexity_search | URL·뉴스·사실 찾기 | 빠름 | 출처 자체가 필요할 때 |
| perplexity_research | 심층 다출처 리서치 | 느림(30초+) | 블로그·보고서용 자료 모음 |
| perplexity_reason | 단계별 추론·분석 | 중간 | 복잡한 비교·의사결정 |
대부분의 경우 perplexity_ask로 충분합니다. 자료가 많이 필요하면 perplexity_research, 단순 URL을 빠르게 찾고 싶으면 perplexity_search를 쓰십시오.
유용한 호출 옵션
Perplexity MCP는 검색을 미세 조정할 수 있는 옵션도 같이 제공합니다. 기본값으로 시작하시고, 필요할 때 다음 옵션을 명시적으로 지정하시면 됩니다.
- search_recency_filter: 결과를 시간 범위로 제한.
hour·day·week·month·year중 선택. 예: 최신 뉴스만 보고 싶을 때. - search_domain_filter: 특정 도메인에 한정하거나 제외. 예:
["github.com"]만 검색,["-reddit.com"]으로 제외. - search_context_size: 검색 깊이 조절.
low·medium·high. 깊을수록 답이 풍부하지만 토큰 소비가 늘어납니다. - reasoning_effort:
perplexity_research·perplexity_reason의 추론 깊이. 시간과 정확도의 트레이드오프입니다.
실제로 자주 쓰는 패턴
설치 후 자주 활용되는 패턴 몇 가지를 정리해 드립니다.
- 리서치 자료 수집: 블로그 초안 전 “이 주제에 대한 최신 동향과 출처를 정리해 줘”로
perplexity_research한 번 호출. - 오류 메시지 추적: 처음 보는 스택 트레이스를 그대로 던지면 인용과 함께 원인·해결책을 정리.
- 정책·문서 변경 확인:
recency_filter: month로 최근 한 달 안 변경 사항만 골라 검색. - 도메인 한정 조사:
domain_filter: ["docs.anthropic.com"]처럼 공식 문서만 보고 싶을 때.
비용은 어떻게 발생하나
Perplexity MCP는 본인의 Perplexity API 키를 통해 호출되므로, 청구는 Perplexity 계정으로 이루어집니다. 일반적인 특징은 다음과 같습니다.
- 토큰 단위 종량제: 호출량과 컨텍스트 크기에 비례합니다.
search_context_size: high나perplexity_research는 단가가 더 큽니다. - 크레딧 충전 방식: 카드를 등록하고 일정 금액을 미리 충전해 차감되는 구조가 일반적입니다.
- 무료 한도는 작은 편: Google AI Studio의 Gemini와 비교하면 무료 사용 분량은 제한적입니다.
비용에 민감하시다면 평소에는 무료 한도가 큰 도구(예: Gemini Search MCP)로 일반 검색을 처리하시고, “정리된 답”이나 “다출처 리서치”가 꼭 필요한 순간에만 Perplexity를 호출하는 패턴이 가장 효율적입니다.
Gemini Search MCP와 무엇이 다른가
두 도구를 동시에 쓰시는 분이 많아 비교 기준을 따로 정리해 드립니다.
| 구분 | Perplexity MCP | Gemini Search MCP |
|---|---|---|
| 응답 스타일 | 요약된 답 + 인용 번호 | 검색 결과 그라운딩 답 |
| 강점 | 다출처 종합·리서치 | 일반 검색·비용 효율 |
| 무료 한도 | 작음 | 큼 |
| 대표 도구 | perplexity_ask, perplexity_research | google_search |
| 적합 시점 | 정리된 결론 필요 | 일상적 검색·1순위 후보 |
실무에서는 둘 다 깔아 두고 1차로 비용 효율이 좋은 Gemini Search를, 깊이가 필요할 때만 Perplexity를 호출하는 이중 구성이 자주 쓰입니다.
안 될 때 점검 순서
“등록은 됐는데 호출이 안 된다”는 상황의 빠른 진단 순서입니다.
- 1.
claude mcp list로 perplexity가 등록되어 있는지 확인 - 2.
echo $PERPLEXITY_API_KEY로 키가 셸에 잡혀 있는지 확인 - 3. Perplexity API 페이지에서 키 만료·크레딧 잔액 확인
- 4. 클로드 코드 세션 완전히 재시작
- 5. 401·402 에러가 뜬다면 키 권한 또는 결제 문제
- 6. 회사 네트워크에서 외부 API 차단 여부 확인
자주 묻는 질문
Perplexity 웹사이트 구독과 API는 다른가요?
네. Perplexity 웹·앱의 Pro 구독과 API 종량제는 별도 결제입니다. MCP는 API 키만 사용하므로, 구독 회원이라도 API 키는 별도로 발급·결제하셔야 합니다.
perplexity_ask와 perplexity_research 중 뭐가 좋나요?
일상 질의는 perplexity_ask로 충분합니다. 블로그·보고서처럼 여러 출처를 종합해야 한다면 perplexity_research를 쓰시되, 30초 이상 걸릴 수 있고 단가도 더 높다는 점만 감안하십시오.
API 키를 .mcp.json에 그대로 적어도 되나요?
권장하지 않습니다. ${PERPLEXITY_API_KEY}처럼 환경변수 참조 형태로 두시고 실제 값은 본인 셸이나 .env에 보관하시면 Git에 올라가도 키가 함께 노출되지 않습니다.
Gemini Search MCP만 쓰면 안 되나요?
가벼운 검색은 그것만으로 충분합니다. 다만 “정리된 답”과 “출처 인용”이 중요한 작업에서는 Perplexity 쪽이 결과 가공도가 더 높습니다. 둘 다 깔아 두고 상황에 따라 골라 쓰시는 편이 가장 합리적입니다.
정리
Perplexity MCP는 @perplexity-ai/mcp-server 패키지 한 개와 API 키 한 장이면 클로드 코드에 바로 붙일 수 있는 공식 도구입니다. perplexity_ask는 빠른 답, perplexity_research는 깊은 리서치, 그 외 search·reason까지 작업 성격에 맞춰 도구를 골라 쓸 수 있는 점이 특징입니다. 무료 한도가 작은 편이라 비용 부담이 있으니, 무료 도구와 함께 깔아 두고 “정리된 답이 꼭 필요한 순간”에만 Perplexity를 호출하시는 운영이 가장 효율적입니다.