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: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: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
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
Avvio rapido
Una volta installato, accedi dal tuo client AI:- Fammi accedere a Plaud
- 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
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 |
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. |