メインコンテンツへスキップ

​
対応クライアント

クライアント自動設定インストール後の再起動
Claude Desktop✓⌘Qで終了後、再度開く
Claude Code✓終了後、新しいclaudeセッションを開始
Codex Desktop✓終了後、再度開く
Cursor / Windsurf / VS Code / Zed✓各クライアントのUIからリロード
Claude Web / ChatGPT Web画面の案内に従って設定再起動不要

​
前提条件

​
インストール

以下を、一度実行します。インストーラーがお使いのAIクライアントを検出し、MCP設定を書き込み、サインイン用のブラウザを開きます。 npx -y @plaud-ai/mcp@latest install ブラウザでPlaud認証ページが開いたら、「許可」（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

1 — コネクタを開く claude.ai にアクセスし、左のメニューから「カスタマイズ」 → 「コネクタ」を選択します。 2 — Plaud MCPサーバーを追加 ＋をクリックし、「カスタムコネクタを追加」をクリックします。フォームに入力します： 「追加」をクリックします。 3 — 許可 追加したPlaudコネクタを選んだ状態で「連携/連携させる」をクリックすると、ClaudeがPlaudの認証ページを開きます。Plaudアカウントがご自身のアカウントになっていることを確認し、「許可」をクリックします。Claudeに戻ると、会話内でPlaudツールの利用が可能になります。

​
ChatGPT Web

1 — 開発者モードをONにする chatgpt.comにアクセスし、プロフィールアイコンをクリックし、設定 → アプリ → 高度な設定と進みます。開発者モードをONにします。 2 — Plaudのアプリを作成 「アプリを作成する」をクリックします。フォームに入力します： 「理解したうえで、続行します」にチェックを入れ、「作成する」をクリックします。 3 — 許可 ChatGPTがPlaudの認証ページを自動的に開きます。Plaudアカウントを確認し、**「許可」**をクリックします。ChatGPTに戻ると、会話内でPlaudツールの利用が可能になります。

​
クイックスタート

インストール後、お使いのAIクライアントからログインします。：
  • Plaudにログイン
ブラウザでPlaud認証ページが開きます。「許可」をクリックしてクライアントに戻ると、ログイン完了です その後、以下を試してください。：
  • 最近の録音を一覧表示
  • 火曜日の進捗共有会議を要約
  • この会議のアクション項目からフォローアップメールを作成

​
ツール

Plaud MCP接続後、以下のツールをAIクライアントで利用できます。
ツール説明
loginOAuth認証用のブラウザを開きます
logoutログアウトし、認証を解除します
get_current_user現在のアカウント情報を表示します
list_filesオプションのフィルターを指定して録音一覧を表示します
get_file単一の録音の詳細情報を返します
get_noteAIが生成した要約、アクション項目、主要トピックを返します
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_listarrayMarkdown形式のAI生成ノート

​
スキル

スキルは、Plaudでよく利用されるワークフローをAIクライアントが自動的に処理できるようにする事前定義済みの指示セットです。インストーラー実行時に自動で読み込まれるため、追加の設定は必要ありません。
スキル次のような指示をすると実行されます…
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 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の場合、一旦終了して、新規セッションを開始してください。
401 / “Not authenticated”（未認証）エラーAIクライアントに「Plaudにログインして」と入力してください。
—yes モードでローカルクライアントが設定されていませんまずは、対応するローカルクライアントをインストールしてください。あるいは、Webクライアント向けの対話形式のガイダンスを表示するために、—yes を付けずに実行してください。
トークン更新エラー~/.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を使用して再インストールしてから、再起動してください。