Perplexity API 플랫폼 MCP 서버

Perplexity API 플랫폼을 위한 공식 MCP 서버 구현체로, Sonar 모델과 검색 API를 통해 AI 어시스턴트에게 실시간 웹 검색, 추론 및 조사 기능을 제공합니다.

사용 가능한 도구

perplexity_search

Perplexity 검색 API를 사용한 직접적인 웹 검색입니다. 메타데이터가 포함된 순위가 지정된 검색 결과를 반환하며, 최신 정보를 찾는 데 적합합니다.

perplexity_ask

sonar-pro 모델을 사용하여 실시간 웹 검색을 수행하는 범용 대화형 AI입니다. 빠른 질문과 일상적인 검색에 유용합니다.

perplexity_research

sonar-deep-research 모델을 사용한 심층적이고 포괄적인 조사입니다. 철저한 분석과 상세한 보고서 작성에 이상적입니다.

perplexity_reason

sonar-reasoning-pro 모델을 사용한 고급 추론 및 문제 해결입니다. 복잡한 분석 작업에 적합합니다.

구성

API 키 가져오기

1. API 포털에서 Perplexity API 키를 받으세요.

2. 아래 구성에서 your_key_here를 본인의 API 키로 교체하세요.

3. (선택 사항) 타임아웃 설정: PERPLEXITY_TIMEOUT_MS=600000 (기본값: 5분)

4. (선택 사항) 사용자 지정 기본 URL 설정: PERPLEXITY_BASE_URL=https://your-custom-url.com (기본값: https://api.perplexity.ai)

5. (선택 사항) 로그 레벨 설정: PERPLEXITY_LOG_LEVEL=DEBUG|INFO|WARN|ERROR (기본값: ERROR)

Claude Code

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

또는 플러그인을 통해 설치:

export PERPLEXITY_API_KEY="your_key_here"
claude
# Then run: /plugin marketplace add perplexityai/modelcontextprotocol
# Then run: /plugin install perplexity

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 래퍼를 사용하여 수동으로 구성할 수 있습니다(Cursor의 경우와 같이). 클라이언트의 스키마가 다른 경우, 해당 문서에서 정확한 래퍼 형식을 확인하세요.

수동 설정을 위해 이러한 클라이언트는 모두 동일한 mcpServers 구조를 사용합니다:

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

프록시 설정 (기업 네트워크용)

회사 내부에서 이 서버를 실행하는 경우(특히 회사 방화벽이나 프록시 뒤에 있는 경우), 프로그램이 네트워크 프록시를 통해 인터넷 트래픽을 보내도록 설정해야 할 수 있습니다. 다음 단계를 따르세요:

1. 프록시 세부 정보 확인

• IT 부서에 HTTPS 프록시 주소와 포트를 문의하세요.

• 사용자 이름과 비밀번호가 필요할 수도 있습니다.

2. 프록시 환경 변수 설정

Perplexity MCP의 경우 가장 쉽고 안정적인 방법은 PERPLEXITY_PROXY를 사용하는 것입니다. 예:

export PERPLEXITY_PROXY=https://your-proxy-host:8080

프록시에 사용자 이름과 비밀번호가 필요한 경우:

export PERPLEXITY_PROXY=https://username:password@your-proxy-host:8080

3. 대안: 표준 환경 변수

표준 변수를 사용하려면 HTTPS_PROXY 및 HTTP_PROXY를 지원합니다.

HTTP 서버 배포

클라우드 또는 공유 배포의 경우 서버를 HTTP 모드로 실행하세요.

환경 변수

Docker

docker build -t perplexity-mcp-server .
docker run -p 8080:8080 -e PERPLEXITY_API_KEY=your_key_here perplexity-mcp-server

Node.js

export PERPLEXITY_API_KEY=your_key_here
npm install && npm run build && npm run start:http

서버는 http://localhost:8080/mcp에서 액세스할 수 있습니다.

문제 해결

• API 키 문제: PERPLEXITY_API_KEY가 올바르게 설정되었는지 확인하세요.

• 연결 오류: 인터넷 연결 및 API 키 유효성을 확인하세요.

• 도구를 찾을 수 없음: 패키지가 설치되어 있고 명령 경로가 올바른지 확인하세요.

• 타임아웃 오류: 매우 긴 조사 쿼리의 경우 PERPLEXITY_TIMEOUT_MS를 더 높은 값으로 설정하세요.

• 프록시 문제: PERPLEXITY_PROXY 또는 HTTPS_PROXY 설정을 확인하고 api.perplexity.ai가 방화벽에 의해 차단되지 않았는지 확인하세요.

• EOF / 초기화 오류: 일부 엄격한 MCP 클라이언트는 npx가 설치 메시지를 stdout에 쓰기 때문에 실패합니다. 이 출력을 억제하려면 npx -y 대신 npx -yq를 사용하세요.

지원이 필요하면 community.perplexity.ai를 방문하거나 이슈를 제기하세요.