Plaud MCP

Plaud MCP

Plaudの録音を、Claude、Cursor、ChatGPT、Codexなど、あらゆるMCP互換AIクライアントに接続できます。AIアシスタントから離れることなく、録音の検索、文字起こしの閲覧、ドキュメントの生成が可能です。

対応クライアント

クライアント	自動設定	インストール後の再起動
Claude Desktop	✓	⌘Q + 再起動
Claude Code	✓	終了 + 新しい claude セッション
Codex Desktop	✓	終了 + 再起動
Cursor / Windsurf / VS Code / Zed	✓	各クライアントUIに従って再読み込み
Claude Web / ChatGPT Web	インタラクティブガイド	再起動不要

---

前提条件

• 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"] } } }

**HTTPベースのクライアント（Claude Web、ChatGPT Web）**

HTTP経由で接続する場合、録音データはPlaudのMCPサーバー（米国でホスト）を通過します。Plaudはリクエスト完了後にこのデータを保存しません。転送中にのみ処理されます。データの取り扱いはPlaudのプライバシーポリシーに準拠します。

Claude Web

[claude.ai](https://claude.ai) にアクセスし、左サイドバーの「Customize」→「Connectors」に移動します。 **Add custom connector** をクリックします。フォームに以下を入力します。

* **Name** — `Plaud Web MCP`
* **Remote MCP server URL** — `https://mcp.plaud.ai/mcp`

**Add** をクリックします。

ClaudeがブラウザでPlaud認証ページを開きます。Plaudアカウントにサインインし、**Authorize** をクリックします。Claudeに戻ると、会話でPlaudツールが利用可能になります。

ChatGPT Web

[chatgpt.com](https://chatgpt.com) 左サイドバーで「Apps」をクリックし、「Plaud」を検索します。 「Connect」をクリックし、Plaudでサインインします。

---

クイックスタート

インストール後、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 によって返されるフィールド

フィールド	型	説明
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	Markdown形式のAI生成ノート

---

スキル

スキルは、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 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 を使用して再インストールし、再起動します。