Plaud MCP

Plaud MCP

將您的 Plaud 錄音連接到任何相容 MCP 的 AI 用戶端 — Claude、Cursor、ChatGPT、Codex 等。無需離開您的 AI 助手，即可搜尋錄音、閱讀逐字稿並產生文件。

支援的用戶端

用戶端	自動設定	安裝後重新啟動
Claude Desktop	✓	⌘Q + 重新開啟
Claude Code	✓	結束 + 開啟新的 claude 工作階段
Codex Desktop	✓	結束 + 重新開啟
Cursor / Windsurf / VS Code / Zed	✓	依各用戶端介面重新載入
Claude Web / ChatGPT Web	互動式指南	無需重新啟動
Kiro	✓	無需重新啟動

---

前置需求

• Node.js ≥ 20 — 下載
• 一個 Plaud 帳戶

---

安裝

執行此指令一次。安裝程式會偵測您的 AI 用戶端、寫入 MCP 設定，並開啟瀏覽器供您登入：

npx -y @plaud-ai/mcp@latest install

當瀏覽器開啟時，點擊 授權，然後重新啟動安裝程式輸出中列出的用戶端。Plaud 工具將在您的下一個工作階段中立即可用。

選項

旗標	功能
--yes	自動設定所有偵測到的本機用戶端，無需提示
--no-login	跳過瀏覽器登入步驟（適用於遠端或無頭機器）

其他 MCP 用戶端

如果您的用戶端未被自動偵測，請手動將以下內容貼到您用戶端的 MCP 設定中來新增 Plaud：

{ 
  "mcpServers": {
    "plaud": {
      "command": "npx",
      "args": ["-y", "@plaud-ai/mcp@latest"] 
    } 
  } 
}

注意

基於 HTTP 的用戶端（Claude Web、ChatGPT Web）

透過 HTTP 連線時，您的錄音資料會經過 Plaud 的 MCP 伺服器（位於美國託管）。Plaud 不會在請求完成後儲存此資料 — 僅在傳輸過程中處理。資料處理受 Plaud 的隱私權政策 規範。

Claude Web

