Plaud MCP

官方

将您的Plaud录音连接到任何兼容MCP的AI客户端。无需离开AI助手即可搜索录音、阅读转录并生成文档。

访问 plaud.ai

你可以用 Plaud MCP 做什么？

按关键词或日期搜索录音 — 使用 list_files 配合 query、date_from 和 date_to 查找特定会议。
获取带说话人标签的完整转录 — 通过 get_transcript 获取录音中的每个单词和时间戳。
获取AI生成的会议纪要和行动项 — 使用 get_note 提取摘要、关键主题和后续事项。
访问录音详情和音频 — 使用 get_file 获取元数据、可下载的音频链接以及结构化的笔记数据。
登录或退出您的Plaud账户 — 通过 login 进行身份验证，或使用 logout 直接从您的AI客户端撤销访问权限。

文档

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	交互式指南	无需重启

前提条件

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 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 客户端的交互式指导。
令牌刷新错误	删除 `~/.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` 重新安装，然后重启。

Plaud MCP

你可以用 Plaud MCP 做什么？

文档

Plaud MCP

支持的客户端

前提条件

安装

Claude Web

ChatGPT Web

快速开始

工具

使用 list_files 筛选录音

数据参考

list_files 和 get_file 返回的字段

仅由 get_file 返回的额外字段

技能

升级

卸载

故障排除

使用 `list_files` 筛选录音

`list_files` 和 `get_file` 返回的字段

仅由 `get_file` 返回的额外字段