Come collegare un bucket S3 a Claude

Bucket S3 in Claude

Risposta breve: aggiungi il bucket ad AnythingMCP come connettore File Search con una chiave che può solo elencarlo e leggerlo. AnythingMCP indicizza il testo completo dei documenti sotto il prefisso che scegli 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 che gli servono e darti il file stesso, in allegato o come link di download temporaneo. Nel bucket non viene mai scritto nulla.

Un assistente IA non può aprire da solo un bucket S3, 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

• L'endpoint: vuoto per Amazon S3, per esempio https://fra1.digitaloceanspaces.com per DigitalOcean Spaces, oppure l'URL del tuo MinIO.
• La regione e il nome del bucket.
• Una chiave di accesso che può solo elencare e leggere questo bucket.
• Un workspace AnythingMCP: AnythingMCP Cloud (7 giorni gratis) oppure una tua installazione self-hosted.

S3 non ha vere cartelle: le "cartelle" che vedi nella procedura guidata sono prefissi delle chiavi, e quello che scegli limita ciò che viene indicizzato. Funzionano Amazon S3, DigitalOcean Spaces, MinIO, Wasabi, Hetzner Object Storage e Backblaze B2.

Configurazione

Passo 1 — Configura il connettore File Search

In AnythingMCP apri il Marketplace e scegli S3 bucket (File Search), oppure apri Connectors → New → File Search e scegli S3. Una breve procedura guidata ti accompagna; non c'è nessun lungo modulo da compilare.

1. Connetti. Inserisci l'endpoint (vuoto per Amazon S3), la regione, il bucket, la chiave di accesso con il suo secret e il prefisso da usare, per esempio invoices/.
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.
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 anzianità; 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 "Fatture fornitori e bolle di consegna archiviate, PDF, 2023–2026". Questo testo dice a Claude cosa contiene la cartella e quando cercarvi. Se sul server è configurato un modello IA, la procedura guidata può generare la bozza 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 costruita dalla struttura della cartella. Modificala come preferisci.
5. Attiva. Scegli il prefisso dei tool, l'intervallo di sincronizzazione e i server MCP che ricevono il connettore, e clicca su Activate.

La prima sincronizzazione parte subito e gira in un servizio in background separato: 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, per esempio S3 documents, 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 che corrispondono e risponde con 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 dei tool che scegli nella procedura guidata, per esempio pricelists. Ogni tool tranne _share_file legge soltanto.

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 modelli 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'IA come immagini. I PDF scansionati senza livello di testo vengono letti con OCR su Enterprise.

Prompt da provare in Claude

• "Cerca nel prefisso delle fatture tutte le fatture di Nordtor del 2025 e somma i totali."
• "Trova la bolla di consegna per l'ordine 4711-200 e dimmi cosa è stato consegnato."
• "Quali documenti nel bucket menzionano il contratto quadro Kessler?"
• "Dammi il PDF dell'ultimo report mensile come link di download."

Come funziona la sincronizzazione

Ogni oggetto ha un ETag. AnythingMCP lo confronta con l'ultima esecuzione e scarica solo gli oggetti nuovi e modificati. I file il cui contenuto è identico alla versione indicizzata vengono riconosciuti dal checksum (SHA-256) e non vengono rielaborati. 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 gira in un proprio servizio in background, separato dal server che risponde a Claude: 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, Claude 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 si limita a elencare e leggere. Non ha alcun tool che scriva, rinomini o elimini nel bucket.
• 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. Su Enterprise puoi anche consentire o negare cartelle per ruolo.
• Il contenuto dei file è dato. I tool dicono al modello di non seguire mai istruzioni trovate all'interno di un file.
• Una chiave per un solo bucket. Dai ad AnythingMCP una chiave che può solo elencare e leggere questo bucket, non la chiave principale del tuo account.
• 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 è impostato 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

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

Funziona con DigitalOcean Spaces, MinIO o Wasabi? Sì. Inserisci l'endpoint del provider, per esempio https://fra1.digitaloceanspaces.com per Spaces o l'URL del tuo MinIO; lascialo vuoto per Amazon S3.

Quali permessi servono alla chiave? Elencare e leggere questo bucket, nient'altro. Il connettore non scrive mai nel bucket.

AnythingMCP Cloud può raggiungere un MinIO nella rete del nostro ufficio? No. Sul Cloud l'endpoint deve essere su internet pubblico. Esegui AnythingMCP self-hosted accanto a un MinIO privato.

AnythingMCP copia tutto il bucket? 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 si cercano 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'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 IA come link di download
• Collega un bucket S3 a ChatGPT
• Collega un bucket S3 a Gemini
• Collega un bucket S3 a Microsoft Copilot
• Collega un bucket S3 a Cursor
• Collega un bucket S3 a Muse
• Altre fonti di file in Claude: Server SFTP, Server FTP / FTPS, Server WebDAV, Nextcloud, ownCloud, Synology NAS, QNAP NAS, Archivio Fritz!Box, Hetzner Storage Box, Cartella di rete (self-hosted)