Perplexity Ask MCP Server

Máy chủ MCP Nền tảng API Perplexity

     

Bản triển khai máy chủ MCP chính thức cho Nền tảng API Perplexity, cung cấp cho các trợ lý AI khả năng tìm kiếm web theo thời gian thực, suy luận và nghiên cứu thông qua Agent API và Search API.

Máy chủ MCP từ xa

Máy chủ MCP từ xa được Perplexity lưu trữ và là cách dễ nhất để bắt đầu: cùng các công cụ, không cần cài đặt hoặc cập nhật gì. Các nút Cursor và VS Code ở đầu trang này kết nối với máy chủ chỉ bằng một cú nhấp chuột. Nếu máy khách MCP của bạn chưa hỗ trợ máy chủ từ xa, hãy chuyển đến phần thiết lập máy chủ cục bộ bên dưới. Kết nối qua Streamable HTTP với khóa API Perplexity của bạn:

https://api.perplexity.ai/mcp

Đối với Claude Code:

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

Xem tài liệu tích hợp MCP để biết cấu hình thủ công cho Cursor/VS Code, cách sử dụng từ Anthropic API và thiết lập cho các máy khách khác.

Máy chủ MCP cục bộ

Lấy khóa API của bạn

1. Lấy khóa API Perplexity của bạn từ Cổng API
2. Thay thế your_key_here trong các cấu hình bên dưới bằng khóa API của bạn
3. (Tùy chọn) Đặt thời gian chờ: PERPLEXITY_TIMEOUT_MS=600000 (mặc định: 5 phút)
4. (Tùy chọn) Đặt URL cơ sở tùy chỉnh: PERPLEXITY_BASE_URL=https://your-custom-url.com (mặc định: https://api.perplexity.ai)
5. (Tùy chọn) Đặt mức ghi nhật ký: PERPLEXITY_LOG_LEVEL=DEBUG|INFO|WARN|ERROR (mặc định: ERROR)

Claude Code

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

Hoặc cài đặt qua 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

Các máy khách MCP khác

Hầu hết các máy khách có thể được cấu hình thủ công bằng cùng trình bao bọc mcpServers trong cấu hình máy khách của họ (như được hiển thị cho Cursor). Nếu máy khách có lược đồ khác, hãy kiểm tra tài liệu của họ để biết định dạng trình bao bọc chính xác.

Đối với thiết lập thủ công, các máy khách này đều sử dụng cùng cấu trúc mcpServers:

Máy khách	Tệp cấu hình
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"
      }
    }
  }
}

Thiết lập proxy (dành cho mạng doanh nghiệp)

Nếu bạn đang chạy máy chủ này tại nơi làm việc—đặc biệt là sau tường lửa hoặc proxy của công ty—bạn có thể cần cho chương trình biết cách gửi lưu lượng truy cập internet qua proxy của mạng. Thực hiện theo các bước sau:

1. Lấy thông tin chi tiết proxy của bạn

• Hỏi bộ phận IT của bạn về địa chỉ và cổng proxy HTTPS của bạn.
• Bạn cũng có thể cần tên người dùng và mật khẩu.

2. Đặt biến môi trường proxy

Cách dễ nhất và đáng tin cậy nhất cho Perplexity MCP là sử dụng PERPLEXITY_PROXY. Ví dụ:

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

Nếu proxy của bạn yêu cầu tên người dùng và mật khẩu, hãy sử dụng:

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

3. Thay thế: Các biến môi trường tiêu chuẩn

Nếu bạn muốn sử dụng các biến tiêu chuẩn, chúng tôi hỗ trợ HTTPS_PROXY và HTTP_PROXY.

[!LƯU Ý] Máy chủ kiểm tra cài đặt proxy theo thứ tự này: PERPLEXITY_PROXY → HTTPS_PROXY → HTTP_PROXY. Nếu không có cài đặt nào, máy chủ kết nối trực tiếp với internet. URL phải bao gồm https://. Các cổng điển hình là 8080, 3128 và 80.

Chế độ HTTP tự lưu trữ

Đối với các triển khai đám mây hoặc dùng chung, hãy chạy máy chủ ở chế độ HTTP.

Biến môi trường

