Plaud MCP

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 重新安装，然后重启。

本文档由 Mintlify 构建和托管，这是一个开发者文档平台。