Plaud — неофициальный личный API: практическое руководство

Plaud MCP (Model Context Protocol, стандарт подключения ИИ-ассистента к внешним данным) и Plaud CLI (интерфейс командной строки) дают доступ к записям, транскриптам, саммари и списку задач (action items) без ручного копирования токена. Неофициальный веб-API всё ещё используют сторонние инструменты, но он подходит только тем, кто готов следить за изменениями авторизации и конечных точек.

Содержание

1. Официальные варианты доступа
2. Подключение Plaud MCP
3. Установка и команды Plaud CLI
4. Полезные сценарии
5. Неофициальный веб-API
6. Ошибки и ограничения
7. Изменения экосистемы Plaud
8. Ссылки

Какие варианты доступа доступны

По состоянию на 8 сентября 2026 года Plaud прямо указывает, что публичного универсального API для пользователей нет.

Для большинства личных задач выбирайте MCP или CLI. Plaud Embedded представляет отдельную бизнес-платформу с Device SDK и Transcription API; доступ запрашивается через dev.plaud.ai.

Подключение Plaud MCP

Plaud MCP подключает облачные записи к совместимому ИИ-клиенту. После авторизации ассистент может искать записи, получать транскрипты, саммари и списки задач. MCP не записывает аудио и не редактирует записи или транскрипты.

Для работы должна быть включена синхронизация Plaud Cloud Sync.

Подключение в Claude и ChatGPT

Официальная справка Plaud описывает установку из каталога подключений самого клиента:

• в Claude: Customize → Connectors → Plaud Web MCP → Connect;
• в ChatGPT: открыть каталог плагинов, найти Plaud и установить подключение;
• затем войти в обычный Plaud-аккаунт и разрешить доступ.

Ручная настройка URL и API-ключа для этих вариантов не требуется.

Подключение через терминал

Для Cursor, Windsurf, Zed, Gemini CLI, VS Code с MCP-расширением и других совместимых клиентов понадобится установленный Node.js:

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

Установщик добавит конфигурацию и откроет браузер для авторизации. После установки полностью перезапустите ИИ-клиент.

Для совместимого веб-приложения сервер можно добавить вручную:

MCP Server URL: https://mcp.plaud.ai/mcp
Authentication: OAuth

Проверка подключения

Попросите ассистента показать последние записи Plaud. Успешный результат — список записей из вашего аккаунта. Затем запросите транскрипт или саммари одной из них.

Если клиент сообщает, что пользователь не авторизован, повторите вход через Plaud. Если команда npx не найдена, установите Node.js и заново запустите установщик.

Установка и команды Plaud CLI

CLI подходит для терминала, сценариев и запуска по расписанию. Он работает в Windows, macOS и Linux и требует Node.js 20 или новее.

npm install -g @plaud-ai/cli
plaud login

Команда plaud login открывает браузер. После успешного входа проверьте подключение:

plaud files

Ожидаемый результат — таблица последних записей с колонкой ID.

Основные команды

Ссылка, которую возвращает plaud audio, действует 24 часа. CLI не записывает звук и не редактирует содержимое Plaud.

Полезные сценарии

Найти встречу и подготовить продолжение разговора

Исходное условие: запись синхронизирована с облаком Plaud, а MCP подключён к ассистенту.

Попросите найти встречу по дате или теме, показать списки задач и подготовить черновик письма. Проверьте результат по названию записи и фрагментам транскрипта. Сценарий требует включённой Plaud Cloud Sync; если нужная запись ещё не синхронизирована или транскрипт не готов, ассистент не вернёт ожидаемый результат.

Выгрузить саммари за период

Сначала найдите записи через CLI:

plaud search "weekly" --from 2026-08-01 --to 2026-08-31

Скопируйте ID нужной записи и сохраните саммари:

plaud summary <id> -o weekly-summary.md

Наблюдаемый результат — файл с результатом команды в текущем каталоге терминала. Для сохранения в другую папку передайте полный путь после -o.

Получить исходное аудио

plaud audio <id>

