Plaud MCP

官方

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

访问 plaud.ai试用此 MCP赞助

你可以用 Plaud MCP 做什么？

搜索录音 — 让您的助手通过 list_files 按名称或日期范围查找录音，可使用 query、date_from 和 date_to 等筛选条件。
读取转录文本和笔记 — 通过 get_transcript 获取带时间戳和说话人标签的完整转录文本，或通过 get_note 获取 AI 生成的摘要、行动项和关键主题。
访问录音详情 — 使用 get_file 拉取单个录音的完整元数据，包括时长、设备序列号和临时音频下载链接。
管理您的账户 — 使用 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	✓	按各客户端界面重新加载
Claude Web / ChatGPT Web	交互式指引	无需重启
Kiro	✓	无需重启

前置条件

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，然后连接

<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 账户并点击**授权**。返回 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) 在左侧边栏中，点击“插件”并搜索 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>

点击“连接”，并使用 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 授权页面。点击授权并返回你的客户端——你已登录成功。

然后试试：

列出我最近的录音

总结周二的站会

根据本次会议的行动项草拟一封跟进邮件

工具

连接 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 客户端的交互式指引。
令牌刷新错误	删除 `~/.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` 返回的额外字段