In breve
Permetti a Microsoft Copilot di cercare all'interno di un file server Windows, NAS o condivisione di rete (SMB/CIFS o NFS) montata in un AnythingMCP self-hosted: indice full-text di file PDF, Excel, Word e Outlook, sincronizzato in background. Solo self-hosted.
Prova a chiedere
Prompt di esempio per Network folder (File Search)
Clicca su un prompt per copiarlo. Incollalo in Claude, ChatGPT, Cursor, Gemini, Copilot o OpenClaw per eseguirlo contro questo connettore.
Claude è un'AI e può sbagliare. Verifica sempre le risposte.
Cartelle di rete in Microsoft Copilot
Solo self-hosted. La cartella di rete esiste solo in un AnythingMCP self-hosted. Su AnythingMCP Cloud, per raggiungere un NAS usa invece SFTP o WebDAV.
Risposta breve: monta la condivisione in sola lettura sul server che esegue il tuo AnythingMCP self-hosted e aggiungi la cartella come connettore File Search. AnythingMCP indicizza il testo completo di ogni file supportato e mantiene l'indice sincronizzato, mentre i file non lasciano mai la tua rete. Poi collega AnythingMCP a Microsoft 365 Copilot e a Teams tramite un agente di Copilot Studio. Microsoft Copilot può trovare i file per nome e per contenuto, leggere le pagine che gli servono e consegnarti il file stesso, come allegato o come link di download temporaneo. Sulla condivisione non viene mai scritto nulla.
Un assistente AI non può aprire da solo un'unità di rete, 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
- Un AnythingMCP self-hosted con una licenza a pagamento o la prova di 30 giorni. AnythingMCP Cloud non può raggiungere una condivisione di rete: SMB (porta 445) non deve stare su internet.
- La condivisione montata in sola lettura sull'host Docker, per esempio in
/mnt/knowledge(SMB/CIFS o NFS, un file server Windows o un volume NAS). - Accesso shell all'host Docker per modificare
.envedocker-compose.yml.
Configurazione
Passaggio 1 — Monta la condivisione e attiva File Search
- Monta la condivisione in sola lettura sull'host Docker, per esempio in
/mnt/knowledge. - Collegala in sola lettura (bind) ai container
appefiles-worker(vedi il commento indocker-compose.yml) e impostaFILE_SOURCE_ROOTS=/mnt/knowledgein.env. La procedura guidata propone solo cartelle al di sotto di quelle radici. - Attiva i servizi di File Search: aggiungi a
.envFILES_WORKER_URL=http://files-worker:8891,FILES_WORKER_TOKENeFILE_EXTRACTOR_TOKEN(ciascuno conopenssl rand -hex 24) eCOMPOSE_PROFILES=files. - Esegui
docker compose up -d. Connectors → New → File Search mostra se il worker e l'extractor sono raggiungibili.
La documentazione di File Search elenca tutte le impostazioni.
Passaggio 2 — Configura il connettore File Search
In AnythingMCP apri Connectors → New → File Search e scegli Network folder (nel Marketplace: Network folder (File Search)).
- Cartella. Scegli la cartella sotto
FILE_SOURCE_ROOTS, per esempio/mnt/knowledge/Purchasing. - Test. AnythingMCP elenca la cartella prima di salvare qualsiasi cosa e mostra se è leggibile.
- Scansione. 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ì Microsoft Copilot non cita mai un documento obsoleto. Mentre selezioni cartelle, tipi di file o un limite di età, una barra confronta la tua selezione con il tuo piano; se la selezione supera il piano, deseleziona altro o passa a un piano superiore. - Descrizione. AnythingMCP prepara una bozza della descrizione del connettore a partire dalla scansione, per esempio "Condivisione Acquisti: listini e condizioni dei fornitori, PDF ed Excel, tedesco, 2019–2026". Questo testo dice a Microsoft Copilot 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, con i dati personali mascherati); altrimenti la bozza viene costruita a partire dalla struttura delle cartelle. Modificala come preferisci.
- Attivazione. Scegli il prefisso degli strumenti, l'intervallo di sincronizzazione e i server MCP che ricevono il connettore, quindi fai clic su Activate.
La prima sincronizzazione parte subito ed è eseguita in un servizio separato in background: Microsoft Copilot 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 3 — Copia l'URL del server
In MCP Servers apri il server che hai scelto nella procedura guidata e copia il suo URL.
Passaggio 4 — Aggiungi il connettore in Microsoft Copilot
L'URL del tuo server: in AnythingMCP apri MCP Servers → il server su cui si trova questo connettore e copia il suo URL (
https://anythingmcp.example.com/mcp/…con il tuo indirizzo). Usalo ovunque questa guida mostriYOUR_SERVER_ID.
Microsoft Copilot si collega ai server MCP dal cloud di Microsoft, non dal tuo computer, quindi il tuo AnythingMCP ha bisogno di un indirizzo HTTPS pubblico. ./setup.sh nel repository configura dominio, HTTPS e OAuth (guida al deployment). Usa quell'indirizzo ovunque questo passaggio mostri https://anythingmcp.example.com; i file restano sul tuo server.
Microsoft Copilot usa i server MCP tramite agenti creati in Copilot Studio: aggiungi AnythingMCP a un agente come strumento, poi pubblichi l'agente su Microsoft 365 Copilot e Teams. Copilot Studio si collega dal cloud di Microsoft tramite Streamable HTTP, che AnythingMCP supporta.
- In Copilot Studio apri il tuo agente (o creane uno), vai su Tools e scegli Add a tool → New tool → Model Context Protocol.
- Inserisci un Server name (per esempio
AnythingMCP), una Server description che spieghi cosa fa il connettore (per esempio "Cerca e legge i documenti sul nostro file server: listini, contratti, procedure") e il Server URLhttps://anythingmcp.example.com/mcp/YOUR_SERVER_ID. Copilot Studio usa la descrizione per decidere quando chiamare il server. - In autenticazione scegli API key, imposta Type su Header e il nome dell'header su
X-API-Key, poi seleziona Create. - In Add tool scegli Create a new connection, incolla una chiave API MCP di AnythingMCP (MCP Servers → il tuo server → API keys) e seleziona Add to agent.
- Provalo nel riquadro Test dell'agente: chiedi qualcosa che richieda i tool di ricerca file.
- Seleziona Publish, poi Channels → Microsoft 365 and Microsoft Teams, lascia selezionato Make agent available in Microsoft Copilot e scegli Add channel. See agent in Teams lo installa per te; in Microsoft 365 Copilot digita @ e scegli l'agente.
Preferisci l'accesso per singolo utente? Scegli OAuth 2.0 → Dynamic discovery al posto di una chiave API: ogni utente accede ad AnythingMCP la prima volta che l'agente lo chiama, e i ruoli MCP di quell'utente decidono a quali cartelle e strumenti ha accesso.
Passaggio 5 — Fai una domanda
Avvia una nuova chat e fai domande sul contenuto dei tuoi file. Microsoft Copilot cerca prima nell'indice, apre le pagine corrispondenti e risponde con il nome del file, la pagina e la data del file, così puoi verificare la fonte.
Cosa può fare Microsoft Copilot con i file
| Tool | Cosa fa |
|---|---|
<prefix>_guide | Come cercare in questa cartella |
<prefix>_search | Ricerca full-text su ogni pagina indicizzata: i file con la pagina migliore, un'anteprima e la data; filtri per cartella, tipo di file e date, i più recenti per primi su richiesta |
<prefix>_find | Trova file per nome (tollerante agli errori di battitura) o per pattern |
<prefix>_list | Mostra una cartella: sottocartelle con conteggi, file con dimensione e data |
<prefix>_read | Legge un file come testo, per pagine ("1-3,7") o in finestre di caratteri |
<prefix>_grep | Ricerca esatta di codici e numeri con due righe di contesto; le righe dei fogli di calcolo arrivano con i nomi delle colonne |
<prefix>_status | Stato della sincronizzazione, conteggi, motivo della pausa e riepilogo del contenuto |
<prefix>_view_page | Mostra come immagine una pagina di un PDF, o un file immagine: disegni, timbri, foto e tabelle che il testo non cattura |
<prefix>_get_file | Il file stesso come link di download temporaneo per i membri del workspace (anche le immagini vengono allegate) |
<prefix>_share_file | Un link temporaneo (interno o pubblico); disattivato all'installazione |
<prefix> è il prefisso degli strumenti che scegli nella procedura guidata, per esempio pricelists. Ogni strumento tranne _share_file si limita a leggere.
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 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 nel piano Enterprise.
Prompt da provare in Microsoft Copilot
- "Trova il listino attuale di Nordtor e dimmi il prezzo di NT-601 875 x 2000."
- "Quali documenti nella condivisione menzionano un preavviso di tre mesi?"
- "Cerca nella cartella Purchasing il numero di articolo 4711-200 e mostra ogni riga in cui compare."
- "Cosa dice la nostra procedura interna sui resi di oltre 30 giorni? Cita il paragrafo e il file."
Come funziona la sincronizzazione
AnythingMCP confronta la dimensione e la data di modifica di ogni file con l'ultima esecuzione e legge solo i file nuovi e modificati. I file con contenuto identico alla versione indicizzata vengono riconosciuti tramite il loro checksum (SHA-256) e non vengono rielaborati. I file eliminati escono dall'indice. Un file che non può essere letto viene ritentato alle 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 Microsoft Copilot: 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, Microsoft Copilot 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 alcuno strumento che scriva, rinomini o elimini sulla condivisione.
- Solo il tuo workspace. L'indice è archiviato per workspace e ogni query è limitata ad esso, dall'applicazione e, di nuovo, dal database (Row-Level Security).
- L'extractor di testo gira su una rete interna senza alcuna via d'uscita, senza database e senza segreti.
- Chi vede cosa segue i tuoi ruoli MCP: un ruolo senza gli strumenti per i file non li vede. Con Enterprise puoi anche consentire o negare cartelle per ruolo.
- Il contenuto dei file è dato. Gli strumenti dicono al modello di non seguire mai le istruzioni trovate all'interno di un file.
- I file restano nella tua rete. Solo ciò che uno strumento restituisce in risposta a una domanda (un elenco di risultati, il testo di una pagina) viaggia verso il provider AI che usi.
- Sola lettura due volte. Monta la condivisione in sola lettura sull'host e collegala in sola lettura ai container.
Limiti per piano
| Prova di 30 giorni | Starter | Team | Enterprise | |
|---|---|---|---|---|
| Connettori File Search | 3 | 1 | 3 | illimitati |
| File indicizzati, tutti i connettori insieme | 2.000 | 500 | 2.000 | illimitati |
| Sincronizzazione automatica | giornaliera | giornaliera | giornaliera | fino a ogni 5 minuti |
| Sincronizzazioni manuali al giorno | 3 | 1 | 3 | illimitate |
| OCR, permessi sulle cartelle per ruolo, policy del workspace | – | – | – | ✓ |
Il file più grande è impostato da FILES_MAX_FILE_BYTES (100 MB per impostazione predefinita). File Search richiede una licenza a pagamento (Starter, Team o Enterprise) o la prova di 30 giorni; l'edizione Community gratuita non include File Search dopo la prova. Tutti i piani.
FAQ
Perché non SharePoint? Se i file sono già su SharePoint o OneDrive, Microsoft 365 Copilot li cerca in modo nativo. Questa guida è per i file che non ci sono: un file server Windows, un NAS o un'altra condivisione di rete nel tuo ufficio.
Perché non è disponibile su AnythingMCP Cloud? Il Cloud raggiunge i file tramite internet, e SMB (porta 445) non deve stare su internet. Per il Cloud usa SFTP o WebDAV sul NAS, oppure esegui AnythingMCP self-hosted accanto alla condivisione.
Serve il piano Enterprise self-hosted? No. Starter include un connettore File Search con fino a 500 file, Team tre con 2.000. Enterprise elimina i limiti e aggiunge OCR, permessi sulle cartelle per ruolo e policy del workspace.
AnythingMCP copia tutta la condivisione? 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 una 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 i file da una chat AI come link di download
- Come collegare una cartella di rete o un file server Windows a Claude
- Come collegare una cartella di rete o un file server Windows a ChatGPT
- Come collegare una cartella di rete o un file server Windows a Gemini
- Come collegare una cartella di rete o un file server Windows a Cursor
- Come collegare una cartella di rete o un file server Windows a Muse
- Altre fonti di file in Microsoft Copilot: server SFTP, server FTP / FTPS, server WebDAV, bucket S3, Nextcloud, ownCloud, NAS Synology, NAS QNAP, storage Fritz!Box, Hetzner Storage Box
Questa guida ti è stata utile?