Perplexity

Perplexity API Platform MCP Server

     

การใช้งาน MCP server อย่างเป็นทางการสำหรับ Perplexity API Platform ซึ่งมอบความสามารถในการค้นหาเว็บแบบเรียลไทม์ การให้เหตุผล และการวิจัยให้กับผู้ช่วย AI ผ่าน Agent API และ Search API

Remote MCP Server

Remote MCP server โฮสต์โดย Perplexity และเป็นวิธีที่ง่ายที่สุดในการเริ่มต้นใช้งาน: เครื่องมือเดียวกัน ไม่ต้องติดตั้งหรืออัปเดตอะไร ปุ่ม Cursor และ VS Code ที่ด้านบนของหน้านี้เชื่อมต่อได้ด้วยคลิกเดียว หาก MCP client ของคุณยังไม่รองรับ remote server ให้ข้ามไปที่การตั้งค่า local server ด้านล่าง เชื่อมต่อผ่าน Streamable HTTP ด้วย Perplexity API key ของคุณ:

https://api.perplexity.ai/mcp

สำหรับ Claude Code:

claude mcp add --transport http perplexity https://api.perplexity.ai/mcp --header "Authorization: Bearer YOUR_API_KEY"

ดู เอกสารการผสานรวม MCP สำหรับการกำหนดค่า Cursor/VS Code ด้วยตนเอง การใช้งานจาก Anthropic API และการตั้งค่าสำหรับ client อื่นๆ

Local MCP Server

รับ API Key ของคุณ

1. รับ Perplexity API Key ของคุณจาก API Portal
2. แทนที่ your_key_here ในการกำหนดค่าด้านล่างด้วย API key ของคุณ
3. (ไม่บังคับ) ตั้งค่า timeout: PERPLEXITY_TIMEOUT_MS=600000 (ค่าเริ่มต้น: 5 นาที)
4. (ไม่บังคับ) ตั้งค่า base URL ที่กำหนดเอง: PERPLEXITY_BASE_URL=https://your-custom-url.com (ค่าเริ่มต้น: https://api.perplexity.ai)
5. (ไม่บังคับ) ตั้งค่าระดับ log: 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

หรือติดตั้งผ่าน plugin:

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

MCP Client อื่นๆ

Client ส่วนใหญ่สามารถกำหนดค่าด้วยตนเองได้โดยใช้ mcpServers wrapper เดียวกันในการกำหนดค่า client ของตน (ตามที่แสดงสำหรับ Cursor) หาก client มี schema ที่แตกต่างกัน ให้ตรวจสอบเอกสารของ client นั้นสำหรับรูปแบบ wrapper ที่แน่นอน

สำหรับการตั้งค่าด้วยตนเอง client เหล่านี้ทั้งหมดใช้โครงสร้าง mcpServers เดียวกัน:

Client	ไฟล์กำหนดค่า
Cursor	~/.cursor/mcp.json
Claude Desktop	claude_desktop_config.json
Kiro	.kiro/settings/mcp.json
Windsurf	~/.codeium/windsurf/mcp_config.json
VS Code	.vscode/mcp.json

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

การตั้งค่า Proxy (สำหรับเครือข่ายองค์กร)

หากคุณรัน server นี้ที่ทำงาน—โดยเฉพาะอย่างยิ่งอยู่หลัง firewall หรือ proxy ของบริษัท—คุณอาจต้องบอกโปรแกรมถึงวิธีส่งการรับส่งข้อมูลอินเทอร์เน็ตผ่าน proxy ของเครือข่ายของคุณ ทำตามขั้นตอนเหล่านี้:

1. รับรายละเอียด proxy ของคุณ

• สอบถามแผนก IT ของคุณสำหรับที่อยู่และพอร์ต HTTPS proxy
• คุณอาจต้องใช้ชื่อผู้ใช้และรหัสผ่านด้วย

2. ตั้งค่าตัวแปรสภาพแวดล้อม proxy

วิธีที่ง่ายและน่าเชื่อถือที่สุดสำหรับ Perplexity MCP คือการใช้ PERPLEXITY_PROXY ตัวอย่างเช่น:

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

หาก proxy ของคุณต้องใช้ชื่อผู้ใช้และรหัสผ่าน ให้ใช้:

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

3. ทางเลือก: ตัวแปรสภาพแวดล้อมมาตรฐาน

หากคุณต้องการใช้ตัวแปรมาตรฐาน เรารองรับ HTTPS_PROXY และ HTTP_PROXY

[!NOTE] Server ตรวจสอบการตั้งค่า proxy ตามลำดับนี้: PERPLEXITY_PROXY → HTTPS_PROXY → HTTP_PROXY หากไม่มีการตั้งค่าใด Server จะเชื่อมต่ออินเทอร์เน็ตโดยตรง URL ต้องรวม https:// พอร์ตทั่วไปคือ 8080, 3128 และ 80

โหมด HTTP แบบโฮสต์เอง

สำหรับการปรับใช้บนคลาวด์หรือแบบแชร์ ให้รัน server ในโหมด HTTP

ตัวแปรสภาพแวดล้อม

