Plaud MCP

官方

將您的 Plaud 錄音連接到任何支援 MCP 的 AI 客戶端。搜尋錄音、讀取逐字稿,並在無需離開 AI 助手的情況下生成文件。

你可以用 Plaud MCP 做什麼?

  • 搜尋錄音 — 請您的助理透過 list_files 並搭配 querydate_fromdate_to 等篩選條件,依名稱或日期範圍尋找錄音。

  • 讀取逐字稿與筆記 — 透過 get_transcript 取得含時間戳記與發言者標籤的完整逐字稿,或透過 get_note 取得 AI 生成的摘要、待辦事項與關鍵主題。

  • 存取錄音詳細資料 — 使用 get_file 擷取單一錄音的完整中繼資料,包括時長、裝置序號,以及暫時的音訊下載 URL。

  • 管理您的帳戶 — 使用 loginlogout 登入或登出 Plaud,或使用 get_current_user 查看您目前的帳戶詳細資料。

文件

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互動式指南不需要重新啟動
Kiro不需要重新啟動

先決條件

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

安裝

執行一次下列指令。安裝程式會偵測您的 AI 用戶端、寫入 MCP 設定,並開啟瀏覽器進行登入:

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

當瀏覽器開啟時,請點擊 授權 (Authorize),然後重新啟動安裝程式輸出中列出的用戶端。下次工作階段即可立即使用 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 帳戶並點擊 **授權 (Authorize)**。返回 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 伺服器目錄](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 授權頁面。點擊 授權 (Authorize) 並返回您的用戶端 — 您已登入。

接著試試:

列出我最近的錄音

總結星期二的站立會議

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


工具

當 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_filesget_file 傳回的欄位

欄位類型說明
idstring唯一的錄音 ID
namestring錄音名稱
created_atstring建立時間 (ISO 8601)
start_atstring錄音開始時間 (ISO 8601)
durationnumber持續時間(毫秒)
serial_numberstring裝置序號

僅由 get_file 傳回的額外欄位

欄位類型說明
presigned_urlstring暫時的音訊下載 URL(24 小時有效)
source_listarray含時間戳記和說話者標籤的逐字稿片段
note_listarrayAI 產生的 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 的狀況下執行,以取得 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 重新安裝,然後重新啟動。