Perplexity Ask MCP Server

ทางการ

ตัวเชื่อมต่อสำหรับ Perplexity API เพื่อเปิดใช้งานการค้นหาเว็บภายในระบบนิเวศ MCP

คุณทำอะไรได้บ้างด้วย Perplexity Ask MCP?

  • การค้นหาเว็บแบบเรียลไทม์ — ขอผลการค้นหาปัจจุบันที่จัดอันดับแล้ว พร้อมตัวกรองตามความใหม่ การจำกัดโดเมน หรือโหมดเร็วผ่าน perplexity_search
  • ถาม-ตอบแบบสนทนา — รับคำตอบที่อ้างอิงจากเว็บอย่างรวดเร็วสำหรับคำถามทั่วไปในชีวิตประจำวันโดยใช้เครื่องมือ perplexity_ask
  • รายงานการวิจัยเชิงลึก — ขอการวิเคราะห์แบบหลายขั้นตอนที่ครอบคลุมสำหรับการสืบสวนอย่างละเอียดผ่าน perplexity_research
  • การให้เหตุผลขั้นสูง — จัดการปัญหาการวิเคราะห์ที่ซับซ้อนด้วยการแก้ปัญหาแบบทีละขั้นตอนผ่าน perplexity_reason
  • ความลึกในการค้นหาที่ปรับแต่งได้ — ควบคุมบริบทการค้นหาที่ดึงมาโดยการตั้งค่างบประมาณ max_tokens และ max_tokens_per_page สำหรับเครื่องมือ ask และ reason

เอกสาร

Perplexity API Platform MCP Server

Install in Cursor   Install in VS Code   Add to Kiro   npm version

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

Remote MCP Server

Remote MCP server ถูกโฮสต์โดย Perplexity และเป็นวิธีที่ง่ายที่สุดในการเริ่มต้นใช้งาน: เครื่องมือเดียวกัน ไม่ต้องติดตั้งหรืออัปเดตอะไรเพิ่มเติม ปุ่ม Cursor และ VS Code ที่ด้านบนของหน้านี้ใช้เชื่อมต่อได้ด้วยคลิกเดียว หาก MCP client ของคุณยังไม่รองรับ remote servers ให้ข้ามไปที่การตั้งค่า 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

Agent Plugins

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

MCP Clients อื่นๆ

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

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

Clientไฟล์กำหนดค่า
Cursor~/.cursor/mcp.json
Claude Desktopclaude_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_KEYPerplexity API key ของคุณจำเป็น
PERPLEXITY_BASE_URLBase URL ที่กำหนดเองสำหรับคำขอ APIhttps://api.perplexity.ai
PORTพอร์ต HTTP server8080
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

ผลการค้นหาจะรวมวันที่เผยแพร่และวันที่อัปเดตล่าสุดเมื่อมีข้อมูล วันที่ที่ขาดหายไปหรือเป็น null จะถูกละเว้นจากผลลัพธ์ที่จัดรูปแบบ

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

perplexity_ask

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

perplexity_research

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

perplexity_reason

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

perplexity_ask และ perplexity_reason ยอมรับ max_tokens จำนวนเต็มบวกที่ไม่บังคับ (บริบทการค้นหาทั้งหมด สูงสุด 120,000) และ max_tokens_per_page (บริบทต่อหน้าผลลัพธ์ สูงสุด 20,000) งบประมาณ Agent API เหล่านี้ควบคุมเนื้อหาการค้นหาที่ดึงมา ไม่ใช่ความยาวของคำตอบที่สร้างขึ้น เมื่อละเว้น การกำหนดค่าการค้นหาของพรีเซ็ตจะยังคงมีผล

อาร์กิวเมนต์ search_context_size แบบเดิมยังคงได้รับการยอมรับ แต่จะถูกแปลงเป็นงบประมาณที่ชัดเจนในเครื่องแทนที่จะส่งไปยัง Agent API:

ขนาดแบบเดิมโทเคนทั้งหมดโทเคนต่อหน้า
low2000512
medium40001024
high80002048

นโยบายความเข้ากันได้นี้ไม่เทียบเท่ากับขนาดที่มีชื่อของ Sonar อย่างแน่นอน; คู่มือการย้าย Agent API ไม่มีขนาดที่มีชื่อเทียบเท่า งบประมาณที่ชัดเจนแต่ละรายการจะแทนที่ค่าเริ่มต้นแบบเดิมที่สอดคล้องกัน

[!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 หรือ รายงานปัญหา