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

Cartelle di rete in Muse

Solo self-hosted. La cartella di rete esiste solo in un AnythingMCP self-hosted. Su AnythingMCP Cloud, raggiungi un NAS tramite 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 Meta Muse. Muse 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. Sulla condivisione non viene mai scritto nulla.

Un assistente AI non può aprire da solo un'unità di rete, e uno che potesse 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 licenza a pagamento o con la prova di 30 giorni. AnythingMCP Cloud non può raggiungere una condivisione di rete: SMB (porta 445) non deve essere esposto su internet.
• La condivisione montata in sola lettura sull'host Docker, ad 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

Passaggio 1 — Monta la condivisione e attiva File Search

1. Monta la condivisione in sola lettura sull'host Docker, ad 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 sotto queste radici.
3. Attiva i servizi 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.

Passaggio 2 — Configura il connettore File Search

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, ad esempio /mnt/knowledge/Purchasing.
2. Test. AnythingMCP elenca la cartella prima di salvare qualsiasi cosa e mostra se è leggibile.
3. Scansione. 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ì Muse 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. Descrizione. AnythingMCP prepara una bozza della descrizione del connettore a partire dalla scansione, ad esempio "Condivisione Acquisti: listini e condizioni dei fornitori, PDF ed Excel, tedesco, 2019–2026". Questo testo dice a Muse 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 costruita 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, poi clicca su Activate.

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

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 riporti YOUR_SERVER_ID.

Muse si collega ai server MCP dal cloud di Meta, 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 in questo passaggio compaia https://anythingmcp.example.com; i file restano sul tuo server.

Muse aggiunge i server MCP remoti come connettori personalizzati e vi accede tramite OAuth.

1. In Muse, apri Settings → Connectors e scegli Add custom connector.
2. Incolla l'URL del server MCP https://anythingmcp.example.com/mcp/YOUR_SERVER_ID.
3. Muse apre la pagina di accesso di AnythingMCP: accedi e approva l'accesso.
4. In una chat, chiedi a Muse qualcosa che richieda gli strumenti di ricerca file.

Puoi anche configurarlo da una chat, sul web, nelle app iOS e Android o in WhatsApp. Invia a Muse questo messaggio:

Create a Custom Connector for a new remote MCP server, then connect to it:
Name: AnythingMCP
Transport: remote streamable HTTP
URL: https://anythingmcp.example.com/mcp/YOUR_SERVER_ID
Auth: OAuth

Passaggio 5 — Chiedi

Avvia una nuova chat e fai domande sul contenuto dei tuoi file. Muse 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 Muse con i file

<prefix> è il prefisso degli strumenti che scegli nella procedura guidata, ad esempio pricelists. Ogni strumento 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 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 in Enterprise.

Prompt da provare in Muse

• "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 articolo 4711-200 e mostra ogni riga in cui compare."
• "Cosa dice la nostra procedura interna sui resi più vecchi di 30 giorni? Cita il paragrafo e il file."

Come funziona la sincronizzazione

AnythingMCP confronta dimensione e data di modifica di ogni file con l'ultima esecuzione e legge solo i file nuovi e modificati. I file il cui contenuto è identico alla versione indicizzata vengono riconosciuti tramite 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 viene eseguita in un proprio servizio in background, separato dal server che risponde a Muse: una prima sincronizzazione ampia 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, Muse 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 alcuno strumento che scriva, rinomini o elimini sulla condivisione.
• Solo il tuo workspace. L'indice è memorizzato per workspace e ogni query è limitata ad esso, dall'applicazione e ancora dal database (Row-Level Security).
• L'estrattore 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. In 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 per una domanda (un elenco di corrispondenze, il testo di una pagina) viene inviato al 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

Il file più grande è determinato 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

Dove è disponibile Muse? Meta offre attualmente Muse negli Stati Uniti e in Canada, sul web, nelle app iOS e Android e in WhatsApp.

Meta verifica questo connettore? No. Meta non verifica i connettori personalizzati. Muse vede solo gli strumenti che hai attivato per questo server MCP in AnythingMCP, e puoi scollegarlo in qualsiasi momento da Settings → Connectors.

Perché non è disponibile su AnythingMCP Cloud? Il Cloud raggiunge i file tramite internet, e SMB (porta 445) non deve essere esposto su internet. Usa SFTP o WebDAV sul NAS per il Cloud, 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 per cartella 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 qui 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 una cartella di rete o un file server Windows a Claude
• Collega una cartella di rete o un file server Windows a ChatGPT
• Collega una cartella di rete o un file server Windows a Gemini
• Collega una cartella di rete o un file server Windows a Microsoft Copilot
• Collega una cartella di rete o un file server Windows a Cursor
• Altre origini di file in Muse: server SFTP, server FTP / FTPS, server WebDAV, bucket S3, Nextcloud, ownCloud, Synology NAS, QNAP NAS, archiviazione Fritz!Box, Hetzner Storage Box