# Connettore per assistenti

Collega ChatGPT, Claude o Meta Muse alla tua libreria di Reading Journey, poi chiedigli di aggiungere libri, segnarli come finiti, dargli un voto o pianificare le tue Prossime letture. La configurazione richiede circa due minuti e il connettore è gratuito.

Indirizzo del server: `https://mcp.readingjourney.app`

## Prima di iniziare

- Un account Reading Journey. Puoi accedere con Apple, Google o email e password, oppure creare un account durante la configurazione.
- Usa lo stesso metodo di accesso che usi nell’app, così l’assistente si collega alla tua libreria esistente.
- **Claude** (web, app desktop e app mobile), ChatGPT o **Meta Muse**.
- Non serve RJ+, e per collegarti non devi nemmeno avere l’app installata.

## Collegare Claude

Reading Journey è nella directory dei connettori di Claude, quindi non devi incollare niente.

1. Apri [Reading Journey nella directory di Claude](https://claude.ai/directory/reading-journey) e clicca su **Connect to Claude**.
2. Nella pagina di Reading Journey, scegli **Continua con Apple** o **Continua con Google**, oppure accedi con email e password.
3. Controlla cosa potrà fare Claude e clicca su **Consenti**. Poi torni su Claude.
4. In una chat, apri il menu **+**, scegli **Connectors** e assicurati che Reading Journey sia attivo. Poi chiedi pure.

Nei piani Team ed Enterprise, prima un proprietario deve attivare il connettore in **Organization settings > Connectors**; poi ogni membro si collega con il proprio account Reading Journey. Una volta collegato sul web, funziona anche nelle app mobile di Claude.

## Collegare Meta Muse

1. In Muse, apri **Settings > Connectors**.
2. Scegli **Add custom connector** e incolla `https://mcp.readingjourney.app`.
3. Nella pagina di Reading Journey, accedi come fai nell’app, controlla le autorizzazioni e scegli **Consenti**.

I menu di Muse possono cambiare da una versione all’altra; se non trovi Connectors, consulta la guida di Meta sui connettori personalizzati.

## Provalo

Apri una nuova chat e chiedi, per esempio:

- “Aggiungi Piranesi di Susanna Clarke al mio Reading Journey come Da leggere e mettilo nelle Prossime letture.”
- “Cosa c’è nelle mie Prossime letture? Sostituisci il terzo con La mano sinistra delle tenebre.”
- “Ieri ho finito Domani, e domani, e domani. Segnalo come finito e dagli 4,5 stelle.”
- “Crea una raccolta chiamata Gruppo di lettura 2026 e aggiungi tutti i libri Da leggere di autori giapponesi.”
- “Quali libri sto leggendo adesso e quali ho messo in pausa?”
- “Mollo Infinite Jest. Segnalo come non finito.”
- “Consigliami tre romanzi cozy fantasy che non ho già e aggiungi quello che scelgo.”

Poi apri Reading Journey e troverai le tue modifiche. Se l’app è già aperta, passa a un’altra app e torna indietro per sincronizzare.

## Cosa può e non può fare un assistente

| Può | Non può |
| --- | --- |
| Vedere e modificare i tuoi libri, stati, valutazioni, raccolte, Prossime letture, note, recensioni e voci del diario | Vedere le tue foto o le posizioni esatte |
| Aggiungere libri, cambiarne lo stato, dargli un voto, registrare i progressi e impostare obiettivi | Eliminare una raccolta, un obiettivo, una lettura o un libro con una cronologia di lettura senza prima chiedertelo |
| Gestire Prossime letture e Top 4, creare e riempire raccolte, aggiungere foto quando lo chiedi | Modificare il tuo account, l’abbonamento o le impostazioni |

La pagina delle autorizzazioni che vedi quando ti colleghi dice la stessa cosa: l’assistente può leggere e modificare le tue note, recensioni e voci del diario, e può aggiungere, sostituire o rimuovere foto quando lo chiedi, ma non può mai vederle. Hai fatto il collegamento prima del 1° novembre 2026? Rifallo per dargli questo accesso.

## Elenco degli strumenti

Non devi mai usare gli strumenti tu: chiedi a parole tue e l’assistente sceglie quello giusto. Ogni strumento agisce solo sulla tua libreria.

| Strumento | Tipo | A cosa serve |
| --- | --- | --- |
| `list_books` | Lettura | Elenca i tuoi libri con stato, valutazione, Prossime letture e raccolte; può filtrare per stato, raccolta o parole |
| `get_book` | Lettura | Un libro con le date di ogni lettura, la tua valutazione, le raccolte e la posizione nelle Prossime letture |
| `list_collections` | Lettura | Le tue raccolte e quanti libri contiene ognuna |
| `get_next_up` | Lettura | I libri delle tue Prossime letture, in ordine |
| `add_book` | Scrittura | Aggiunge un libro (di default come Da leggere); non duplica mai un libro che hai già |
| `set_status` | Scrittura | Inizia, mette in pausa, finisce o abbandona un libro, oppure lo segna come Da leggere |
| `rate_book` | Scrittura | Valuta la lettura in corso da 0,25 a 5 stelle, oppure cancella la valutazione |
| `set_next_up` | Scrittura | Mette nelle Prossime letture un libro non ancora iniziato |
| `remove_from_next_up` | Scrittura | Toglie un libro dalle Prossime letture |
| `create_collection` | Scrittura | Crea una raccolta |
| `add_to_collection` | Scrittura | Mette un libro in una raccolta |
| `remove_from_collection` | Scrittura, chiede prima | Toglie un libro da una raccolta; il libro resta |
| `remove_book` | Scrittura, chiede prima | Elimina un libro che hai solo aggiunto; mai uno con cronologia di lettura, valutazione, voce del diario, progressi, posto nella Top 4, nota o foto di copertina |

Per gli sviluppatori: gli scope OAuth sono `mcp` (lettura e modifica; è quello che concede Consenti), `library:read` e `library:write`. Un collegamento resta attivo finché lo usi; dopo 60 giorni di inattività, ricollegati.

## Limiti e sicurezza

- Prima di rimuovere un libro o di toglierne uno da una raccolta, l’assistente ha l’istruzione di chiedertelo.
- Se modifichi qualcosa sul telefono, la tua modifica prevale su quella dell’assistente.
- Gli assistenti hanno l’istruzione di non seguire mai indicazioni scritte nei titoli dei libri, nei nomi degli autori o delle raccolte.
- Ogni collegamento può leggere la tua libreria 60 volte al minuto e modificarla 30 volte al minuto.
- Il connettore non conta come dispositivo, quindi non influisce sulla sincronizzazione del piano gratuito.

## Scollegare

Rimuovi il connettore dall’assistente: in Claude, **Customize > Connectors**, seleziona Reading Journey e scegli **Remove**; in Muse, **Settings > Connectors**. Se elimini il tuo account Reading Journey, tutti gli assistenti vengono scollegati. Se esci dall’app, no.

## Risoluzione dei problemi

| Cosa vedi | Cosa fare |
| --- | --- |
| “Questa e-mail e questa password non corrispondono a nessun account.” | Controlla di non aver sbagliato a scrivere, oppure reimposta la password nell’app con **Password dimenticata?**. Se nell’app usi Apple o Google, scegli invece **Continua con Apple** o **Continua con Google**. |
| L’assistente vede una libreria vuota | Hai effettuato l’accesso con un metodo diverso da quello dell’app. Scollega, ricollega e usa lo stesso metodo. |
| “Prima conferma il tuo indirizzo e-mail, poi accedi.” | Apri l’email di conferma che ti abbiamo inviato, poi accedi di nuovo. |
| “Questa pagina è scaduta.” | Torna all’assistente e collega di nuovo Reading Journey. |
| Il provider ha rifiutato la registrazione dell’app | Quell’assistente non è ancora supportato. Claude, ChatGPT e Meta Muse sì. |
| Le modifiche non compaiono nell’app | Assicurati che l’app abbia effettuato l’accesso allo stesso account, poi passa a un’altra app e torna indietro. Con un account gratuito, le modifiche arrivano al dispositivo che sincronizza. |
| “…can only be removed in the Reading Journey app.” | Il libro ha una cronologia di lettura; eliminalo dalla pagina del libro nell’app. |
