Plaud MCP

Plaud MCP

Kết nối các bản ghi âm Plaud của bạn với bất kỳ ứng dụng AI tương thích MCP nào — Claude, Cursor, ChatGPT, Codex, và hơn thế nữa. Tìm kiếm bản ghi, đọc bản ghi chép và tạo tài liệu mà không cần rời khỏi trợ lý AI của bạn.

Ứng dụng được hỗ trợ

Ứng dụng	Tự động cấu hình	Khởi động lại sau khi cài đặt
Claude Desktop	✓	⌘Q + mở lại
Claude Code	✓	Thoát + phiên claude mới
Codex Desktop	✓	Thoát + mở lại
Cursor / Windsurf / VS Code / Zed	✓	Tải lại theo giao diện từng ứng dụng
Claude Web / ChatGPT Web	Hướng dẫn tương tác	Không cần khởi động lại

---

Điều kiện tiên quyết

• Node.js ≥ 20 — tải về
• Một tài khoản Plaud

---

Cài đặt

Chạy lệnh này một lần. Trình cài đặt sẽ phát hiện các ứng dụng AI của bạn, ghi cấu hình MCP và mở trình duyệt để bạn đăng nhập:

npx -y @plaud-ai/mcp@latest install

Khi trình duyệt mở ra, nhấp Ủy quyền, sau đó khởi động lại các ứng dụng được liệt kê trong đầu ra của trình cài đặt. Các công cụ Plaud sẽ có sẵn ngay trong phiên tiếp theo của bạn.

Tùy chọn

Cờ	Chức năng
--yes	Tự động cấu hình tất cả ứng dụng cục bộ được phát hiện mà không cần nhắc nhở
--no-login	Bỏ qua bước đăng nhập bằng trình duyệt (hữu ích trên máy từ xa hoặc không có giao diện đồ họa)

Các ứng dụng MCP khác

Nếu ứng dụng của bạn không được tự động phát hiện, hãy thêm Plaud thủ công bằng cách dán đoạn sau vào cấu hình MCP của ứng dụng:

{ 
  "mcpServers": {
    "plaud": {
      "command": "npx",
      "args": ["-y", "@plaud-ai/mcp@latest"] 
    } 
  } 
}

**Ứng dụng dựa trên HTTP (Claude Web, ChatGPT Web)**

Khi kết nối qua HTTP, dữ liệu bản ghi của bạn đi qua máy chủ MCP của Plaud (đặt tại Hoa Kỳ). Plaud không lưu trữ dữ liệu này sau khi yêu cầu hoàn tất — dữ liệu chỉ được xử lý trong quá trình truyền tải. Việc xử lý dữ liệu được điều chỉnh bởi chính sách quyền riêng tư của Plaud.

Claude Web