Команда должна вернуть временную ссылку. Скачайте файл в течение 24 часов. Если нужна стабильная архивная ссылка, этот способ не подходит: сохраните сам файл в собственное хранилище с учётом согласий участников и требований к персональным данным.

Неофициальный веб-API

Веб-приложение Plaud использует внутренний недокументированный API. Plaud не публикует для него пользовательский контракт и не обещает совместимость интерфейса.

Почему старый способ с tokenstr больше не универсален

У части старых аккаунтов в localStorage всё ещё встречается долгоживущий Bearer-токен tokenstr. Если вы проверяете старый способ в Chrome:

1. Откройте web.plaud.ai и войдите в аккаунт.
2. Откройте DevTools и раздел Application → Local Storage.
3. Проверьте наличие ключа tokenstr.

Не рассчитывайте, что этот ключ есть у всех аккаунтов. В README Applaud для новых аккаунтов описана другая схема: краткоживущие cookies pld_ut примерно на сутки и pld_urt примерно на 30 дней. Клиент затем получает отдельный токен рабочего пространства и обновляет пользовательскую сессию через refresh-токен.

Наблюдаемые конечные точки

В переданном README Applaud описаны такие конечные точки:

Это описание поведения стороннего клиента, а не контракт Plaud. Прежние примеры, предполагавшие одинаковый Bearer-токен и стабильную структуру /file/detail/{file_id} для всех аккаунтов, нельзя использовать как готовую интеграцию.

Когда неофициальный маршрут оправдан

Он может понадобиться для локальной синхронизации, вебхука или интеграции, которой нет в MCP и CLI. Перед использованием проверьте исходный код, способ хранения секретов и активность проекта.

В переданном README один из вариантов, Applaud, описан как локальный сервер для синхронизации записей и отправки вебхуков. Проект не связан с Plaud. В README указано, что токены хранятся в конфигурации, включая settings.json, в открытом виде с правами доступа 600; интеграция с системным хранилищем ключей названа будущим улучшением.

Ошибки и ограничения

Plaud MCP и CLI сейчас бесплатны для активных аккаунтов, однако официальная справка допускает появление оплаты в будущем. MCP требует включённой облачной синхронизации.

Изменения экосистемы Plaud к 8 сентября 2026 года

Официальные материалы Plaud показывают следующие изменения:

• Plaud MCP и CLI рекомендуются как основные средства доступа к личным данным без API-ключа.
• Plaud Team запущен 15 июня 2026 года и включает общее рабочее пространство с централизованным управлением.
• Plaud Desktop представлен 16 марта 2026 года как бета-версия для нативной записи встреч в Zoom, Google Meet и Teams без бота.
• NotePin S присутствует в актуальной линейке устройств; на американской версии официального сайта в момент проверки была указана цена $179.
• Бизнес-направление Plaud Embedded предлагает Device SDK и Transcription API по отдельному запросу доступа.

Ссылки

• Официальная справка: доступ к данным Plaud
• Руководство Plaud MCP
• Руководство Plaud CLI
• Документация Plaud
• Plaud Release Notes
• Plaud Web
• Applaud: неофициальная локальная синхронизация

Если нужно встроить архив Plaud в собственный поиск, базу знаний или командный процесс, сначала определите, достаточно ли MCP или CLI и какие данные допустимо передавать внешним системам.

Следующий шаг

Если нужен практический сценарий импорта записей Plaud в Notion через внутренний API, продолжите с Plaud × Notion: устойчивый конвейер транскриптов через «серый» API.

Связанные материалы

• Статья: Как я собрал команду из трёх ИИ-агентов и автоматизировал разработку через Notion
• Блог: Notion MCP теперь умеет работать с записями встреч
• База знаний: Личный музыкальный архив без потери оригиналов

Эта тема полезна тем, кто собирает личный архив встреч или подключает расшифровки к рабочему процессу и хочет заранее оценить границы официального и неофициального доступа.

Если захотите обсудить, как это применить у себя или в команде — пишите в Telegram @pimenov