Collegare assistenti IA

Regalzeile è un server MCP (Model Context Protocol): gli assistenti IA che parlano MCP — Claude (claude.ai, Claude Desktop, Claude sul telefono, Claude Code), ChatGPT e altri — si collegano alla tua biblioteca come connettore. L’assistente può allora cercare nella tua biblioteca, consultare articoli e posizioni, mostrare i prestiti — e, se lo permetti, aggiungere libri per ISBN, modificarli, prestarli e riprenderli, impostare lo stato di lettura e annotare desideri. Eliminare e modificare gli scaffali restano riservati all’app. Il connettore è disponibile per le biblioteche con piano Plus o Completo.

Per edizioni e opere a fogli mobili l’assistente legge e imposta edizione, opera, fogli mobili, raccoglitori e ultimo aggiornamento di un articolo; consultando un articolo indica per ogni copia edificio e stato di aggiornamento. Con lo strumento «Registrare un aggiornamento» (set_supplement_status) registra lo stato di una copia — scelta tramite numero di copia o edificio; un numero più alto alza l’ultimo aggiornamento dell’articolo. Per la circolazione l’assistente mostra quelle in corso con list_circulations (volendo solo quelle in ritardo), ne avvia una con start_circulation e la fa avanzare con advance_circulation: passare, saltare, confermare il ritorno o annullare. Di più in Circolazione. Con il piano Organizzazione, get_report fornisce il rapporto annuale per sede: patrimonio, nuove acquisizioni, valore d’acquisto, scarti e prestiti — per i proprietari e i membri con accesso a tutte le collezioni. Di più in Rapporti.

Quando presta, l’assistente accetta anche l’indirizzo e-mail della persona; senza data di restituzione vale la durata predefinita del prestito della biblioteca. Nell’elenco dei prestiti indica l’e-mail, quante volte è già stato mandato un promemoria e un’eventuale proroga.

Collegare

L’indirizzo del server è https://regalzeile.ch/api/mcp. Ogni assistente che supporta server MCP remoti con OAuth si collega lì; ID client e segreto non servono, il client si registra da solo. Con Claude, per esempio:

1. In Claude apri le impostazioni, poi «Connectors» e «Aggiungi connettore personalizzato».
2. Inserisci l’indirizzo https://regalzeile.ch/api/mcp; lascia vuoti ID client e segreto.
3. Accedi a Regalzeile, scegli la biblioteca e clicca «Consenti». Ricevi un’e-mail «Nuova connessione».

In Claude Code: claude mcp add --transport http regalzeile https://regalzeile.ch/api/mcp. Altri assistenti (per esempio ChatGPT, Cursor o VS Code) chiedono lo stesso indirizzo; l’autorizzazione funziona allo stesso modo: accedi, scegli la biblioteca, «Consenti».

Diritti

L’assistente ha esattamente i diritti della persona connessa nella biblioteca scelta: i lettori non vedono prezzi, prestiti né nulla di privato, e non possono aggiungere nulla. Una biblioteca per connessione — per una seconda, collega Regalzeile un’altra volta.

Scollegare

In Impostazioni → App collegate vedi ogni connessione con biblioteca, diritti e ultimo uso; «Scollega» revoca subito l’accesso. Anche reimpostare la password scollega tutto.