Biến	Mô tả	Mặc định
PERPLEXITY_API_KEY	Khóa API Perplexity của bạn	Bắt buộc
PERPLEXITY_BASE_URL	URL cơ sở tùy chỉnh cho các yêu cầu API	https://api.perplexity.ai
PORT	Cổng máy chủ HTTP	8080
BIND_ADDRESS	Giao diện mạng để liên kết. Mặc định là loopback. Đặt thành 0.0.0.0 để hiển thị trên tất cả các giao diện.	127.0.0.1
ALLOWED_ORIGINS	Nguồn gốc CORS (phân tách bằng dấu phẩy). Mặc định trống (không có yêu cầu trình duyệt chéo nguồn gốc). Đặt thành danh sách cho phép rõ ràng (ví dụ: https://app.example.com) hoặc thành * để cho phép mọi nguồn gốc.	(trống)
ALLOWED_HOSTS	Các giá trị tiêu đề Host bổ sung để chấp nhận (phân tách bằng dấu phẩy). Các máy chủ loopback trên PORT luôn được phép. Thêm tên máy chủ công khai khi liên kết với 0.0.0.0.	(chỉ 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

Máy chủ sẽ có thể truy cập tại http://localhost:8080/mcp

Các công cụ có sẵn

perplexity_search

Tìm kiếm web trực tiếp bằng Perplexity Search API. Trả về kết quả tìm kiếm được xếp hạng với siêu dữ liệu, hoàn hảo để tìm thông tin hiện tại. Hỗ trợ bộ lọc độ gần đây (search_recency_filter) và hạn chế tên miền (search_domain_filter).

perplexity_ask

AI hội thoại đa năng với tìm kiếm web theo thời gian thực, được hỗ trợ bởi cài đặt trước Agent API fast. Tuyệt vời cho các câu hỏi nhanh và tìm kiếm hàng ngày.

perplexity_research

Nghiên cứu sâu, toàn diện được hỗ trợ bởi cài đặt trước Agent API high. Lý tưởng cho phân tích kỹ lưỡng và báo cáo chi tiết. Các lần chạy có thể mất vài phút; máy chủ phát trực tuyến lần chạy và báo cáo tiến độ cho các máy khách yêu cầu.

perplexity_reason

Suy luận nâng cao và giải quyết vấn đề được hỗ trợ bởi cài đặt trước Agent API medium. Hoàn hảo cho các tác vụ phân tích phức tạp.

[!LƯU Ý] Các cài đặt trước là cấu hình được quản lý (mô hình, thiết lập tìm kiếm, ngân sách bước) mà Perplexity giữ điều chỉnh theo thời gian; xem hướng dẫn cài đặt trước. Các phiên bản trước của máy chủ này gọi các mô hình cũ sonar-pro, sonar-reasoning-pro và sonar-deep-research và chấp nhận các tham số strip_thinking / reasoning_effort. Các tham số đó không còn là một phần của lược đồ công cụ và bị bỏ qua nếu được gửi; Agent API không tạo ra thẻ <think>.

Sử dụng như một thư viện

Gói này cũng xuất khẩu nhà máy máy chủ để nhúng vào quy trình Node.js của riêng bạn:

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,
});

Gắn máy chủ được trả về vào bất kỳ phương tiện truyền tải MCP nào (stdio, streamable HTTP, in-memory).

Khắc phục sự cố

• Sự cố khóa API: Đảm bảo PERPLEXITY_API_KEY được đặt chính xác
• Lỗi kết nối: Kiểm tra kết nối internet và tính hợp lệ của khóa API của bạn
• Không tìm thấy công cụ: Đảm bảo gói được cài đặt và đường dẫn lệnh chính xác
• Lỗi hết thời gian chờ: Đối với các truy vấn nghiên cứu rất dài, hãy đặt PERPLEXITY_TIMEOUT_MS thành giá trị cao hơn
• Sự cố proxy: Xác minh thiết lập PERPLEXITY_PROXY hoặc HTTPS_PROXY của bạn và đảm bảo api.perplexity.ai không bị tường lửa chặn.
• Lỗi EOF / Khởi tạo: Một số máy khách MCP nghiêm ngặt không thành công vì npx ghi thông báo cài đặt vào stdout. Sử dụng npx -yq thay vì npx -y để chặn đầu ra này.

Để được hỗ trợ, hãy truy cập community.perplexity.ai hoặc gửi sự cố.

---