ตัวแปร	คำอธิบาย	ค่าเริ่มต้น
PERPLEXITY_API_KEY	Perplexity API key ของคุณ	จำเป็น
PERPLEXITY_BASE_URL	Base URL ที่กำหนดเองสำหรับคำขอ API	https://api.perplexity.ai
PORT	พอร์ต HTTP server	8080
BIND_ADDRESS	อินเทอร์เฟซเครือข่ายที่จะผูก เริ่มต้นที่ loopback ตั้งค่าเป็น 0.0.0.0 เพื่อเปิดเผยบนอินเทอร์เฟซทั้งหมด	127.0.0.1
ALLOWED_ORIGINS	ต้นทาง CORS (คั่นด้วยเครื่องหมายจุลภาค) เริ่มต้นที่ว่างเปล่า (ไม่อนุญาตคำขอข้ามต้นทางจากเบราว์เซอร์) ตั้งค่าเป็นรายการอนุญาตที่ชัดเจน (เช่น https://app.example.com) หรือเป็น * เพื่ออนุญาตทุกต้นทาง	(ว่างเปล่า)
ALLOWED_HOSTS	ค่า header Host เพิ่มเติมที่จะยอมรับ (คั่นด้วยเครื่องหมายจุลภาค) โฮสต์ loopback บน PORT อนุญาตเสมอ เพิ่มชื่อโฮสต์สาธารณะเมื่อผูกกับ 0.0.0.0	(เฉพาะ loopback)

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

Server จะเข้าถึงได้ที่ http://localhost:8080/mcp

เครื่องมือที่มีให้

perplexity_search

การค้นหาเว็บโดยตรงโดยใช้ Perplexity Search API ส่งคืนผลการค้นหาที่จัดอันดับพร้อมข้อมูลเมตา เหมาะสำหรับการค้นหาข้อมูลปัจจุบัน รองรับตัวกรองความใหม่ (search_recency_filter) และการจำกัดโดเมน (search_domain_filter)

perplexity_ask

AI เชิงสนทนาอเนกประสงค์พร้อมการค้นหาเว็บแบบเรียลไทม์ รองรับโดย Agent API พรีเซ็ต fast เหมาะสำหรับคำถามด่วนและการค้นหาในชีวิตประจำวัน

perplexity_research

การวิจัยเชิงลึกและครอบคลุม รองรับโดย Agent API พรีเซ็ต high เหมาะสำหรับการวิเคราะห์อย่างละเอียดและรายงานโดยละเอียด การรันอาจใช้เวลาหลายนาที; server จะสตรีมการรันและรายงานความคืบหน้าให้กับ client ที่ร้องขอ

perplexity_reason

การให้เหตุผลขั้นสูงและการแก้ปัญหา รองรับโดย Agent API พรีเซ็ต medium เหมาะสำหรับงานวิเคราะห์ที่ซับซ้อน

[!NOTE] พรีเซ็ตคือการกำหนดค่าที่จัดการ (โมเดล การตั้งค่าการค้นหา งบประมาณขั้นตอน) ที่ Perplexity ปรับแต่งอยู่ตลอดเวลา; ดู คู่มือพรีเซ็ต เวอร์ชันก่อนหน้าของ server นี้เรียกโมเดล sonar-pro, sonar-reasoning-pro และ sonar-deep-research แบบเดิม และยอมรับพารามิเตอร์ strip_thinking / reasoning_effort พารามิเตอร์เหล่านั้นไม่เป็นส่วนหนึ่งของ schema เครื่องมืออีกต่อไปและจะถูกละเว้นหากส่ง; Agent API ไม่สร้างแท็ก <think>

ใช้เป็นไลบรารี

แพ็คเกจนี้ยังส่งออก server factory สำหรับฝังในกระบวนการ Node ของคุณเอง:

import { createPerplexityServer } from "@perplexity-ai/mcp-server";

// Single-tenant: reads PERPLEXITY_API_KEY from the environment.
const server = createPerplexityServer("my-service");

// Multi-tenant hosts resolve the key per call instead. When a provider is
// set, the environment variable is never consulted, and a provider that
// returns no key fails the call rather than falling back.
const tenantServer = createPerplexityServer("my-service", {
  apiKey: () => currentRequestApiKey,
});

เมานต์ server ที่ส่งคืนบน MCP transport ใดๆ (stdio, streamable HTTP, in-memory)

การแก้ไขปัญหา

• ปัญหา API Key: ตรวจสอบว่า PERPLEXITY_API_KEY ตั้งค่าอย่างถูกต้อง
• ข้อผิดพลาดการเชื่อมต่อ: ตรวจสอบการเชื่อมต่ออินเทอร์เน็ตและความถูกต้องของ API key
• ไม่พบเครื่องมือ: ตรวจสอบว่าแพ็คเกจติดตั้งแล้วและเส้นทางคำสั่งถูกต้อง
• ข้อผิดพลาดหมดเวลา: สำหรับคำค้นคว้าที่ยาวมาก ให้ตั้งค่า PERPLEXITY_TIMEOUT_MS เป็นค่าที่สูงขึ้น
• ปัญหา Proxy: ตรวจสอบการตั้งค่า PERPLEXITY_PROXY หรือ HTTPS_PROXY ของคุณและตรวจสอบว่า api.perplexity.ai ไม่ถูกบล็อกโดย firewall ของคุณ
• ข้อผิดพลาด EOF / Initialize: MCP client ที่เข้มงวดบางตัวล้มเหลวเนื่องจาก npx เขียนข้อความการติดตั้งไปยัง stdout ใช้ npx -yq แทน npx -y เพื่อระงับเอาต์พุตนี้

สำหรับการสนับสนุน เยี่ยมชม community.perplexity.ai หรือ รายงานปัญหา

---