Guida al connettore12 minuti di lettura10 tool MCP7 lingue

Come collegare una cartella di rete o un file server Windows a Microsoft Copilot

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.

HCA cura del team HelpCodeAggiornato 12 min di lettura Open source su GitHub

Open source · AGPL-3.0 · gira sul tuo server

Network folder (File Search)

Network folder (File Search)

Search inside a Windows file server, NAS or network share mounted into a self-hosted AnythingMCP: full-text index of PDF, Excel, Word and Outlook files, synced in the background. Self-hosted only.

tool

10

Regione

INTL

Categoria

Archiviazione file

Autenticazione

Local server

Self-host con Docker

Open source · AGPL-3.0 · gira sul tuo server

  • Prova gratuita di 7 giorni
    Nessuna carta di credito
  • GDPR & SOC 2 ready
    Dati in UE, log di audit
  • Open source su GitHub
    Open source · AGPL-3.0
  • Funziona con ChatGPT, Claude, Gemini
    Qualsiasi client compatibile MCP

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.

Network folder (File Search) · live via MCP
Condividi
Opus 4.7

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 .env e docker-compose.yml.

Configurazione

  1. Monta la condivisione in sola lettura sull'host Docker, per esempio in /mnt/knowledge.
  2. Collegala in sola lettura (bind) ai container app e files-worker (vedi il commento in docker-compose.yml) e imposta FILE_SOURCE_ROOTS=/mnt/knowledge in .env. La procedura guidata propone solo cartelle al di sotto di quelle radici.
  3. Attiva i servizi di File Search: aggiungi a .env FILES_WORKER_URL=http://files-worker:8891, FILES_WORKER_TOKEN e FILE_EXTRACTOR_TOKEN (ciascuno con openssl rand -hex 24) e COMPOSE_PROFILES=files.
  4. 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.

In AnythingMCP apri Connectors → New → File Search e scegli Network folder (nel Marketplace: Network folder (File Search)).

  1. Cartella. Scegli la cartella sotto FILE_SOURCE_ROOTS, per esempio /mnt/knowledge/Purchasing.
  2. Test. AnythingMCP elenca la cartella prima di salvare qualsiasi cosa e mostra se è leggibile.
  3. 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.
  4. 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.
  5. 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 mostri YOUR_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.

  1. In Copilot Studio apri il tuo agente (o creane uno), vai su Tools e scegli Add a tool → New tool → Model Context Protocol.
  2. 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 URL https://anythingmcp.example.com/mcp/YOUR_SERVER_ID. Copilot Studio usa la descrizione per decidere quando chiamare il server.
  3. In autenticazione scegli API key, imposta Type su Header e il nome dell'header su X-API-Key, poi seleziona Create.
  4. 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.
  5. Provalo nel riquadro Test dell'agente: chiedi qualcosa che richieda i tool di ricerca file.
  6. 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

ToolCosa fa
<prefix>_guideCome cercare in questa cartella
<prefix>_searchRicerca 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>_findTrova file per nome (tollerante agli errori di battitura) o per pattern
<prefix>_listMostra una cartella: sottocartelle con conteggi, file con dimensione e data
<prefix>_readLegge un file come testo, per pagine ("1-3,7") o in finestre di caratteri
<prefix>_grepRicerca esatta di codici e numeri con due righe di contesto; le righe dei fogli di calcolo arrivano con i nomi delle colonne
<prefix>_statusStato della sincronizzazione, conteggi, motivo della pausa e riepilogo del contenuto
<prefix>_view_pageMostra come immagine una pagina di un PDF, o un file immagine: disegni, timbri, foto e tabelle che il testo non cattura
<prefix>_get_fileIl file stesso come link di download temporaneo per i membri del workspace (anche le immagini vengono allegate)
<prefix>_share_fileUn 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 giorniStarterTeamEnterprise
Connettori File Search313illimitati
File indicizzati, tutti i connettori insieme2.0005002.000illimitati
Sincronizzazione automaticagiornalieragiornalieragiornalierafino a ogni 5 minuti
Sincronizzazioni manuali al giorno313illimitate
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

Questa guida ti è stata utile?

Il tuo agente Network folder è a un clic di distanza.

Installa il connettore, incolla la chiave, chiedi a Microsoft Copilot. 7 giorni gratis, senza carta di credito.

Guide correlate

Enterprise

Permessi sulle cartelle per ruolo nella ricerca file con AI: chi vede quali cartelle in Claude e ChatGPT

Offri a vendite, acquisti e assistenza un'unica ricerca file con AI sulla condivisione aziendale e lascia che ogni ruolo veda solo le proprie cartelle. Come funzionano i permessi sulle cartelle di AnythingMCP Enterprise (allow, deny, deny vince), come pianificare le regole e l'alternativa senza Enterprise.

Connettori

Come collegare una cartella di rete o un file server Windows a ChatGPT

Permetti a ChatGPT di cercare in un file server Windows, NAS o condivisione di rete (SMB/CIFS o NFS) montati in un AnythingMCP self-hosted: indice full-text di file PDF, Excel, Word e Outlook, sincronizzato in background. Solo self-hosted.

Connettori

Come collegare una cartella di rete o un file server Windows a Claude

Permetti a Claude di cercare all'interno di un file server Windows, NAS o condivisione di rete (SMB/CIFS o NFS) montati in un AnythingMCP self-hosted: indice full-text di file PDF, Excel, Word e Outlook, sincronizzato in background. Solo self-hosted.

Connettori

Come collegare una cartella di rete o un file server Windows a Cursor

Permetti a Cursor 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.

Connettori

Come collegare una cartella di rete o un file server Windows a Gemini

Permetti a Gemini di cercare all'interno di un file server Windows, NAS o condivisione di rete (SMB/CIFS o NFS) montati in un AnythingMCP self-hosted: indice full-text di file PDF, Excel, Word e Outlook, sincronizzato in background. Solo self-hosted.

Connettori

Come collegare una cartella di rete o un file server Windows a Muse

Permetti a Muse di cercare all'interno di un file server Windows, NAS o condivisione di rete (SMB/CIFS o NFS) montati in un AnythingMCP self-hosted: indice full-text di file PDF, Excel, Word e Outlook, sincronizzato in background. Solo self-hosted.