Plaud MCP

Plaud MCP

Verbinden Sie Ihre Plaud-Aufnahmen mit jedem MCP-kompatiblen KI-Client — Claude, Cursor, ChatGPT, Codex und mehr. Durchsuchen Sie Aufnahmen, lesen Sie Transkripte und erstellen Sie Dokumente, ohne Ihren KI-Assistenten zu verlassen.

Unterstützte Clients

Client	Automatisch konfiguriert	Neustart nach Installation
Claude Desktop	✓	⌘Q + erneut öffnen
Claude Code	✓	Beenden + neue claude Sitzung
Codex Desktop	✓	Beenden + erneut öffnen
Cursor / Windsurf / VS Code / Zed	✓	Neuladen über Client-UI
Claude Web / ChatGPT Web	Interaktive Anleitung	Kein Neustart erforderlich

---

Voraussetzungen

• Node.js ≥ 20 — Download
• Ein Plaud-Konto

---

Installation

Führen Sie dies einmal aus. Das Installationsprogramm erkennt Ihre KI-Clients, schreibt die MCP-Konfiguration und öffnet Ihren Browser zur Anmeldung:

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

Wenn sich Ihr Browser öffnet, klicken Sie auf Autorisieren und starten Sie dann die in der Installationsausgabe aufgeführten Clients neu. Plaud-Tools sind in Ihrer nächsten Sitzung sofort verfügbar.

Optionen

Flag	Funktion
--yes	Alle erkannten lokalen Clients ohne Nachfragen automatisch konfigurieren
--no-login	Den Browser-Anmeldeschritt überspringen (nützlich auf entfernten oder headless Maschinen)

Andere MCP-Clients

Wenn Ihr Client nicht automatisch erkannt wird, fügen Sie Plaud manuell hinzu, indem Sie dies in die MCP-Konfiguration Ihres Clients einfügen:

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

**HTTP-basierte Clients (Claude Web, ChatGPT Web)**

Bei der Verbindung über HTTP werden Ihre Aufnahmedaten über den Plaud MCP-Server (gehostet in den USA) geleitet. Plaud speichert diese Daten nicht nach Abschluss der Anfrage — sie werden nur während der Übertragung verarbeitet. Die Datenverarbeitung unterliegt der Datenschutzrichtlinie von Plaud.

Claude Web

