Perplexity Ask MCP Server

Perplexity API Platform MCP Server

     

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

เซิร์ฟเวอร์ MCP ระยะไกล

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

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 และการตั้งค่าสำหรับไคลเอนต์อื่น ๆ

เซิร์ฟเวอร์ MCP ท้องถิ่น

รับคีย์ 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

ปลั๊กอินตัวแทน

พื้นที่เก็บข้อมูลนี้ถูกแพ็กเกจเป็น Agent Plugin ดังนั้นไคลเอนต์ที่รองรับมาตรฐานนี้สามารถติดตั้งได้โดยตรงจากพื้นที่เก็บข้อมูลนี้ รูปแบบ Agent Plugins ไม่มีการเก็บความลับ ดังนั้นให้ตั้งค่าตัวแปรสภาพแวดล้อม PERPLEXITY_API_KEY ผ่านการตั้งค่าปลั๊กอินหรือ MCP ของไคลเอนต์ของคุณ

ไคลเอนต์ MCP อื่น ๆ

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

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

ไคลเอนต์	ไฟล์กำหนดค่า
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"
      }
    }
  }
}

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

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

1. รับรายละเอียดพร็อกซีของคุณ

• สอบถามแผนกไอทีของคุณสำหรับที่อยู่และพอร์ตพร็อกซี 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

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

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

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

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

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

เซิร์ฟเวอร์จะเข้าถึงได้ที่ http://localhost:8080/mcp

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

perplexity_search

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

perplexity_ask

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

perplexity_research

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

perplexity_reason

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

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

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

แพ็กเกจยังส่งออกตัวสร้างเซิร์ฟเวอร์สำหรับฝังในกระบวนการ 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,
});

เมานต์เซิร์ฟเวอร์ที่ส่งคืนบนทรานสปอร์ต MCP ใด ๆ (stdio, streamable HTTP, in-memory)

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

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

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

---