Perplexity MCP 실전 가이드 — Claude에 실시간 웹 검색 붙이기

Claude는 학습 데이터 cutoff가 있어요. 2026년 4월 기준으로 최신 뉴스, 새 라이브러리 업데이트, 실시간 에러 해결법을 모르는 경우가 생겨요.

나: "Next.js 15.2 새로 추가된 기능 뭐야?"
Claude: "죄송합니다, 해당 버전에 대한 정보가 없어요."

나: "오늘 발생한 npm 취약점 CVE 알려줘"
Claude: "최신 보안 정보에 접근할 수 없어요."

Perplexity MCP 연결하면 이렇게 바뀌어요.

나: "Next.js 15.2 새로 추가된 기능 뭐야?"
Claude: (Perplexity 실시간 검색)
→ 공식 changelog + 커뮤니티 분석까지 종합해서
  정확한 최신 정보 답변

---

Brave Search vs Perplexity 차이

먼저 뭘 써야 할지 정리해요.

Brave Search MCP:
→ 웹 검색 결과 원본 반환
→ Claude가 직접 분석
→ 무료 티어 넉넉함
→ 단순 검색에 적합

Perplexity MCP:
→ 검색 + AI 분석 + 출처 인용까지 한번에
→ Perplexity의 Sonar 모델이 먼저 분석하고 정리해서 줌
→ 유료 ($5/1000 요청)
→ 복잡한 리서치, 심층 분석에 적합

단순히 "이 에러 왜 났어?" → Brave Search 충분해요. "이 기술 트렌드 종합 분석해줘" → Perplexity가 더 나아요.

---

설치 — 공식 Perplexity MCP

# API 키 발급
# perplexity.ai → API → Generate Key

# Claude Code에 등록 (공식 패키지)
claude mcp add perplexity \
  --env PERPLEXITY_API_KEY="pplx-your_key_here" \
  -- npx -y @perplexity-ai/mcp-server

// .claude/mcp.json
{
  "mcpServers": {
    "perplexity": {
      "command": "npx",
      "args": ["-y", "@perplexity-ai/mcp-server"],
      "env": {
        "PERPLEXITY_API_KEY": "${PERPLEXITY_API_KEY}"
      }
    }
  }
}

---

Perplexity 모델 종류

sonar              → 기본 검색. 빠름. 일반 질문
sonar-pro          → 심층 검색. 더 정확한 출처
sonar-reasoning-pro → 검색 + 복잡한 추론. 느리지만 정확
sonar-deep-research → 다단계 심층 리서치. 30~60초. 종합 분석

기본값은 sonar예요. 대부분 이걸로 충분해요.

---

실전 사용 예시

1 — 최신 에러 해결

나: "prisma migrate dev 실행했더니 이 에러 나.
     'P3009: migrate found failed migration' 어떻게 해결해?"

Claude:
(Perplexity 검색: prisma P3009 migrate failed 2026)
→ 최신 GitHub Issues + StackOverflow 종합
→ "2026년 1월 Prisma 6.x 이후 발생하는 알려진 이슈.
   해결법:
   1. prisma migrate resolve --rolled-back '마이그레이션명'
   2. 또는 shadow DB 설정 확인..."
→ 실제 코드로 수정까지

Claude 혼자였으면 "Prisma 구버전 기준으로 알고 있어요"라고 했을 거예요.

---

2 — 라이브러리 최신 버전 확인

나: "Fastify 5에서 인증 미들웨어 어떻게 써?"

Claude:
(Perplexity: fastify 5 authentication middleware 2026)
→ 공식 문서 + 커뮤니티 예시 종합
→ Fastify 5 기준 정확한 코드 생성

# 없었다면:
→ Fastify 4 기준 deprecated API로 코드 생성

---

3 — 보안 취약점 실시간 확인

나: "오늘 npm 패키지 취약점 새로 나온 거 있어?"

Claude:
(Perplexity: npm security vulnerability today 2026-04-14)
→ "오늘 CVE-2026-xxxx 발표됨
   영향 패키지: lodash <4.17.22
   심각도: High
   즉시 업데이트 권장"
→ package.json 자동 확인 → 취약 패키지 업데이트

---

4 — 기술 의사결정 리서치

나: "2026년 기준 Node.js 백엔드 인증 라이브러리
     뭐 쓰는 게 좋아? 비교해줘"

Claude:
(Perplexity: nodejs authentication library comparison 2026)
→ 최신 npm 트렌드 + 커뮤니티 의견 종합
→ "2026년 기준:
   - better-auth: 가장 빠르게 성장 중, TypeScript 네이티브
   - lucia: 가볍고 유연함
   - next-auth v5: Next.js 프로젝트 표준
   우리 스택(Fastify + Prisma)에는 better-auth 권장"

---

5 — 심층 리서치 (sonar-deep-research)

복잡한 기술 결정이 필요할 때 써요.

나: "마이크로서비스 vs 모놀리식 2026년 트렌드 분석해줘.
     우리 팀 5명, B2B SaaS, 초기 스타트업 기준으로"

Claude:
(Perplexity sonar-deep-research 실행, 약 45초)
→ 최신 사례 + 전문가 의견 + 비용 분석 종합
→ "2026년 트렌드:
   - 5인 이하 팀 82%가 모놀리식으로 시작 후 분리
   - Shopify, GitHub 모두 모놀리식에서 시작
   초기 스타트업 기준 모놀리식 강력 권장.
   이유: 개발 속도 3배, 운영 복잡도 70% 낮음..."

---

CLAUDE.md에 Perplexity 활용 규칙 추가

# CLAUDE.md

## Perplexity 검색 규칙
다음 상황에서 자동으로 Perplexity 검색:
- 에러 메시지 + "최신" 또는 버전 번호 포함 시
- "요즘", "최근", "2026" 포함 시
- 라이브러리 버전 관련 질문
- 보안 취약점 관련 질문

검색 불필요한 경우 (기존 지식 사용):
- 기본 알고리즘/자료구조
- SQL 기본 문법
- 일반적인 코딩 패턴

이 규칙 추가하면 Claude가 알아서 필요한 때만 Perplexity를 불러요.

---

비용 계산

Sonar 기본: $1/1000 요청
Sonar Pro: $5/1000 요청
Sonar Deep Research: $2/M input + $8/M output

하루 20번 검색 기준:
→ 월 600회 → 약 $0.6~$3/월
→ 웬만해서 $5 안 넘음

Context7이랑 같이 쓰면 상호보완이 돼요.

Context7: 라이브러리 공식 문서 (빠름, 무료)
Perplexity: 복잡한 리서치, 최신 뉴스 (느림, 유료)

---

전후 비교

Perplexity MCP 전:

에러 발생
→ 구글 검색 (탭 전환)
→ StackOverflow 읽기
→ 해결책 복사
→ Claude에 붙여넣기
→ "이 해결책 적용해줘"
(5~10분)

Perplexity MCP 후:

나: "이 에러 수정해줘"
Claude: (Perplexity 자동 검색) → 최신 해결책 → 코드 수정
(1분)

---