Prima autenticazione¶

Il server MCP ha bisogno di accedere a NotebookLM con le credenziali dell'utente. L'autenticazione avviene una sola volta e le credenziali vengono salvate localmente per le sessioni successive.

Procedura di login¶

Scrivere nella chat di Claude:

Configura l'autenticazione per NotebookLM

Claude utilizza il tool setup_auth e il server apre automaticamente una finestra dedicata di Chrome. In questa finestra è sufficiente effettuare il login con il proprio account Google, quello che contiene i notebook da consultare.

Il server utilizza un proprio profilo browser isolato, separato da Chrome o da qualsiasi altro browser in uso. Non è necessario chiudere Chrome né altre applicazioni prima di avviare l'autenticazione.

Il processo richiede tipicamente 30-60 secondi. Al termine del login il server salva automaticamente lo stato di autenticazione in una directory locale. Non è necessario ripetere la procedura per le sessioni successive, purché entro la durata dell'autenticazione.

Verifica della connessione¶

Dopo il login è possibile verificare che tutto funzioni:

Controlla lo stato di NotebookLM

Claude utilizza il tool get_health e riporta informazioni sullo stato dell'autenticazione, la connessione a NotebookLM e lo stato del browser. Se tutto è in ordine il sistema è pronto per l'uso.

Rinnovo automatico¶

L'autenticazione ha una scadenza naturale (24 ore). Quando la sessione scade il server se ne accorge automaticamente alla prima richiesta e avvia la procedura di ri-autenticazione senza intervento dell'utente.

Nella maggior parte dei casi non è necessario preoccuparsi della scadenza. Il sistema gestisce il rinnovo in modo trasparente all'interno della conversazione. In un test di analisi documentale il server ha rilevato la scadenza dell'autenticazione e l'ha rinnovata autonomamente prima di procedere, senza che fosse necessario alcun intervento.

Cambio account¶

Se è necessario utilizzare un account Google diverso (per esempio per accedere a notebook su un altro account, o quando si raggiunge il limite giornaliero di query) è possibile forzare una nuova autenticazione:

Cambia l'account NotebookLM

Claude utilizza il tool re_auth, che cancella le credenziali salvate e apre una nuova finestra di login.

La directory contiene il profilo browser persistente (con la sessione di login) e il file di stato con i cookie. Lo stato di autenticazione viene considerato valido per 24 ore; superata questa soglia il server verifica i cookie e se necessario avvia la ri-autenticazione.

Il server utilizza Patchright, un fork di Playwright con funzionalità stealth, per simulare un comportamento di navigazione realistico durante l'autenticazione. Il profilo browser è completamente isolato da Chrome e da altri browser installati sul sistema: non ci sono interferenze né conflitti.