Gehen Sie zu [claude.ai](https://claude.ai), navigieren Sie zur linken Seitenleiste und klicken Sie auf Anpassen -> Konnektoren. Klicken Sie auf **Benutzerdefinierten Konnektor hinzufügen**. Füllen Sie das Formular aus:

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

Klicken Sie auf **Hinzufügen**.

Claude öffnet die Plaud-Autorisierungsseite in Ihrem Browser. Melden Sie sich bei Ihrem Plaud-Konto an und klicken Sie auf **Autorisieren**. Kehren Sie zu Claude zurück — Plaud-Tools sind jetzt in Ihrer Konversation verfügbar.

ChatGPT Web

[chatgpt.com](https://chatgpt.com) Klicken Sie in der linken Seitenleiste auf Apps und suchen Sie nach Plaud Klicken Sie auf Verbinden und melden Sie sich bei Plaud an

---

Schnellstart

Melden Sie sich nach der Installation von Ihrem KI-Client aus an:

Melde mich bei Plaud an

Ihr Browser öffnet die Plaud-Autorisierungsseite. Klicken Sie auf Autorisieren und kehren Sie zu Ihrem Client zurück — Sie sind angemeldet.

Versuchen Sie dann:

Liste meine letzten Aufnahmen auf

Fasse das Standup vom Dienstag zusammen

Entwerfe eine Folge-E-Mail aus den Aktionspunkten dieses Meetings

---

Tools

Diese Tools stehen Ihrem KI-Client zur Verfügung, sobald Plaud MCP verbunden ist:

Tool	Beschreibung
login	Öffnet Ihren Browser zur OAuth-Anmeldung
logout	Meldet ab und widerruft Ihre Autorisierung
get_current_user	Zeigt Ihre aktuellen Kontodetails an
list_files	Listet Ihre Aufnahmen mit optionalen Filtern auf
get_file	Gibt vollständige Details für eine einzelne Aufnahme zurück
get_note	Gibt die KI-generierte Zusammenfassung, Aktionspunkte und Schlüsselthemen zurück
get_transcript	Gibt das vollständige Transkript mit Zeitstempeln und Sprecherbezeichnungen zurück

Aufnahmen filtern mit list_files

Parameter	Beschreibung
query	Groß-/Kleinschreibung ignorierende Stichwortsuche im Aufnahmenamen
date_from	Startdatum, YYYY-MM-DD
date_to	Enddatum, YYYY-MM-DD
page / page_size	Seitennummerierung (ignoriert, wenn Filter gesetzt sind)

---

Datenreferenz

Von list_files und get_file zurückgegebene Felder

Feld	Typ	Beschreibung
id	string	Eindeutige Aufnahme-ID
name	string	Aufnahmename
created_at	string	Erstellungszeit (ISO 8601)
start_at	string	Aufnahmestartzeit (ISO 8601)
duration	number	Dauer in Millisekunden
serial_number	string	Geräteseriennummer

Zusätzliche Felder, die nur von get_file zurückgegeben werden

Feld	Typ	Beschreibung
presigned_url	string	Temporäre Audio-Download-URL (24 Stunden gültig)
source_list	array	Transkriptsegmente mit Zeitstempeln und Sprecherbezeichnungen
note_list	array	KI-generierte Notizen in Markdown

---

Skills

Skills sind vorgefertigte Anweisungen, die Ihrem KI-Client helfen, gängige Plaud-Workflows automatisch zu verarbeiten. Sie werden geladen, wenn das Installationsprogramm ausgeführt wird — keine zusätzlichen Schritte erforderlich.

Skill	Wird ausgelöst, wenn Sie Dinge fragen wie…
plaud-browse	"liste meine Aufnahmen", "zeige aktuelle Dateien"
plaud-find	"finde den Weekly Sync", "das Meeting von Montag"
plaud-read	"zeige das Transkript", "fasse diese Aufnahme zusammen"
plaud-digest	"Wochenbericht", "welche Meetings hatte ich diese Woche"
plaud-followup	"entwerfe eine Folge-E-Mail", "liste die Aktionspunkte auf"
plaud-export	"speichere in Notion", "poste in Slack"

---

Upgrade

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

Starten Sie Ihren KI-Client nach dem Upgrade neu.

Speziell für Claude Code:

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

Dann in Claude Code neu installieren:

/plugin install plaud

---

Deinstallation

Client	Bereinigungsbefehl
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

Entfernen Sie dann das Paket und die lokalen Daten:

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

---

Fehlerbehebung

Symptom	Lösung
Plaud-Tools erscheinen nach der Installation nicht	Stellen Sie sicher, dass Sie einen vollständigen Client-Neustart durchgeführt haben — das Schließen und erneute Öffnen des Fensters reicht nicht aus. Für Claude Code: Beenden und eine neue claude Sitzung starten.
401 / "Nicht authentifiziert"-Fehler	Bitten Sie Ihren KI-Client: "melde mich bei Plaud an".
Keine lokalen Clients im --yes-Modus konfiguriert	Installieren Sie zuerst einen unterstützten lokalen Client oder führen Sie das Programm ohne --yes aus, um interaktive Anleitung für Web-Clients zu erhalten.
Token-Aktualisierungsfehler	Löschen Sie ~/.plaud/tokens-mcp.json und melden Sie sich erneut an.
Browser öffnet sich nicht während der Anmeldung	Kopieren Sie die vom Installationsprogramm ausgegebene URL und öffnen Sie sie manuell. Auf entfernten Maschinen leiten Sie zuerst Port 8199 weiter: ssh -L 8199:localhost:8199 user@host.
"Server getrennt" in Claude Desktop	Führen Sie das Setup erneut aus: plaud-mcp unsetup && plaud-mcp setup, dann starten Sie Claude Desktop neu.
Version wurde nach Upgrade nicht aktualisiert	Führen Sie npx -y @plaud-ai/mcp clean-plugin aus, installieren Sie mit /plugin install plaud in Claude Code neu und starten Sie dann neu.