# Perplexity Developers 將 API MCP server 封裝為 Agent Plugin，支援 Codex、Cursor 與 Visual Studio Code

> 📖 本站完整內容索引（documentation index）：[llms.txt](/llms.txt)

> 原作者：Perplexity Developers (@perplexitydevs) · 策展與摘要：EasyVibeCoding · 平台：X (Twitter) · 熱度：🔥🔥 · 日期：2026-08-19

> 原始來源：https://x.com/perplexitydevs/status/2089835690603512123

## 證據與延伸閱讀

- [Perplexity Developers 將 API MCP server 封裝為 Agent Plugin，支援 Codex、Cursor 與 Visual Studio Code。](http://pplx.ai/api_agent_plugin)
- [Agent Plugins 1.0.0 是開放且廠商中立的規格](https://agent-plugins.org/)

## 中文摘要

Perplexity Developers 將 API MCP server 封裝為 Agent Plugin，支援 Codex、Cursor 與 Visual Studio Code。

**核心發布**  
Perplexity Developers 表示，這個 Agent Plugin 已支援 Codex、Cursor、Visual Studio Code 及其他符合 Agent Plugins 1.0.0 的使用者端。使用者需先在 [API Console](https://pplx.ai/api-console) 申請 Perplexity API key，再從 [Perplexity API Agent Plugin repo](http://pplx.ai/api_agent_plugin) 開始使用。API key 屬於 credential，以下涉及金鑰的設定都是來源所述、需人工核對的高風險操作，勿將金鑰提交至 repo 或公開分享。

![](https://pub-75d4fe1e4e80421b9ecb1245a7ae0d1a.r2.dev/curated/af34115222d20c85.svg)
> Cursor 安裝按鈕，黑底顯示「INSTALL IN CURSOR」。

**開放標準**  
Agent Plugins 1.0.0 是開放、廠商中立的套件規格，用來以一致格式封裝可重複使用的 skills 與 MCP servers，解決不同 Agent 使用者端各自採用 plugin 格式、導致作者必須重排元件的問題。套件可包含 `plugin.json`、`skills/`、`SKILL.md` 與 `mcp.json`；使用者端仍自行掌控安裝、權限與使用者體驗。

![](https://pub-75d4fe1e4e80421b9ecb1245a7ae0d1a.r2.dev/curated/68d3b70b8bfac6e2.svg)
> Visual Studio Code 安裝按鈕，藍底顯示「INSTALL IN VS CODE」。

**連線方式**  
Perplexity 提供託管的 Remote MCP Server，不需安裝或更新本機伺服器，透過 Streamable HTTP 連線。Claude Code 的來源指令如下，執行前須確認 API key、權限與網路目的地：

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

本機安裝可使用以下指令：

```bash
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
codex mcp add perplexity --env PERPLEXITY_API_KEY="your_key_here" -- npx -y @perplexity-ai/mcp-server
```

也可在支援 Agent Plugins 的使用者端直接從 repo 安裝，但規格不會攜帶 secrets，仍須在 plugin 或 MCP 設定中提供 `PERPLEXITY_API_KEY`。

![](https://pub-75d4fe1e4e80421b9ecb1245a7ae0d1a.r2.dev/curated/bef7588bf856d8b1.svg)
> Kiro 安裝按鈕，紫底顯示「ADD TO KIRO」。

**設定與能力**  
可選擇設定 `PERPLEXITY_TIMEOUT_MS=600000`、`PERPLEXITY_BASE_URL=https://your-custom-url.com`，以及 `PERPLEXITY_LOG_LEVEL=DEBUG|INFO|WARN|ERROR`。手動設定的 MCP 結構如下：

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

提供的工具包括：

- `perplexity_search`：透過 Search API 搜尋即時網路資訊，可用時間與網域篩選。
- `perplexity_ask`：適合一般問答與快速搜尋。
- `perplexity_research`：進行深度研究，可能執行數分鐘並回報進度。
- `perplexity_reason`：處理複雜分析與問題解決。

![](https://pub-75d4fe1e4e80421b9ecb1245a7ae0d1a.r2.dev/curated/69056af4e5de96c2.svg)
> npm 版本徽章，顯示「NPM」與「V1.2.0」。

**企業網路與部署**  
公司防火牆或 Proxy 環境可設定 `PERPLEXITY_PROXY=https://your-proxy-host:8080`，也支援 `HTTPS_PROXY` 與 `HTTP_PROXY`；若內含帳號密碼，來源範例為 `export PERPLEXITY_PROXY=https://username:password@your-proxy-host:8080`，同樣需人工核對並避免外洩 credential。自架 HTTP 模式可使用：

```bash
docker build -t perplexity-mcp-server .
docker run -p 8080:8080 -e PERPLEXITY_API_KEY=your_key_here perplexity-mcp-server
export PERPLEXITY_API_KEY="your_key_here"
npm install && npm run build && npm run start:http
```

伺服器預設位於 `http://localhost:8080/mcp`；來源也提醒，若嚴格的 MCP 使用者端因 `npx` 將安裝訊息寫入 stdout 而初始化失敗，可改用 `npx -yq`，但任何修改前仍應先檢查套件來源與執行環境。

## 標籤

MCP, Codex, Cursor, IDE, 功能更新, Perplexity, Visual Studio Code, Cursor