Come collegare i file di Nextcloud a Gemini

I file di Nextcloud in Gemini

Risposta breve: aggiungi il tuo Nextcloud ad AnythingMCP come connettore File Search, con una password per app tramite WebDAV. AnythingMCP indicizza il testo completo della cartella che scegli e mantiene l'indice sincronizzato. Poi collega AnythingMCP a Gemini CLI. Gemini può trovare i file per nome e per contenuto, leggere le pagine di cui ha bisogno e darti il file stesso, in allegato o come link di download temporaneo. Nel tuo Nextcloud non viene mai scritto nulla.

Un assistente IA non può aprire da solo il tuo Nextcloud, e uno che potesse farlo dovrebbe scaricare ogni file per rispondere a una sola domanda. È l'indice a far sì che una domanda come "quanto costa l'articolo NT-601 nel listino attuale?" richieda pochi secondi.

Cosa ti serve

• L'indirizzo WebDAV del tuo Nextcloud: https://YOUR-HOST/remote.php/dav/files/USER/.
• Una password per app di quell'utente (Impostazioni → Sicurezza → Dispositivi e sessioni), mai la password dell'account. Dagli un nome, per esempio AnythingMCP, così puoi revocarla separatamente.
• Un utente che possa leggere le cartelle che vuoi rendere ricercabili. AnythingMCP vede esattamente ciò che vede quell'utente.
• Un workspace AnythingMCP: AnythingMCP Cloud (7 giorni gratis) o la tua installazione self-hosted.

AnythingMCP ha anche un connettore Nextcloud per l'API di Nextcloud: utenti, gruppi, condivisioni, stato del server. Non legge ciò che c'è dentro i tuoi file; lo fa File Search. Usali entrambi se ti servono entrambi. Le offerte Nextcloud gestite, come Hetzner Storage Share, funzionano allo stesso modo.

Configurazione

Passo 1 — Configura il connettore File Search

In AnythingMCP apri il Marketplace e scegli Nextcloud (File Search): si apre la procedura guidata di File Search con le impostazioni per Nextcloud. (Oppure apri Connectors → New → File Search, scegli WebDAV e la scorciatoia Nextcloud.)

1. Connetti. Inserisci l'indirizzo WebDAV, il nome utente e la password per app, e la cartella da usare, per esempio Documents/Projects.
2. Testa. AnythingMCP si connette, effettua l'accesso ed elenca la cartella prima di salvare qualsiasi cosa, e mostra una checklist (indirizzo, raggiungibilità, cifratura, identità del server, accesso, cartella) con cosa correggere quando un passaggio fallisce.
3. Scansiona. Fai clic su Scan folder. AnythingMCP elenca la cartella senza ancora indicizzarla e mostra un albero con il numero di file in ogni sottocartella, i tipi di file e gli anni. Le cartelle che sembrano archivi (Alt, Old, Archive, Backup) sono già deselezionate, così Gemini non cita mai un documento obsoleto. Una barra confronta la tua selezione con il tuo piano mentre spunti cartelle, tipi di file o un limite di età; quando la selezione supera il piano, deseleziona altro o passa a un piano superiore.
4. Descrivi. AnythingMCP prepara una bozza della descrizione del connettore a partire dalla scansione, per esempio "Cartelle di progetto del team vendite, offerte e verbali di collaudo, PDF e Word, 2021–2026". Questo testo dice a Gemini cosa contiene la cartella e quando cercarvi. Se sul server è configurato un modello di IA, la procedura guidata può redigerla con l'IA e indica esattamente cosa viene inviato (nomi delle cartelle, nomi dei file, i primi 2.000 caratteri di un massimo di 20 file di esempio, dati personali mascherati); altrimenti la bozza viene creata dalla struttura delle cartelle. Modificala come preferisci.
5. Attiva. Scegli il prefisso degli strumenti, l'intervallo di sincronizzazione e i server MCP che ricevono il connettore, e fai clic su Activate.

La prima sincronizzazione parte subito e viene eseguita in un servizio separato in background: Gemini e i tuoi altri connettori continuano a rispondere a piena velocità mentre è in corso. La scheda Files del connettore mostra l'avanzamento: file trovati, indicizzati e saltati, l'ultima e la prossima sincronizzazione, e un pulsante Sync now.

