Plaud MCP
官方将您的Plaud录音连接到任何兼容MCP的AI客户端。无需离开AI助手即可搜索录音、阅读转录并生成文档。
你可以用 Plaud MCP 做什么?
- 列出录音 — 让你的助手列出最近的 Plaud 录音,可按关键词或日期范围筛选。
- 读取转录文本 — 获取录音的完整转录文本,包含时间戳和说话人标签。
- 获取 AI 笔记 — 获取录音的 AI 生成摘要、行动事项和关键主题。
- 起草后续邮件 — 让你的助手根据会议的行动事项起草一封后续邮件。
- 管理登录 — 从你的 AI 客户端登录或退出 Plaud,并查看当前账户详情。
文档
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
浏览器打开后,点击 Authorize,然后重启安装程序输出中列出的客户端。Plaud 工具将在您的下一个会话中立即可用。
选项
| 标志 | 功能 |
|---|---|
--yes | 无需提示,自动配置所有检测到的本地客户端 |
--no-login | 跳过浏览器登录步骤(适用于远程或无头机器) |
其他 MCP 客户端
如果未自动检测到您的客户端,请将以下内容粘贴到客户端的 MCP 配置中,手动添加 Plaud:
{
"mcpServers": {
"plaud": {
"command": "npx",
"args": ["-y", "@plaud-ai/mcp@latest"]
}
}
}
[!NOTE]
基于 HTTP 的客户端(Claude Web、ChatGPT Web)
通过 HTTP 连接时,您的录音数据会经过 Plaud 的 MCP 服务器(托管于美国)。请求完成后,Plaud 不会存储这些数据 — 数据仅在传输过程中处理。数据处理受 Plaud 隐私政策约束。
Claude Web
1. 打开连接器
前往 claude.ai,在左侧边栏中点击 Customize -> Connectors。
2. 添加 Plaud MCP 服务器
点击 Connectors,搜索 Plaud Web MCP,然后连接

3. 授权
Claude 会在浏览器中打开 Plaud 授权页面。登录您的 Plaud 账户并点击 Authorize。返回 Claude — Plaud 工具现在即可在您的对话中使用。

ChatGPT Web
1. 打开 ChatGPT Web
2. 查找 Plaud 插件
在左侧边栏中点击 Plugins 并搜索 Plaud

3. 连接
点击 Connect 并使用 Plaud 登录
其他客户端
[accordion] Kiro 设置
1. 访问 Kiro 服务器目录
2. 添加 Plaud MCP 服务器
快速开始
安装完成后,从您的 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 | “查找 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 / “Not authenticated” 错误 | 请让您的 AI 客户端执行:“帮我登录 Plaud”。 |
在 --yes 模式下未配置本地客户端 | 请先安装受支持的本地客户端,或在不使用 --yes 的情况下运行,以获取适用于 Web 客户端的交互式指南。 |
| 令牌刷新错误 | 删除 ~/.plaud/tokens-mcp.json 并重新登录。 |
| 登录时浏览器未打开 | 复制安装程序输出的 URL 并手动打开。在远程机器上,请先转发端口 8199:ssh -L 8199:localhost:8199 user@host。 |
| Claude Desktop 中出现 “Server disconnected” | 重新运行设置:plaud-mcp unsetup && plaud-mcp setup,然后重启 Claude Desktop。 |
| 升级后版本未更新 | 运行 npx -y @plaud-ai/mcp clean-plugin,在 Claude Code 中使用 /plugin install plaud 重新安装,然后重启。 |
本文档使用开发者文档平台 Mintlify 构建并托管。