前往 [claude.ai](https://claude.ai)，導覽至左側邊欄並點擊 Customize -> Connectors。 點擊 Connectors，搜尋 Plaud Web MCP，然後連線

<Frame>
  <img src="https://mintcdn.com/plaud/T9vhBbV0G8_IPDu5/assets/claude-connect.png?fit=max&auto=format&n=T9vhBbV0G8_IPDu5&q=85&s=002c6e580441b8855f6893353fccbb22" alt="claude-connect" width="2560" height="1529" data-path="assets/claude-connect.png" />
</Frame>

Claude 會在您的瀏覽器中開啟 Plaud 授權頁面。登入您的 Plaud 帳戶並點擊 **授權**。返回 Claude — Plaud 工具現在可在您的對話中使用。

<Frame>
  <img src="https://mintcdn.com/plaud/T9vhBbV0G8_IPDu5/assets/claude-authorize.jpeg?fit=max&auto=format&n=T9vhBbV0G8_IPDu5&q=85&s=78a2a4242c986e961063cfaa1df65e07" alt="claude-authorize" width="2560" height="1348" data-path="assets/claude-authorize.jpeg" />
</Frame>

ChatGPT Web

[chatgpt.com](https://chatgpt.com) 在左側邊欄中，點擊 Plugins 並搜尋 Plaud

<Frame>
  <img src="https://mintcdn.com/plaud/K9rhUzfIEHohj91s/assets/gpt-connect.png?fit=max&auto=format&n=K9rhUzfIEHohj91s&q=85&s=733f6ac382ba202e7cf9ffd7d3b2e737" alt="gpt-connect" width="2230" height="1250" data-path="assets/gpt-connect.png" />
</Frame>

點擊 Connect 並使用 Plaud 登入

---

其他用戶端

[Kiro Server Directory](https://kiro.dev/docs/mcp/servers/)

<Step title="Add the Plaud MCP Server">
  <Frame>
    <img src="https://mintcdn.com/plaud/TwHXjNWgs8jnS7KS/assets/kiro.png?fit=max&auto=format&n=TwHXjNWgs8jnS7KS&q=85&s=3e17df30ca4afe46c1a934f912a73c07" alt="kiro" width="2546" height="1440" data-path="assets/kiro.png" />
  </Frame>
</Step>

快速開始

安裝完成後，從您的 AI 用戶端登入：

將我登入 Plaud

您的瀏覽器將開啟 Plaud 授權頁面。點擊 授權 並返回您的用戶端 — 您已登入。

然後嘗試：

列出我最近的錄音

摘要週二的站立會議

根據這次會議的行動項目草擬一封後續電子郵件

---

工具

Plaud MCP 連線後，以下工具可供您的 AI 用戶端使用：

工具	說明
login	開啟您的瀏覽器進行 OAuth 登入
logout	登出並撤銷您的授權
get_current_user	顯示您目前的帳戶詳細資料
list_files	列出您的錄音，可搭配選用篩選條件
get_file	傳回單一錄音的完整詳細資料
get_note	傳回 AI 產生的摘要、行動項目和關鍵主題
get_transcript	傳回包含時間戳記和說話者標籤的完整逐字稿

使用 list_files 篩選錄音

參數	說明
query	對錄音名稱進行不區分大小寫的關鍵字比對
date_from	開始日期，YYYY-MM-DD
date_to	結束日期，YYYY-MM-DD
page / page_size	分頁（設定篩選條件時忽略）

---

資料參考

list_files 和 get_file 傳回的欄位

欄位	型別	說明
id	string	唯一錄音 ID
name	string	錄音名稱
created_at	string	建立時間（ISO 8601）
start_at	string	錄音開始時間（ISO 8601）
duration	number	持續時間（毫秒）
serial_number	string	裝置序號

僅由 get_file 傳回的額外欄位

欄位	型別	說明
presigned_url	string	暫時音訊下載 URL（有效 24 小時）
source_list	array	包含時間戳記和說話者標籤的逐字稿片段
note_list	array	AI 產生的 Markdown 格式筆記

---

技能

技能是預先建置的指令，可協助您的 AI 用戶端自動處理常見的 Plaud 工作流程。它們會在安裝程式執行時載入 — 無需額外步驟。

技能	當您詢問類似以下內容時觸發…
plaud-browse	「列出我的錄音」、「顯示最近的檔案」
plaud-find	「找到 Weekly Sync」、「週一的會議」
plaud-read	「顯示逐字稿」、「摘要這份錄音」
plaud-digest	「週報」、「我這週有哪些會議」
plaud-followup	「草擬一封後續電子郵件」、「列出行動項目」
plaud-export	「儲存到 Notion」、「發佈到 Slack」

---

升級

npm install -g @plaud-ai/mcp@latest

升級後請重新啟動您的 AI 用戶端。

特別針對 Claude Code：

npx -y @plaud-ai/mcp clean-plugin

然後在 Claude Code 內重新安裝：

/plugin install plaud

---

解除安裝

用戶端	清理指令
Claude Desktop	plaud-mcp unsetup
Claude Code	claude mcp remove plaud --scope user && npx -y @plaud-ai/mcp clean-plugin
Codex Desktop	plaud-mcp unsetup codex

然後移除套件和本機資料：

npm uninstall -g @plaud-ai/mcp
rm -rf ~/.plaud

---

疑難排解

症狀	修正方式
安裝後 Plaud 工具未出現	請確認您已完整重新啟動用戶端 — 僅關閉並重新開啟視窗是不夠的。對於 Claude Code，請結束並開啟新的 claude 工作階段。
401 / 「未驗證」錯誤	詢問您的 AI 用戶端：「將我登入 Plaud」。
--yes 模式下未設定本機用戶端	先安裝受支援的本機用戶端，或在不使用 --yes 的情況下執行，以取得 Web 用戶端的互動式指引。
Token 重新整理錯誤	刪除 ~/.plaud/tokens-mcp.json 並重新登入。
登入時瀏覽器未開啟	複製安裝程式列印的 URL 並手動開啟。在遠端機器上，請先轉發連接埠 8199：ssh -L 8199:localhost:8199 user@host。
Claude Desktop 中出現「伺服器中斷連線」	重新執行設定：plaud-mcp unsetup && plaud-mcp setup，然後重新啟動 Claude Desktop。
升級後版本未更新	執行 npx -y @plaud-ai/mcp clean-plugin，在 Claude Code 中使用 /plugin install plaud 重新安裝，然後重新啟動。

此文件由 Mintlify 建置和託管，這是一個開發者文件平台。