Plaud MCP

官方

Connect your Plaud recordings to any MCP-compatible AI client. Search recordings, read transcripts, and generate documents without leaving your AI assistant.

造訪 plaud.ai

你可以用 Plaud MCP 做什麼？

  • Search your recordings by keyword or date — use list_files with query, date_from, and date_to to find specific meetings.
  • Retrieve a full transcript with speaker labels — get every spoken word and timestamp from a recording via get_transcript.
  • Get AI-generated meeting notes and action items — pull summaries, key topics, and follow-ups with get_note.
  • Access recording details and audio — use get_file to fetch metadata, a downloadable audio link, and structured note data.
  • Sign in or out of your Plaud account — authenticate via login or revoke access with logout directly from your AI client.

文件

Plaud MCP

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

支援的客戶端

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

先決條件

  • 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)，導覽至左側邊欄，點擊「自訂」->「連接器」。 點擊 **新增自訂連接器**。填寫表單： 
* **名稱** — `Plaud Web MCP`
* **遠端 MCP 伺服器 URL** — `https://mcp.plaud.ai/mcp`

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

ChatGPT Web

[chatgpt.com](https://chatgpt.com) 在左側邊欄上，點擊「應用程式」並搜尋 Plaud 點擊「連接」並使用 Plaud 登入

快速入門

安裝完成後，從您的 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字串唯一的錄音 ID
name字串錄音名稱
created_at字串建立時間（ISO 8601）
start_at字串錄音開始時間（ISO 8601）
duration數字持續時間（毫秒）
serial_number字串裝置序號

僅由 get_file 傳回的其他欄位

欄位類型說明
presigned_url字串臨時音訊下載 URL（有效期 24 小時）
source_list陣列包含時間戳記和說話者標籤的逐字稿片段
note_list陣列AI 生成的 Markdown 格式筆記

技能

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

技能當您詢問類似以下內容時觸發…
plaud-browse"列出我的錄音"、"顯示最近的檔案"
plaud-find"尋找每週同步會議"、"週一的會議"
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 Desktopplaud-mcp unsetup
Claude Codeclaude mcp remove plaud --scope user && npx -y @plaud-ai/mcp clean-plugin
Codex Desktopplaud-mcp unsetup codex

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

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

疑難排解

症狀修復方法
安裝後 Plaud 工具未出現確保您已完全重新啟動客戶端 — 僅關閉並重新開啟視窗是不夠的。對於 Claude Code，請退出並啟動一個新的 claude 工作階段。
401 / "未驗證" 錯誤向您的 AI 客戶端詢問："幫我登入 Plaud"。
在 --yes 模式下未設定本機客戶端請先安裝支援的本機客戶端，或在不使用 --yes 的情況下執行，以取得網頁客戶端的互動式指引。
權杖重新整理錯誤刪除 ~/.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 重新安裝，然後重新啟動。