Il connettore di Noodle fa lavorare un assistente IA nel tuo account Noodle: cerca e legge le pagine, scrive note nei vault che permetti, tiene un diario e gestisce il calendario. Parla MCP (Model Context Protocol), quindi funziona con Claude, ChatGPT e qualunque assistente che supporti i server MCP remoti.
01Indirizzo del connettore
- Noodle Cloud:
https://mcp.noodle.shelfapp.it/mcp - Il tuo server Noodle: l'indirizzo che Noodle mostra in Impostazioni > Assistenti AI. Per accendere il connettore c'è la guida del server.
Serve un account Noodle su quel server. Il connettore usa OAuth: nessuna password arriva all'assistente.
02Le app Noodle su Noodle Cloud
L'assistente lavora sullo stesso account che usi nelle app Noodle. Per usare Noodle Cloud nelle app:
- Mac e iPhone: Impostazioni > Dati > Noodle Cloud, poi accedi. Se preferisci scrivere l'indirizzo a mano, usa Collega un server con
wss://cloud.noodle.shelfapp.it. - Browser: apri
https://cloud.noodle.shelfapp.it.
L'indirizzo delle app (wss://) e quello del connettore (https://mcp.noodle.shelfapp.it/mcp) sono diversi: il primo serve alle app Noodle, il secondo agli assistenti. Sul Mac Claude Code e Codex possono usare anche il connettore locale dell'app, che funziona senza server: Impostazioni > Assistenti AI > Assistenti su questo Mac.
03Collegare un assistente
Claude, ChatGPT e le altre app degli assistenti
- Aggiungi un connettore personalizzato con l'indirizzo qui sopra: in Claude da Impostazioni > Connettori, in ChatGPT dalle impostazioni di app e connettori.
- L'assistente apre la pagina di consenso di Noodle, che mostra un codice di abbinamento (per esempio
K7QM-4F2T). - Nell'app Noodle, in Impostazioni > Assistenti AI compare una richiesta con lo stesso codice. Approvala solo se hai appena avviato tu il collegamento e il codice coincide.
- Scegli cosa può vedere e premi Approva. Noodle chiede il secondo fattore (Face ID, Touch ID, passkey o codice dell'app). La pagina dell'assistente prosegue da sola.
Claude Code, Codex e gli altri assistenti da terminale
In Noodle, Impostazioni > Assistenti AI > Collega un assistente > Assistenti da terminale, scegli l'accesso e premi Crea chiave. La chiave si vede una volta sola. Per Claude Code:
$ claude mcp add --scope user --transport http noodle https://mcp.noodle.shelfapp.it/mcp --header "Authorization: Bearer <chiave>"Gli altri assistenti usano lo stesso indirizzo con l'intestazione Authorization: Bearer <chiave>. Non incollare la chiave in note, chat o repository. Gli assistenti da terminale che supportano OAuth possono collegarsi anche senza chiave, con la stessa approvazione di sopra.
04Cosa vede l'assistente
- Vault: un interruttore per vault, spento all'inizio; acceso, in sola lettura o anche in scrittura.
- Pagine normali del tuo spazio personale: spente all'inizio.
- Calendario: nessun accesso, sola lettura o lettura e scrittura. I calendari esterni restano in sola lettura e il loro indirizzo segreto non arriva mai all'assistente.
- Mai: password, impostazioni, backup, note protette, il portachiavi di SSH e database.
Dare più accesso chiede il secondo fattore, toglierlo no. L'assistente può chiedere da solo più accesso (chiedi_accesso), con il motivo, ma non ottiene niente finché non approvi nell'app. In Impostazioni > Assistenti AI ogni assistente collegato mostra l'ultimo uso, Accesso per cambiare cosa vede e Revoca, che lo ferma entro mezzo minuto.
Limiti fissi: un assistente non modifica i database, non cancella niente per sempre (le pagine vanno nel Cestino e si ripristinano), non crea più di 200 pagine al giorno né pagine oltre 2 MB. Sostituire una pagina intera salva prima una versione.
05Strumenti
Gli strumenti di sola lettura sono segnati come tali per l'assistente.
| Strumento | Cosa fa |
|---|---|
vault, accesso | I vault concessi con le loro regole, e cosa è concesso in tutto. |
mappa | Titolo e descrizione di ogni nota di un vault o di una cartella, per scegliere le note giuste prima di aprirle. |
cerca | Cerca le pagine per titolo e testo, con un estratto. |
leggi_pagina, elenca | Legge una pagina in Markdown con [[link]] e proprietà; elenca le sottopagine. |
crea_pagina, aggiorna_pagina | Crea una nota; sostituisce una pagina o una sezione, o aggiunge in fondo. |
rinomina_o_sposta, cestina | Rinomina o sposta una pagina nel suo vault; la mette nel Cestino. |
diario | Aggiunge testo alla nota del diario di un giorno. |
allegati, leggi_allegato | Elenca e legge gli allegati: immagini, testo dei PDF, file di testo. |
salute_vault | Link rotti, note orfane, note senza descrizione o da riverificare. |
calendario, promemoria | Legge eventi e promemoria in un intervallo. |
crea_evento, modifica_evento, elimina_evento | Eventi del calendario di Noodle (serve lettura e scrittura). |
crea_promemoria, modifica_promemoria, completa_promemoria, elimina_promemoria | Promemoria (serve lettura e scrittura). |
chiedi_accesso, riduci_accesso | Chiede più accesso (lo approvi nell'app); restituisce subito un accesso. |
06Dati e privacy
Il connettore legge e scrive solo ciò che hai concesso, attraverso il tuo account. Ciò che l'assistente legge va al servizio dell'assistente che hai scelto, secondo le sue condizioni. Su Noodle Cloud i dati restano nell'Unione europea; i dettagli sono nell'informativa privacy.
07Aiuto
Scrivi a info@shelfapp.it dicendo quale assistente usi e cosa è successo. Altro in Assistenza.