Passo 2 — Copia l'URL del server

In MCP Servers apri il server che hai scelto nella procedura guidata e copia il suo URL.

Passo 3 — Aggiungi il connettore in Gemini

L'URL del tuo server: in AnythingMCP apri MCP Servers → il server su cui si trova questo connettore e copia il suo URL (https://cloud.anythingmcp.com/mcp/…). Usalo ovunque questa guida mostri YOUR_SERVER_ID.

Gemini CLI legge i server MCP da ~/.gemini/settings.json (su Windows %USERPROFILE%\.gemini\settings.json). Aggiungi:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Crea una chiave API MCP in AnythingMCP sotto MCP Servers → il tuo server → API keys e incollala al posto di YOUR_MCP_API_KEY.
2. Salva il file e riavvia gemini.
3. Esegui /mcp dentro Gemini CLI (oppure gemini mcp list nella tua shell): anythingmcp dovrebbe risultare connesso.
4. Inizia a scrivere i prompt: Gemini CLI ora può richiamare i tool di ricerca nei file.

Passo 4 — Chiedi

Avvia una nuova chat e fai domande sul contenuto dei tuoi file. Gemini cerca prima nell'indice, apre le pagine che corrispondono e risponde con il nome del file, la pagina e la data del file, così puoi verificare la fonte.

Cosa può fare Gemini con i file

<prefix> è il prefisso degli strumenti che scegli nella procedura guidata, per esempio pricelists. Ogni tool tranne _share_file esegue solo letture.

File supportati: il testo viene estratto da oltre 100 tipi di file: PDF (pagina per pagina); Word, Excel e PowerPoint comprese le varianti con macro e modello e .xlsb; OpenDocument; Outlook .msg, .eml e .mbox con il testo dei relativi allegati; .rtf, .epub, .xps; Apple Pages, Numbers e Keynote (tramite la loro anteprima PDF); .svg e il testo dei disegni CAD .dxf; CSV, Markdown, HTML, XML, JSON, YAML, calendari e contatti; e codice sorgente. Ogni altro file viene comunque trovato per nome, e le pagine PDF e le immagini possono essere mostrate all'IA come immagini. I PDF scansionati senza livello di testo vengono letti con l'OCR in Enterprise.

Prompt da provare in Gemini

• "Trova l'offerta che abbiamo inviato a Kessler per il tetto del magazzino e riassumi le voci di prezzo."
• "Quali cartelle di progetto contengono un verbale di collaudo firmato di quest'anno?"
• "Cerca nei verbali delle riunioni le decisioni sul nuovo ERP e elencale con le date."
• "Dammi l'ultima versione del manuale per i dipendenti come link di download."

Come funziona la sincronizzazione

Nextcloud comunica tramite WebDAV un indicatore di modifica (ETag) per ogni file. AnythingMCP lo confronta con l'ultima esecuzione e scarica solo i file nuovi e modificati. I file il cui contenuto è identico alla versione indicizzata vengono riconosciuti dal loro checksum (SHA-256) e non vengono elaborati di nuovo. I file eliminati escono dall'indice. Un file che non può essere letto viene ritentato nelle sincronizzazioni successive e, dopo tre errori (subito per i file protetti da password), resta ricercabile per nome, con il motivo indicato nella scheda Files.

La sincronizzazione viene eseguita in un proprio servizio in background, separato dal server che risponde a Gemini: una prima sincronizzazione ampia non rallenta le tue domande, e la ricerca continua a funzionare con l'ultimo indice mentre una sincronizzazione è in corso.

Quando la cartella supera il tuo piano, la sincronizzazione si mette in pausa prima di scaricare qualsiasi cosa, invece di indicizzarne solo una parte: la scheda Files mostra quanti file contiene ora la cartella rispetto al tuo piano, Gemini continua a cercare nei file già indicizzati e viene informato che i file più recenti potrebbero mancare, e tu puoi deselezionare cartelle o passare a un piano superiore. Una cartella in pausa viene ricontrollata una volta al giorno e riprende da sola quando rientra nei limiti.