Truy cập [claude.ai](https://claude.ai), điều hướng đến thanh bên trái và nhấp vào Tùy chỉnh -> Trình kết nối. Nhấp **Thêm trình kết nối tùy chỉnh**. Điền vào biểu mẫu:

* **Tên** — `Plaud Web MCP`
* **URL máy chủ MCP từ xa** — `https://mcp.plaud.ai/mcp`

Nhấp **Thêm**.

Claude sẽ mở trang ủy quyền Plaud trong trình duyệt của bạn. Đăng nhập vào tài khoản Plaud và nhấp **Ủy quyền**. Quay lại Claude — các công cụ Plaud hiện có sẵn trong cuộc trò chuyện của bạn.

ChatGPT Web

[chatgpt.com](https://chatgpt.com) Trên thanh bên trái, nhấp vào Ứng dụng và tìm kiếm Plaud Nhấp Kết nối và đăng nhập bằng Plaud

---

Bắt đầu nhanh

Sau khi cài đặt, đăng nhập từ ứng dụng AI của bạn:

Đăng nhập cho tôi vào Plaud

Trình duyệt của bạn sẽ mở trang ủy quyền Plaud. Nhấp Ủy quyền và quay lại ứng dụng của bạn — bạn đã đăng nhập.

Sau đó thử:

Liệt kê các bản ghi gần đây của tôi

Tóm tắt cuộc họp standup thứ Ba

Soạn email theo dõi từ các mục hành động của cuộc họp này

---

Công cụ

Các công cụ này có sẵn cho ứng dụng AI của bạn khi Plaud MCP được kết nối:

Công cụ	Mô tả
login	Mở trình duyệt để đăng nhập OAuth
logout	Đăng xuất và thu hồi ủy quyền của bạn
get_current_user	Hiển thị chi tiết tài khoản hiện tại của bạn
list_files	Liệt kê các bản ghi của bạn, với các bộ lọc tùy chọn
get_file	Trả về chi tiết đầy đủ cho một bản ghi
get_note	Trả về tóm tắt do AI tạo, các mục hành động và chủ đề chính
get_transcript	Trả về bản ghi chép đầy đủ với dấu thời gian và nhãn người nói

Lọc bản ghi với list_files

Tham số	Mô tả
query	Tìm kiếm từ khóa không phân biệt chữ hoa chữ thường trên tên bản ghi
date_from	Ngày bắt đầu, YYYY-MM-DD
date_to	Ngày kết thúc, YYYY-MM-DD
page / page_size	Phân trang (bị bỏ qua khi bộ lọc được đặt)

---

Tham chiếu dữ liệu

Các trường được trả về bởi list_files và get_file

Trường	Kiểu	Mô tả
id	string	ID bản ghi duy nhất
name	string	Tên bản ghi
created_at	string	Thời gian tạo (ISO 8601)
start_at	string	Thời gian bắt đầu bản ghi (ISO 8601)
duration	number	Thời lượng tính bằng mili giây
serial_number	string	Số sê-ri thiết bị

Các trường bổ sung chỉ được trả về bởi get_file

Trường	Kiểu	Mô tả
presigned_url	string	URL tải xuống âm thanh tạm thời (có hiệu lực 24 giờ)
source_list	array	Các phân đoạn bản ghi chép với dấu thời gian và nhãn người nói
note_list	array	Ghi chú do AI tạo ở định dạng Markdown

---

Kỹ năng

Kỹ năng là các hướng dẫn được tạo sẵn giúp ứng dụng AI của bạn tự động xử lý các quy trình làm việc Plaud phổ biến. Chúng được tải khi trình cài đặt chạy — không cần thêm bước nào.

Kỹ năng	Được kích hoạt khi bạn yêu cầu những việc như…
plaud-browse	"liệt kê các bản ghi của tôi", "hiển thị các tệp gần đây"
plaud-find	"tìm Cuộc họp đồng bộ hàng tuần", "cuộc họp từ thứ Hai"
plaud-read	"hiển thị bản ghi chép", "tóm tắt bản ghi này"
plaud-digest	"báo cáo hàng tuần", "tôi đã có những cuộc họp nào trong tuần này"
plaud-followup	"soạn email theo dõi", "liệt kê các mục hành động"
plaud-export	"lưu vào Notion", "đăng lên Slack"

---

Nâng cấp

npm install -g @plaud-ai/mcp@latest

Khởi động lại ứng dụng AI của bạn sau khi nâng cấp.

Riêng đối với Claude Code:

npx -y @plaud-ai/mcp clean-plugin

Sau đó cài đặt lại bên trong Claude Code:

/plugin install plaud

---

Gỡ cài đặt

Ứng dụng	Lệnh dọn dẹp
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

Sau đó xóa gói và dữ liệu cục bộ:

npm uninstall -g @plaud-ai/mcp
rm -rf ~/.plaud

---

Khắc phục sự cố

Triệu chứng	Cách khắc phục
Công cụ Plaud không xuất hiện sau khi cài đặt	Đảm bảo bạn đã khởi động lại hoàn toàn ứng dụng — chỉ đóng và mở lại cửa sổ là chưa đủ. Đối với Claude Code, hãy thoát và bắt đầu phiên claude mới.
Lỗi 401 / "Chưa xác thực"	Yêu cầu ứng dụng AI của bạn: "đăng nhập cho tôi vào Plaud".
Không có ứng dụng cục bộ nào được cấu hình ở chế độ --yes	Cài đặt một ứng dụng cục bộ được hỗ trợ trước, hoặc chạy mà không có --yes để nhận hướng dẫn tương tác cho ứng dụng web.
Lỗi làm mới token	Xóa ~/.plaud/tokens-mcp.json và đăng nhập lại.
Trình duyệt không mở trong quá trình đăng nhập	Sao chép URL mà trình cài đặt in ra và mở thủ công. Trên máy từ xa, chuyển tiếp cổng 8199 trước: ssh -L 8199:localhost:8199 user@host.
"Máy chủ bị ngắt kết nối" trong Claude Desktop	Chạy lại thiết lập: plaud-mcp unsetup && plaud-mcp setup, sau đó khởi động lại Claude Desktop.
Phiên bản không cập nhật sau khi nâng cấp	Chạy npx -y @plaud-ai/mcp clean-plugin, cài đặt lại với /plugin install plaud trong Claude Code, sau đó khởi động lại.