Come collegare un server SFTP a Muse

SFTP in Muse

Risposta breve: aggiungi il server SFTP ad AnythingMCP come connettore File Search. AnythingMCP accede via SSH con una password o una chiave privata, indicizza il testo completo della cartella che scegli e mantiene l'indice sincronizzato. 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, come allegato o come link di download temporaneo. Sul server non viene mai scritto nulla.

Un assistente IA non può aprire da solo un server SFTP, e uno che potesse farlo 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 account SSH sul server che possa leggere la cartella, idealmente uno che non possa fare altro. Vanno bene sia una password sia una chiave privata.
• Il nome host e la porta SSH, di solito 22.
• Un workspace AnythingMCP: AnythingMCP Cloud (7 giorni gratis) oppure la tua installazione self-hosted.

SFTP è il protocollo di trasferimento file di SSH, non FTP su TLS. Se il tuo server usa FTP o FTPS, segui la guida FTP / FTPS. Hetzner Storage Box, Synology NAS e QNAP NAS hanno voci dedicate nel Marketplace con le impostazioni corrette.

Configurazione

Passaggio 1 — Configura il connettore File Search

In AnythingMCP apri il Marketplace e scegli SFTP (File Search), oppure apri Connectors → New → File Search e scegli SFTP. Una breve procedura guidata ti accompagna; non c'è nessun modulo lungo da compilare.

1. Connetti. Inserisci host, porta, nome utente e la password oppure la chiave privata, più la cartella da usare, ad esempio /srv/documents.
2. Testa. Prima di salvare qualsiasi cosa, AnythingMCP si connette, effettua l'accesso ed elenca la cartella, e mostra una checklist (indirizzo, raggiungibilità, cifratura, identità del server, login, cartella) con cosa correggere quando un passaggio fallisce. Mostra anche la chiave host SSH del server come fingerprint: confermala una volta sola e da quel momento AnythingMCP rifiuta una chiave diversa prima che la password venga inviata, 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ì Muse 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; 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, ad esempio "Documenti di progetto del team di ingegneria, PDF, Word ed Excel, 2021–2026". Questo testo indica a Muse cosa contiene la cartella e quando cercarvi. Se sul server è configurato un modello IA, la procedura guidata può generare la bozza con l'IA e dice 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 a partire 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 e viene eseguita in un servizio separato in background: Muse e gli altri tuoi 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 2 — Copia l'URL del server

In MCP Servers apri il server che hai scelto nella procedura guidata e copia il suo URL.

Passaggio 3 — 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://cloud.anythingmcp.com/mcp/…). Usalo ovunque in questa guida compaia YOUR_SERVER_ID.

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

1. In Muse apri Settings → Connectors e scegli Add custom connector.
2. Incolla l'URL del server MCP https://cloud.anythingmcp.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 i tool di ricerca nei 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://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID
Auth: OAuth

Usi il self-hosting? Usa l'indirizzo HTTPS pubblico della tua istanza al posto di https://cloud.anythingmcp.com. Muse si connette dal cloud di Meta, quindi localhost non funziona.

Passaggio 4 — Chiedi

Avvia una nuova chat e fai domande sul contenuto dei tuoi file. Muse cerca prima nell'indice, apre le pagine che corrispondono e risponde con 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 tool 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 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'IA come immagini. I PDF scansionati senza livello di testo vengono letti con OCR in Enterprise.

Prompt da provare in Muse

• "Cerca nella cartella di progetto la specifica della serie di pompe K-300 e riassumi i limiti operativi."
• "Quali documenti menzionano il contratto di manutenzione Kessler e quando sono stati modificati l'ultima volta?"
• "Trova ogni riga Excel con il numero articolo NT-601 ed elenca il file e il foglio per ciascuna."
• "Dammi la versione più recente della checklist di messa in servizio come link di download."

Come funziona la sincronizzazione

AnythingMCP confronta la dimensione e la data di modifica di ogni file con l'ultima esecuzione e scarica solo i file nuovi e modificati. 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 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 la 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 alcun tool che scriva, rinomini o elimini sul server.
• 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. Muse 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. In 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.
• Chiave host bloccata. La chiave host SSH che hai confermato viene verificata a ogni connessione; una chiave diversa viene rifiutata prima che la password o la chiave vengano usate.
• Accesso con chiave. Con una chiave privata non è necessario che esista alcuna password per l'account.
• 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 in self-hosting 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 in self-hosting richiede una licenza a pagamento o la prova di 30 giorni, che ha i limiti del piano Team; l'edizione Community gratuita non ha 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 i tool che hai attivato per questo server MCP in AnythingMCP, e puoi scollegarlo in qualsiasi momento in Settings → Connectors.

La procedura guidata dice che il server ha presentato una chiave host diversa. Il server è stato reinstallato, oppure qualcuno si è messo nel mezzo. Verifica con l'amministratore del server prima di confermare il nuovo fingerprint (pannello Files → Edit selection → di nuovo su Test).

Password o chiave privata? Funzionano entrambe. Una chiave privata per un account che può solo leggere la cartella è la configurazione più pulita.

AnythingMCP copia tutto il server? 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, dove 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'IA
• Trova i prezzi nei listini dei fornitori con l'IA
• Cerca nei file Nextcloud e WebDAV con l'IA
• Condividi file da una chat IA come link di download
• Collega un server SFTP a Claude
• Collega un server SFTP a ChatGPT
• Collega un server SFTP a Gemini
• Collega un server SFTP a Microsoft Copilot
• Collega un server SFTP a Cursor
• Altre fonti di file in Muse: server FTP / FTPS, server WebDAV, bucket S3, Nextcloud, ownCloud, Synology NAS, QNAP NAS, archiviazione Fritz!Box, Hetzner Storage Box, Cartella di rete (self-hosted)