Perplexity MCP 는 무엇인가요?

Perplexity 가 직접 운영하는 공식 MCP 서버로, Claude 에 실시간 웹 검색·대화형 답변·심층 리서치·고급 추론 능력을 제공합니다. Sonar 계열 모델(`sonar-pro`·`sonar-deep-research`·`sonar-reasoning-pro`) 과 Search API 를 사용합니다.

어떤 환경에서 동작하나요?

Claude Code·Claude Desktop·Codex·Cursor·Kiro·Windsurf·VS Code 에서 동작합니다. 표준 MCP 클라이언트라면 manual JSON 설정으로도 연결 가능합니다.

어떻게 설치하나요?

Claude Code 에서는 `claude mcp add perplexity --env PERPLEXITY_API_KEY="..." -- npx -y @perplexity-ai/mcp-server` 한 줄이면 됩니다. Codex 는 `codex mcp add`, Docker 와 HTTP 서버 배포 방식도 지원합니다.

API 키는 어디서 받나요?

https://www.perplexity.ai/account/api/group 에서 발급받아 `PERPLEXITY_API_KEY` 환경변수에 설정합니다.

어떤 도구가 제공되나요?

`perplexity_search`(직접 웹 검색), `perplexity_ask`(`sonar-pro` 기반 대화형 답변), `perplexity_research`(`sonar-deep-research` 기반 심층 리서치), `perplexity_reason`(`sonar-reasoning-pro` 기반 고급 추론) 네 가지입니다. 마지막 두 도구는 `strip_thinking` 옵션으로 thinking 태그를 제거해 토큰을 절감할 수 있습니다.

라이선스는 어떻게 되나요?

MIT 라이선스로 공개되어 있습니다. Perplexity API 비용은 별도로 발생하므로 [Perplexity 공식 문서](https://docs.perplexity.ai/) 의 요금 안내를 참고하세요.

Perplexity MCP — ClaudeKit

왜 필요한가?

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-server

Codex — 동일 패턴.

codex mcp add perplexity \
  --env PERPLEXITY_API_KEY="your_key_here" \
  -- npx -y @perplexity-ai/mcp-server

Cursor · 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 라이선스 — 영리 사용 포함 자유 활용 가능.

Perplexity MCP