Come collegare un NAS QNAP a Microsoft Copilot

NAS QNAP in Microsoft Copilot

In breve: abilita SFTP sul NAS, crea un utente che può solo leggere la cartella condivisa e aggiungi il NAS ad AnythingMCP come connettore File Search. AnythingMCP indicizza il testo completo di quella cartella e mantiene l'indice sincronizzato. 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 darti il file stesso, in allegato o come link di download temporaneo. Sul NAS non viene mai scritto nulla.

Un assistente AI non può aprire un NAS da solo, e uno che ci riuscisse dovrebbe scaricare ogni file per rispondere a una sola domanda. L'indice è ciò che permette a una domanda come "quanto costa l'articolo NT-601 nel listino attuale?" di ricevere risposta in pochi secondi.

Cosa ti serve

• SFTP abilitato (Pannello di controllo → Servizi di rete e file → Telnet/SSH → Consenti SFTP), oppure WebDAV attivo se preferisci WebDAV.
• Un utente QNAP con accesso di sola lettura alla cartella condivisa.
• Per AnythingMCP Cloud: il NAS raggiungibile da internet, con la porta inoltrata sul router. Un AnythingMCP self-hosted può raggiungerlo nella rete locale.
• Un workspace AnythingMCP: AnythingMCP Cloud (7 giorni gratis) oppure la tua installazione self-hosted.

Funziona con QTS e QuTS hero. SMB (porta 445) non viene raggiunto dal Cloud: non deve stare su internet. Usa SFTP o WebDAV, oppure un AnythingMCP self-hosted.

Configurazione

Passo 1 — Configura il connettore File Search

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

1. Connetti. Inserisci l'indirizzo del NAS (dall'esterno: l'indirizzo che il tuo router inoltra), la porta, l'utente di sola lettura con la sua password e la cartella condivisa.
2. Testa. AnythingMCP si connette, effettua 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 host key 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. 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. Una barra confronta la tua selezione con il tuo piano mentre selezioni cartelle, tipi di file o un limite di età; 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 "Cartella condivisa Engineering: elenchi disegni, schede tecniche e rapporti di collaudo, PDF ed Excel, 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ò generare la bozza con l'AI e indica con precisione cosa viene inviato (nomi delle cartelle, nomi dei file, i primi 2.000 caratteri di fino a 20 file di esempio, dati personali mascherati); altrimenti la bozza viene costruita dalla struttura delle cartelle. Modificala come preferisci.
5. Attiva. Scegli il prefisso dei tool, l'intervallo di sincronizzazione e i server MCP che ricevono il connettore, quindi fai clic su Activate.

La prima sincronizzazione parte subito e viene 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.

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 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://cloud.anythingmcp.com/mcp/…). Usalo ovunque questa guida mostri YOUR_SERVER_ID.

Microsoft Copilot usa i server MCP tramite agenti creati in Copilot Studio: aggiungi AnythingMCP a un agente come tool, poi pubblichi l'agente su Microsoft 365 Copilot e Teams. Copilot Studio si connette 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 NAS QNAP: schede tecniche, rapporti di collaudo, ordini") e il Server URL https://cloud.anythingmcp.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, quindi seleziona Create.
4. In Add tool, scegli Create a new connection, incolla una API key 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 nei file.
6. Seleziona Publish, poi Channels → Microsoft 365 and Microsoft Teams, lascia selezionata l'opzione 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 API key: ogni utente accede quindi ad AnythingMCP la prima volta che l'agente lo chiama, e i ruoli MCP di quell'utente decidono quali cartelle e strumenti ottiene.

Fai self-hosting? Usa l'indirizzo HTTPS pubblico della tua istanza al posto di https://cloud.anythingmcp.com. Copilot Studio si connette dal cloud di Microsoft, quindi localhost non funziona.

Passo 4 — Chiedi

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

<prefix> è il prefisso dei tool che scegli nella procedura guidata, per esempio pricelists. Ogni tool 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 modelli 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 su Enterprise.

Prompt da provare in Microsoft Copilot

• "Cerca nella cartella Engineering la scheda tecnica della serie di pompe K-300."
• "Quali rapporti di collaudo citano il modello di porta Nordtor NT-601?"
• "Trova ogni riga Excel con il numero articolo 4711-200."
• "Cosa c'è nel file più recente della cartella Orders?"

Come funziona la sincronizzazione

AnythingMCP confronta dimensione e data di modifica di ogni file con l'ultima esecuzione e scarica solo i file nuovi e modificati. Con WebDAV usa invece l'ETag. 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 alle sincronizzazioni successive e, dopo tre errori (subito per i file protetti da password), rimane 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 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, 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 alcun tool che scriva, rinomini o elimini sul NAS.
• Solo il tuo workspace. L'indice è memorizzato per workspace e ogni query è limitata a esso, dall'applicazione e di nuovo dal database (Row-Level Security).
• Le credenziali sono memorizzate cifrate e decifrate solo nel servizio di sincronizzazione in background. Microsoft Copilot 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 le istruzioni trovate all'interno di un file.
• Utente di sola lettura. Dai all'utente QNAP accesso in lettura a quell'unica cartella condivisa e a nient'altro.
• Host key fissata. La host key SSH del NAS viene controllata a ogni connessione.
• Port forwarding. Inoltra solo la porta che usi, e solo per AnythingMCP Cloud.
• 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 a 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

Perché non SharePoint? Se i file sono già in SharePoint o OneDrive, Microsoft 365 Copilot li cerca in modo nativo. Questa guida è per i file che non ci sono: documenti su un NAS QNAP nel tuo ufficio.

SFTP o WebDAV sul QNAP? Vanno bene entrambi. SFTP si abilita in Pannello di controllo → Servizi di rete e file → Telnet/SSH. La voce del Marketplace apre la procedura guidata con SFTP.

Devo aprire il NAS a internet? Per AnythingMCP Cloud, sì: inoltra la porta. Un AnythingMCP self-hosted nella stessa rete raggiunge il NAS senza port forwarding.

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