Installazione¶

L'installazione richiede due passaggi: scaricare e compilare il server MCP, poi configurare Claude Desktop per utilizzarlo.

Scaricare il server¶

Aprire un terminale e posizionarsi nella cartella in cui si desidera installare il server. Eseguire i seguenti comandi in sequenza:

git clone https://github.com/paolodalprato/notebooklm-mcp-structured.git
cd notebooklm-mcp-structured
npm install
npm run build

Il primo comando scarica il codice sorgente dal repository GitHub. Il secondo entra nella cartella del progetto. Il terzo installa le dipendenze necessarie. Il quarto compila il codice TypeScript in JavaScript eseguibile.

Se git non è installato

In alternativa a git clone è possibile scaricare il codice come archivio ZIP dalla pagina GitHub del progetto (github.com/paolodalprato/notebooklm-mcp-structured). Nella pagina del repository fare clic sul pulsante verde "Code" e selezionare "Download ZIP". Estrarre l'archivio in una cartella a scelta e proseguire con npm install e npm run build dalla cartella estratta.

Configurare Claude Desktop¶

È necessario modificare il file di configurazione di Claude Desktop per registrare il nuovo server MCP.

Posizione del file di configurazione: | Sistema operativo | Percorso | |---|---| | Windows | %APPDATA%\Claude\claude_desktop_config.json | | macOS | ~/Library/Application Support/Claude/claude_desktop_config.json | | Linux | ~/.config/Claude/claude_desktop_config.json |

Aprire il file con un editor di testo e aggiungere (o modificare) la sezione mcpServers. Se il file è vuoto o non esiste, crearlo con questo contenuto:

{
  "mcpServers": {
    "notebooklm": {
      "command": "node",
      "args": [
        "/percorso/completo/notebooklm-mcp-structured/dist/index.js"
      ]
    }
  }
}

Sostituire /percorso/completo/ con il percorso effettivo della cartella in cui si è scaricato il server.

Esempio per Windows:

{
  "mcpServers": {
    "notebooklm-mcp": {
      "command": "node",
      "args": [
        "D:\\MCP_SERVER\\notebooklm-mcp-structured\\dist\\index.js"
      ]
    }
  }
}

Separatori di percorso su Windows

Su Windows è necessario usare il doppio backslash (\\) nei percorsi all'interno del file JSON, oppure in alternativa lo slash singolo (/). Un singolo backslash non funziona perché JSON lo interpreta come carattere di escape.

Se il file contiene già configurazioni per altri server MCP, aggiungere la voce "notebooklm-mcp" all'interno dell'oggetto mcpServers esistente, separandola con una virgola dall'elemento precedente.

Verificare l'installazione¶

Dopo aver salvato il file di configurazione chiudere e riavviare Claude Desktop. All'avvio Claude rileva automaticamente il nuovo server MCP.

Per verificare che l'installazione sia andata a buon fine scrivere nella chat:

Verifica che NotebookLM sia configurato correttamente

Claude interroga il server MCP con il tool get_health e conferma se il collegamento è attivo. A questo punto il server è installato ma non ancora autenticato con Google. Questo passaggio è descritto nel capitolo successivo.

Sotto il cofano

Il file claude_desktop_config.json è il registro centrale dei server MCP di Claude Desktop. Quando Claude si avvia legge questo file e lancia ogni server elencato come processo separato. Il server NotebookLM MCP comunica con Claude attraverso il protocollo MCP (Model Context Protocol), uno standard aperto che Anthropic ha pubblicato per permettere a chiunque di sviluppare estensioni per Claude. Ogni server MCP mette a disposizione dei tool, strumenti che Claude può invocare durante la conversazione per compiere azioni specifiche.