跳轉到主要內容

​
支援用戶端

用戶端自動設定安裝後重新啟動
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

1 — 開啟連接器 前往 claude.ai，在左側邊欄中，按一下自訂→連接器。 2 — 新增 Plaud MCP 伺服器 按一下新增自訂連接器。填寫表格: 按一下新增。 3 — 授權 Claude 會在您的瀏覽器中開啟 Plaud 授權頁面。登入您的 Plaud 帳戶並按一下授權。返回 Claude — 您現在可以在對話中使用 Plaud 工具了。

​
ChatGPT 網頁版

1 — 啟用開發人員模式 進入 chatgpt.com，按一下您的個人資料頭像，然後選擇 設定 → 應用程式 → 進階設定。開啟開發人員模式。 2 — 建立 Plaud app 按一下建立應用程式。填寫表格: 勾選我已了解並希望繼續，然後按一下建立。 3 — 授權 ChatGPT 會將您重新導向到 Plaud 授權頁面。登入並按一下授權。返回 ChatGPT — 您現在可以在對話中使用 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字串臨時音訊下載連結（24 小時內有效）
source_list陣列包含時間戳記與發言者標籤的轉錄片段
note_list陣列Markdown 格式的 AI 生成筆記

​
技能

技能是內建的指令集，可協助您的 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 模式執行，以獲得 Web 用戶端的互動指引。
權杖重新整理錯誤刪除 ~/.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 重新安裝，然後重新啟動。