Come collegare uno Storage Box di Hetzner a Claude

Hetzner Storage Box in Claude

In breve: aggiungi lo Storage Box ad AnythingMCP come connettore File Search via SFTP sulla porta 23, idealmente con un sub-account limitato a una sola cartella. AnythingMCP indicizza il testo completo di quella cartella e mantiene l'indice sincronizzato. Poi collega AnythingMCP a claude.ai, all'app desktop di Claude e a Claude Code. Claude può trovare i file per nome e per contenuto, leggere le pagine di cui ha bisogno e darti il file stesso, come allegato o tramite un link di download temporaneo. Sullo Storage Box non viene mai scritto nulla.

Un assistente AI non può aprire uno Storage Box da solo, 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

• Il nome host dello Storage Box: uXXXXXX.your-storagebox.de.
• Il supporto SSH attivato nelle impostazioni dello Storage Box. SFTP funziona sulla porta 23, non sulla 22.
• L'utente principale o, meglio ancora, un sub-account limitato a una cartella (Robot → Storage Box → Sub-accounts).
• Un workspace AnythingMCP: AnythingMCP Cloud (7 giorni gratuiti) oppure la tua installazione self-hosted.

Un sub-account vede solo la propria cartella. Creane uno per AnythingMCP e il connettore non potrà leggere il resto dello Storage Box, qualunque cosa tu selezioni nella procedura guidata.

Configurazione

Passo 1 — Configura il connettore File Search

In AnythingMCP apri il Marketplace e scegli Hetzner Storage Box (File Search): si apre la procedura guidata di File Search con SFTP e le impostazioni per lo Storage Box. (Oppure apri Connectors → New → File Search e usa la scorciatoia Hetzner Storage Box.)

1. Connetti. Inserisci uXXXXXX.your-storagebox.de, la porta 23, il sub-account e la sua password, oltre alla cartella da usare.
2. Testa. AnythingMCP si connette, esegue 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. Mostra anche la chiave host SSH del server come fingerprint: confermala una volta e da quel momento AnythingMCP rifiuta una chiave diversa prima che la password venga inviata, proteggendoti da un server che si finge il tuo.
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ì Claude 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à; se 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 "Report esportati e archivio documenti del team di contabilità, PDF ed Excel, 2019–2026". Questo testo dice a Claude cosa contiene la cartella e quando cercarvi. Se sul server è configurato un modello AI, la procedura guidata può redigerla con l'AI e indica esattamente cosa viene inviato (nomi di cartelle, nomi di file, i primi 2.000 caratteri di un massimo di 20 file di esempio, dati personali mascherati); altrimenti la bozza viene creata a partire dalla struttura delle cartelle. Modificala come preferisci.
5. Attiva. Scegli il prefisso degli strumenti, l'intervallo di sincronizzazione e i server MCP a cui assegnare il connettore, poi clicca su Activate.

La prima sincronizzazione parte subito e viene eseguita in un servizio separato in background: Claude 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 Claude

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.

Percorso consigliato: funziona su claude.ai web senza modificare alcun file di configurazione.

1. In Claude apri Customize → Connectors.
2. Clicca su +, poi su Add custom connector.
3. Inserisci un nome, ad es. Storage Box, e l'URL del server MCP remoto https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID, poi clicca su Add.
4. Clicca su Connect e accedi ad AnythingMCP (OAuth) per consentire l'accesso.

Lo stesso connettore compare nell'app desktop di Claude. In Claude Code: claude mcp add --transport http anythingmcp https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID --header "X-API-Key: <your MCP API key>".

Passo 4 — Chiedi

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

Cosa può fare Claude con i file

<prefix> è il prefisso degli strumenti che scegli nella procedura guidata, 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 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'AI come immagini. I PDF scansionati senza livello di testo vengono letti con OCR in Enterprise.

Prompt da provare in Claude

• "Cerca nell'archivio il bilancio annuale 2024 e riassumi i dati sul fatturato."
• "Quali report esportati citano Nordtor come fornitore?"
• "Trova ogni riga Excel con il centro di costo 4711."
• "Dammi l'esportazione mensile più recente come link di download."

Come funziona la sincronizzazione

AnythingMCP confronta la dimensione e la 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 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 reperibile per nome, con il motivo indicato nella scheda Files.

La sincronizzazione viene eseguita nel proprio servizio in background, separato dal server che risponde a Claude: una prima sincronizzazione di grandi dimensioni 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, Claude 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 Box.
• Solo il tuo workspace. L'indice è memorizzato per workspace e ogni query è limitata a esso, dall'applicazione e ancora dal database (Row-Level Security).
• Le credenziali sono memorizzate cifrate e decifrate solo nel servizio di sincronizzazione in background. Claude 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 all'interno di un file.
• Sub-account. Limitato a una cartella, tiene il resto dello Storage Box fuori portata.
• Host key fissata. La chiave host SSH dello Storage Box viene verificata a ogni connessione.
• 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 ad 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 del piano Team; l'edizione Community gratuita non include File Search dopo la prova. Tutti i piani.

FAQ

Funziona con il piano Free di Claude? Sì. I piani Free possono aggiungere un connettore personalizzato, e AnythingMCP ne conta come uno solo, indipendentemente da quanti connettori inserisci sul server.

Perché la porta 23? Uno Storage Box offre SFTP sulla porta 23 una volta che il supporto SSH è attivato nelle sue impostazioni.

Utente principale o sub-account? Un sub-account limitato a una cartella: puoi crearlo in Robot sotto Storage Box → Sub-accounts e tiene AnythingMCP lontano da tutto il resto presente sul box.

AnythingMCP copia tutto lo Storage 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. 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'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 uno Storage Box di Hetzner a ChatGPT
• Collega uno Storage Box di Hetzner a Gemini
• Collega uno Storage Box di Hetzner a Microsoft Copilot
• Collega uno Storage Box di Hetzner a Cursor
• Collega uno Storage Box di Hetzner a Muse
• Altre fonti di file in Claude: server SFTP, server FTP / FTPS, server WebDAV, bucket S3, Nextcloud, ownCloud, Synology NAS, QNAP NAS, archiviazione Fritz!Box, Cartella di rete (self-hosted)