Plaud MCP
官方將您的 Plaud 錄音連接到任何支援 MCP 的 AI 客戶端。搜尋錄音、讀取逐字稿,並在無需離開 AI 助手的情況下生成文件。
你可以用 Plaud MCP 做什麼?
-
搜尋錄音 — 請您的助理透過
list_files並搭配query、date_from和date_to等篩選條件,依名稱或日期範圍尋找錄音。 -
讀取逐字稿與筆記 — 透過
get_transcript取得含時間戳記與發言者標籤的完整逐字稿,或透過get_note取得 AI 生成的摘要、待辦事項與關鍵主題。 -
存取錄音詳細資料 — 使用
get_file擷取單一錄音的完整中繼資料,包括時長、裝置序號,以及暫時的音訊下載 URL。 -
管理您的帳戶 — 使用
login和logout登入或登出 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_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 | 「尋找週度同步」、「星期一的那場會議」 |
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 重新安裝,然後重新啟動。 |