Plaud MCP - Plaud Dev API

Client supportati

Client	Configurato automaticamente	Riavviare dopo l’installazione
Claude Desktop	✓	⌘Q + riapri
Claude Code	✓	Esci + nuova sessione Claude
Codex Desktop	✓	Esci + riapri
Cursor / Windsurf / VS Code / Zed	✓	Ricarica per interfaccia utente del client
Claude Web / ChatGPT Web	Guida interattiva	Nessun riavvio necessario

Prerequisiti

Node.js ≥ 20 — download
Un account Plaud

Installa

Eseguilo una volta. Il programma di installazione rileva i tuoi client AI, scrive la configurazione MCP e apre il browser per l’accesso:

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

All’apertura del browser, fare clic su Autorizza, quindi riavviare i client elencati nell’output del programma di installazione. Gli strumenti Plaud saranno disponibili immediatamente nella tua prossima sessione.

Opzioni

Contrassegna	Cosa fa
—yes	Configura automaticamente tutti i client locali rilevati senza prompt
—no-login	Salta il passaggio di accesso al browser (utile su macchine remote o headless)

Altri client MCP

Se il tuo client non viene rilevato automaticamente, aggiungi Plaud manualmente incollandolo nella configurazione MCP del tuo client:

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

❗ client basati su HTTP (Claude Web, ChatGPT Web): Quando ci si connette tramite HTTP, i dati di registrazione passano attraverso il server MCP di Plaud (ospitato negli Stati Uniti). Plaud non memorizza questi dati dopo il completamento della richiesta — vengono elaborati solo in transito. Il trattamento dei dati è regolato dall’informativa sulla privacy di Plaud.

Claude Web

1 — Apri i connettori Vai su claude.ai, vai alla barra laterale sinistra, clicca su Personalizza → Connettori. 2 — Aggiungi il server Plaud MCP Fare clic su Aggiungi connettore personalizzato. Compila il modulo:

Nome — Plaud
URL del server MCP remoto — https://mcp.plaud.ai/mcp

Fai clic su Aggiungi. 3 — Autorizza Claude aprirà la pagina di autorizzazione Plaud nel tuo browser. Accedi al tuo account Plaud e fai clic su Autorizza. Torna a Claude — Gli strumenti Plaud sono ora disponibili nella conversazione.

ChatGPT Web

1 — Abilita la modalità sviluppatore Vai su chatgpt.com, fai clic sull’avatar del tuo profilo e seleziona Impostazioni → App → Impostazioni avanzate. Attiva la modalità sviluppatore. 2 — Crea la Plaud app Fai clic su Crea app. Compila il modulo:

Nome — Plaud
URL del server MCP — https://mcp.plaud.ai/mcp
Autenticazione — OAuth

Seleziona Ho capito e voglio continuare, quindi fai clic su Crea. 3 — Autorizza ChatGPT ti reindirizzerà alla pagina di autorizzazione di Plaud. Accedi e fai clic su Autorizza. Torna a ChatGPT — Gli strumenti Plaud sono ora disponibili nelle tue conversazioni.

Avvio rapido

Una volta installato, accedi dal tuo client AI:

Fammi accedere a Plaud

Il tuo browser aprirà la pagina di autorizzazione Plaud. Fai clic su Autorizza e torna al tuo client — hai effettuato l’accesso. Poi prova:

Elenca le mie registrazioni recenti
Riassumi lo standup di martedì
Redigi una e-mail di follow-up dai punti di azione di questa riunione

Strumenti

Questi strumenti sono disponibili per il tuo client AI una volta che Plaud MCP è connesso:

Strumento	Descrizione
login	Apre il browser per l’accesso a OAuth
logout	Esci e revoca la tua autorizzazione
get_current_user	Mostra i dettagli del tuo account
list_files	Elenca le tue registrazioni, con filtri opzionali
get_file	Restituisce tutti i dettagli per una singola registrazione
get_note	Restituisce il riepilogo generato dall’IA, gli elementi delle azioni e gli argomenti chiave
get_transcript	Restituisce la trascrizione completa con timestamp e identificazione di chi parla