Sicurezza

• Sola lettura. Il connettore elenca e legge soltanto. Non ha alcun tool che scriva, rinomini o elimini sul tuo Nextcloud.
• Solo il tuo workspace. L'indice è memorizzato per workspace e ogni query è limitata a esso, dall'applicazione e di nuovo dal database (Row-Level Security).
• Le credenziali sono memorizzate cifrate e decifrate solo nel servizio di sincronizzazione in background. Gemini e i tuoi colleghi non le vedono mai.
• Chi vede cosa segue i tuoi ruoli MCP: un ruolo senza i tool per i file non li vede. In Enterprise puoi anche consentire o negare cartelle per ruolo.
• Il contenuto dei file è dato. I tool dicono al modello di non seguire mai le istruzioni trovate dentro un file.
• Password per app. Può essere revocata separatamente in Nextcloud, senza cambiare la password dell'account.
• Condivisioni rispettate. AnythingMCP vede ciò che vede l'utente connesso: condividi con quell'utente solo ciò che deve essere ricercabile.
• AnythingMCP Cloud si connette solo a server su internet pubblico: un host in una rete privata viene rifiutato, anche dopo un reindirizzamento. Un server nella rete del tuo ufficio deve essere raggiungibile dall'esterno, oppure esegui AnythingMCP self-hosted accanto a esso.

Limiti per piano

Self-hosted: Starter include un connettore File Search con fino a 500 file, Team tre connettori con 2.000 file, Enterprise non ha limiti e sincronizza fino a ogni 5 minuti; il file più grande è definito da FILES_MAX_FILE_BYTES (100 MB per impostazione predefinita). File Search self-hosted richiede una licenza a pagamento o la prova di 30 giorni, che ha i limiti di Team; l'edizione Community gratuita non ha File Search dopo la prova. Tutti i piani.

FAQ

Dove cerca Gemini CLI i server MCP? In ~/.gemini/settings.json per il tuo utente, oppure in .gemini/settings.json all'interno di un progetto. gemini mcp list mostra ogni server e se si connette.

Perché una password per app e non la mia password di Nextcloud? Una password per app può essere revocata separatamente, senza cambiare la password dell'account. Le istruzioni per Nextcloud in AnythingMCP chiedono una password per app, mai la password dell'account.

Qual è la differenza rispetto al connettore Nextcloud? Il connettore Nextcloud dialoga con l'API di Nextcloud: utenti, gruppi, condivisioni, stato del server. Il connettore File Search indicizza e cerca il contenuto dei tuoi file.

Il nostro Nextcloud è raggiungibile solo nella rete dell'ufficio. AnythingMCP Cloud lo richiede su internet tramite HTTPS. Un AnythingMCP self-hosted lo raggiunge dopo che un amministratore ha aggiunto l'host alla allowlist in uscita (Admin → Settings oppure SSRF_ALLOWED_HOSTS).

AnythingMCP copia tutto il tuo Nextcloud? No. AnythingMCP conserva il testo estratto, non i file. Un file viene riletto solo quando è cambiato, o quando chiedi il file stesso.

Viene usata la ricerca vettoriale? No. Nei documenti aziendali si cercano nomi, codici e numeri esatti, e la ricerca per parole chiave con risultati a livello di pagina è più affidabile degli embedding.

Correlati

• Cerca nel file server della tua azienda con l'IA
• Trova i prezzi nei listini dei fornitori con l'IA
• Cerca nei file di Nextcloud e WebDAV con l'IA
• Condividi file da una chat con l'IA come link di download
• Collega i file di Nextcloud a Claude
• Collega i file di Nextcloud a ChatGPT
• Collega i file di Nextcloud a Microsoft Copilot
• Collega i file di Nextcloud a Cursor
• Collega i file di Nextcloud a Muse
• Altre fonti di file in Gemini: server SFTP, server FTP / FTPS, server WebDAV, bucket S3, ownCloud, Synology NAS, QNAP NAS, archiviazione Fritz!Box, Hetzner Storage Box, cartella di rete (self-hosted)