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

claude-connect

3. 授权

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

claude-authorize

ChatGPT Web

1. 打开 ChatGPT Web

chatgpt.com

2. 查找 Plaud 插件

在左侧边栏中点击 Plugins 并搜索 Plaud

gpt-connect

3. 连接

点击 Connect 并使用 Plaud 登录


其他客户端

[accordion] Kiro 设置

1. 访问 Kiro 服务器目录

Kiro 服务器目录

2. 添加 Plaud MCP 服务器

kiro

快速开始

安装完成后,从您的 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 返回的字段

字段类型描述
idstring唯一录音 ID
namestring录音名称
created_atstring创建时间(ISO 8601)
start_atstring录音开始时间(ISO 8601)
durationnumber时长,单位为毫秒
serial_numberstring设备序列号

仅由 get_file 返回的其他字段

字段类型描述
presigned_urlstring临时音频下载 URL(有效期 24 小时)
source_listarray包含时间戳和说话人标签的转录片段
note_listarrayAI 生成的 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 Desktopplaud-mcp unsetup
Claude Codeclaude mcp remove plaud --scope user && npx -y @plaud-ai/mcp clean-plugin
Codex Desktopplaud-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 构建并托管。