Filtrare le registrazioni con list_files

Parametro	Descrizione
query	Corrispondenza di parole chiave senza distinzione tra maiuscole e minuscole sul nome della registrazione
date_from	Data di inizio, AAAA-MM-GG
date_to	Data di fine, AAAA-MM-GG
page/page_size	Paginazione (ignorata quando i filtri sono impostati)

Dati di riferimento

Campi restituiti da list_files e get_file

Campo	Tipo	Descrizione
id	stringa	ID di registrazione univoco
name	stringa	Nome di registrazione
created_at	stringa	Tempo di creazione (ISO 8601)
start_at	stringa	Ora di inizio della registrazione (ISO 8601)
duration	numero	Durata in millisecondi
serial_number	stringa	Numero di serie del dispositivo

Campi aggiuntivi restituiti solo da get_file

Campo	Tipo	Descrizione
presigned_url	stringa	URL di download audio temporaneo (valido 24 ore)
source_list	array	Segmenti di trascrizione con timestamp e identificazione di chi parla
note_list	array	Note generate dall’IA in Markdown

Competenze

Le competenze sono istruzioni predefinite che aiutano il tuo client AI a gestire automaticamente i flussi di lavoro Plaud comuni. Si caricano quando il programma di installazione viene eseguito — non sono necessari passaggi aggiuntivi.

Competenza	Si attiva quando chiedi cose come…
plaud-browse	”elenca le mie registrazioni”, “mostra file recenti”
plaud-find	”trova la sincronizzazione settimanale”, “l’incontro da lunedì”
plaud-read	”mostra la trascrizione”, “riassumi questa registrazione”
plaud-digest	”resoconto settimanale”, “che riunioni ho avuto questa settimana”
plaud-followup	”prepara un’email di follow-up”, “elenca gli elementi dell’azione”
plaud-export	”salva su Notion”, “pubblica su Slack”

Aggiorna

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

Riavvia il tuo client AI dopo l’aggiornamento. Per Claude Code nello specifico:

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

Quindi reinstallare dentro Claude Code:

/plugin install plaud

Disinstalla

Client	Comando di pulizia
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

Quindi rimuovi il pacchetto e i dati locali:

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

Risoluzione dei problemi

Segnale	Risoluzione
Gli strumenti Plaud non appaiono dopo l’installazione	Assicurati di aver eseguito un riavvio completo del client — chiudere e riaprire la finestra non è sufficiente. Per Claude Code, esci e inizia una nuova sessione di claude.
401 / Errori “Non autenticati”	Chiedi al tuo client AI: “accedimi a Plaud”.
Nessun client locale configurato in modalità —yes	Installare prima un client locale supportato, o eseguire senza —yes per ottenere una guida interattiva per i client web.
Errori di aggiornamento del token	Eliminare ~/.plaud/tokens-mcp.json e accedere nuovamente.
Il browser non si apre durante l’accesso	Copiare l’URL stampato dal programma di installazione e aprirlo manualmente. Su macchine remote, inoltrare prima la porta 8199: ssh -L 8199:localhost:8199 user@host.
”Server disconnesso” in Claude Desktop	Riesegui il setup: plaud-mcp unsetup && plaud-mcp setup, quindi riavvia Claude Desktop.
La versione non si è aggiornata dopo l’upgrade	Esegui npx -y @plaud-ai/mcp clean-plugin e reinstallala con /plugin install plaud in Claude Code, poi riavvia.

​Client supportati

​Prerequisiti

​Installa

​Opzioni

​Altri client MCP

​Claude Web

​ChatGPT Web

​Avvio rapido

​Strumenti

​Filtrare le registrazioni con list_files

​Dati di riferimento

​Campi restituiti da list_files e get_file

​Campi aggiuntivi restituiti solo da get_file

​Competenze

​Aggiorna

​Disinstalla

​Risoluzione dei problemi