Come collegare un NAS Synology a Cursor

Synology NAS in Cursor

In breve: attiva SFTP sul NAS, crea un utente che possa 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 Cursor. Cursor può trovare i file per nome e per contenuto, leggere le pagine che gli servono e fornirti il file stesso, come 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 a far sì che una domanda come "quanto costa l'articolo NT-601 nel listino attuale?" richieda pochi secondi.

Cosa ti serve

• SFTP attivo in DSM (Pannello di controllo → Servizi file → FTP → SFTP), oppure il pacchetto WebDAV Server se preferisci WebDAV.
• Un utente DSM con accesso in sola lettura alla cartella condivisa.
• Per AnythingMCP Cloud: il NAS raggiungibile da internet, con la porta SFTP 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.

AnythingMCP ha anche un connettore Synology DSM per lo stato di sistema e storage, le attività e l'albero del File Station. Non legge ciò che c'è dentro i tuoi documenti: lo fa File Search. SMB (porta 445) non è raggiungibile dal Cloud: non deve stare su internet.

Configurazione

Passo 1 — Configura il connettore File Search

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

1. Connetti. Inserisci l'indirizzo del NAS (dall'esterno: l'indirizzo che il tuo router inoltra), la porta, l'utente in sola lettura con la sua password e la cartella condivisa, per esempio /Documents.
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 di inviare la password, proteggendoti da un server che finge di essere 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ì Cursor non cita mai un documento obsoleto. Una barra confronta la tua selezione con il tuo piano mentre spunti cartelle, tipi di file o un limite di età; quando la selezione supera il piano, deseleziona altro o fai l'upgrade.
4. Descrivi. AnythingMCP prepara una bozza della descrizione del connettore a partire dalla scansione, per esempio "Cartella condivisa Documents dell'ufficio: offerte, fatture e contratti, PDF e Word, 2018–2026". Questo testo dice a Cursor cosa contiene la cartella e quando cercarvi. Se sul server è configurato un modello AI, la procedura può generare la bozza con l'AI e indica esattamente cosa viene inviato (nomi di cartelle, nomi di file, i primi 2.000 caratteri di fino a 20 file di esempio, dati personali mascherati); altrimenti la bozza viene creata dalla struttura delle cartelle. Modificala come preferisci.
5. Attiva. 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: Cursor 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 Cursor

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.

Cursor legge i server MCP da ~/.cursor/mcp.json. Aggiungi questa voce:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Crea una chiave API MCP in AnythingMCP in MCP Servers → il tuo server → API keys e incollala al posto di YOUR_MCP_API_KEY.
2. Salva il file e riavvia Cursor.
3. Apri Cursor → Settings → MCP e verifica che anythingmcp sia elencato e connesso.
4. Inizia a chattare: l'agente ora può richiamare i tool di ricerca file.

Passo 4 — Chiedi

Avvia una nuova chat e fai domande sul contenuto dei tuoi file. Cursor cerca prima nell'indice, apre le pagine che corrispondono e risponde indicando il nome del file, la pagina e la data del file, così puoi verificare la fonte.

Cosa può fare Cursor con i file

<prefix> è il prefisso degli strumenti 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 modello e .xlsb; OpenDocument; Outlook .msg, .eml e .mbox con il testo dei loro allegati; .rtf, .epub, .xps; Apple Pages, Numbers e Keynote (tramite la loro 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 Cursor

• "Cerca nella cartella condivisa il contratto Kessler e dimmi qual è il termine di preavviso."
• "Quali fatture di Nordtor ci sono nella cartella per il 2025?"
• "Trova il documento di trasporto dell'ordine 4711-200 e dimmi cosa è stato consegnato."
• "Dammi l'ultimo listino della cartella Acquisti come link di download."

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 tramite il 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 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 Cursor: una prima sincronizzazione grande 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, Cursor continua a cercare nei file già indicizzati e viene avvisato che i file più recenti potrebbero mancare, e tu puoi deselezionare cartelle o fare l'upgrade. 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 è archiviato per workspace e ogni query è limitata ad esso, dall'applicazione e di nuovo dal database (Row-Level Security).
• Le credenziali sono archiviate cifrate e decifrate solo nel servizio di sincronizzazione in background. Cursor 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 in sola lettura. Dai all'utente DSM accesso in lettura a quell'unica cartella condivisa e a nient'altro.
• Host key fissata. La host key SSH del NAS viene verificata a ogni connessione.
• Inoltro delle porte. Inoltra solo la porta SFTP, e solo se usi AnythingMCP Cloud; limitalo all'indirizzo in uscita del Cloud dove il tuo router lo consente.
• AnythingMCP Cloud si connette solo a server su internet pubblico: un host in una rete privata viene rifiutato, anche dopo un redirect. 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

Cursor supporta server MCP personalizzati nel piano gratuito? Sì, MCP è disponibile nei piani Hobby, Pro e Business.

SFTP o WebDAV su Synology? Va bene entrambi. SFTP si attiva in Pannello di controllo → Servizi file → FTP → SFTP; WebDAV richiede il pacchetto WebDAV Server. La voce del Marketplace apre la procedura guidata con SFTP.

Devo aprire il NAS a internet? Per AnythingMCP Cloud sì: inoltra la porta SFTP. Un AnythingMCP self-hosted nella stessa rete raggiunge il NAS senza inoltro delle porte.

Qual è la differenza rispetto al connettore Synology DSM? Il connettore Synology DSM legge lo stato del NAS. Il connettore File Search cerca nel contenuto dei tuoi documenti.

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, 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 Nextcloud e WebDAV con l'AI
• Condividi file da una chat AI come link di download
• Collega un NAS Synology a Claude
• Collega un NAS Synology a ChatGPT
• Collega un NAS Synology a Gemini
• Collega un NAS Synology a Microsoft Copilot
• Collega un NAS Synology a Muse
• Altre fonti di file in Cursor: server SFTP, server FTP / FTPS, server WebDAV, bucket S3, Nextcloud, ownCloud, NAS QNAP, storage Fritz!Box, Hetzner Storage Box, Cartella di rete (self-hosted)