Come collegare lo storage della Fritz!Box a Gemini

Lo storage della Fritz!Box in Gemini

Risposta breve: attiva l'accesso FTP e l'accesso a Internet allo storage sulla Fritz!Box, quindi aggiungilo ad AnythingMCP come connettore File Search tramite FTPS con l'indirizzo MyFRITZ. AnythingMCP indicizza il testo completo dell'unità USB o dello storage NAS e mantiene l'indice sincronizzato. Poi collega AnythingMCP a Gemini CLI. Gemini può trovare i file per nome e per contenuto, leggere le pagine che gli servono e darti il file stesso, in allegato o come link di download temporaneo. Nulla viene mai scritto sullo storage della Fritz!Box.

Un assistente AI non può aprire da solo lo storage di una Fritz!Box, e uno che ci riuscisse 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

• Accesso tramite FTP e Accesso a Internet allo storage attivati sulla Fritz!Box (Rete domestica → USB / Storage).
• L'indirizzo MyFRITZ della box e la porta FTP che mostra.
• Un utente Fritz!Box con accesso solo allo storage.
• Un workspace AnythingMCP: AnythingMCP Cloud (7 giorni gratis) o la tua installazione self-hosted.

La Fritz!Box cifra la connessione con un certificato autofirmato. Va bene così: confermi la sua impronta (fingerprint) una sola volta nel passaggio di test del wizard, e da quel momento AnythingMCP rifiuta qualsiasi altro certificato.

Configurazione

Passaggio 1 — Configura il connettore File Search

In AnythingMCP apri il Marketplace e scegli Fritz!Box storage (File Search): si apre il wizard di File Search con FTPS e le impostazioni per la Fritz!Box. (Oppure apri Connectors → New → File Search e usa la scorciatoia Fritz!Box.)

1. Connetti. Inserisci l'indirizzo MyFRITZ, la porta FTP mostrata dalla box, l'utente Fritz!Box e la sua password, e la cartella dello storage da usare.
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, login, cartella) con cosa correggere quando un passaggio fallisce. La Fritz!Box usa un certificato autofirmato: il wizard mostra la sua impronta e tu la confermi una sola volta. Da quel momento AnythingMCP rifiuta un certificato diverso prima ancora che la password venga inviata.
3. Scansiona. Clicca 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 selezioni 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, ad esempio "Documenti Office sull'unità USB: fatture, offerte e lettere, PDF e Word, 2020–2026". Questo testo dice a Gemini cosa contiene la cartella e quando cercarvi. Se sul server è configurato un modello AI, il wizard può redigerla con l'AI e dice 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 costruita a partire dalla struttura delle cartelle. Modificala come preferisci.
5. Attiva. Scegli il prefisso dei tool, l'intervallo di sincronizzazione e i server MCP che ricevono il connettore, quindi clicca 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.

Passaggio 2 — Copia l'URL del server

In MCP Servers apri il server scelto nel wizard e copia il suo URL.

Passaggio 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 riporti 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ò chiamare i tool di ricerca file.

Passaggio 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 indicando 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 dei tool che scegli nel wizard, ad esempio pricelists. Ogni tool tranne _share_file è di sola lettura.

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 loro allegati; .rtf, .epub, .xps; Apple Pages, Numbers e Keynote (tramite l'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'AI come immagini. I PDF scansionati senza livello di testo vengono letti con OCR su Enterprise.

Prompt da provare in Gemini

• "Trova la fattura di Kessler per la riparazione del riscaldamento e dimmi l'importo."
• "Quali offerte sull'unità USB sono di quest'anno?"
• "Cerca nella cartella delle lettere qualsiasi cosa riguardi l'affitto dell'ufficio."
• "Dammi il documento fiscale più recente come link di download."

Come funziona la sincronizzazione

AnythingMCP confronta dimensione e data di modifica di ogni file con l'ultima esecuzione e scarica solo i file nuovi e modificati. I file il cui contenuto è identico alla versione indicizzata vengono riconosciuti tramite il 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 trovabile 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 voluminosa 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 avvisato 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 si limita a elencare e leggere. Non ha alcun tool che scriva, rinomini o elimini sullo storage della Fritz!Box.
• Solo il tuo workspace. L'indice è archiviato per workspace e ogni query è limitata a esso, dall'applicazione e ancora dal database (Row-Level Security).
• Le credenziali sono archiviate 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. Su 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 all'interno di un file.
• Certificato fissato (pinned). Il certificato autofirmato che hai confermato viene verificato a ogni connessione, prima che la password venga inviata.
• Un utente solo per lo storage. L'utente Fritz!Box che dai ad AnythingMCP dovrebbe avere accesso allo storage e a nient'altro, non alle impostazioni della box.
• AnythingMCP Cloud si connette solo a server su Internet pubblico: un host in una rete privata viene rifiutato, anche dopo un redirect. Un server nella rete del tuo ufficio deve essere raggiungibile dall'esterno, oppure esegui AnythingMCP in self-hosting 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 è impostato da FILES_MAX_FILE_BYTES (100 MB per impostazione predefinita). File Search in self-hosting richiede una licenza a pagamento o la prova di 30 giorni, che ha i limiti del piano 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é il wizard mi chiede di confermare un'impronta (fingerprint)? La Fritz!Box usa un certificato autofirmato, per il quale nessuna autorità pubblica garantisce. Confermi la sua impronta una sola volta; da quel momento AnythingMCP rifiuta qualsiasi altro certificato.

Quale indirizzo devo inserire? L'indirizzo MyFRITZ della box e la porta FTP che mostra. Lo storage deve avere l'accesso a Internet attivato, altrimenti AnythingMCP Cloud non riesce a raggiungerlo.

AnythingMCP copia tutto lo storage della Fritz!Box? 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. I documenti aziendali vengono cercati per nomi, codici e numeri esatti, dove 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'AI
• Trova i prezzi nei listini dei fornitori con l'AI
• Cerca nei file di Nextcloud e WebDAV con l'AI
• Condividi file da una chat AI come link di download
• Collega lo storage della Fritz!Box a Claude
• Collega lo storage della Fritz!Box a ChatGPT
• Collega lo storage della Fritz!Box a Microsoft Copilot
• Collega lo storage della Fritz!Box a Cursor
• Collega lo storage della Fritz!Box a Muse
• Altre fonti di file in Gemini: server SFTP, server FTP / FTPS, server WebDAV, bucket S3, Nextcloud, ownCloud, Synology NAS, QNAP NAS, Hetzner Storage Box, Cartella di rete (self-hosted)