Collegare un’app IA a dosya

Un client IA si collega a dosya tramite OAuth all’indirizzo https://mcp.dosya.dev/mcp. L’approvazione concede accesso in lettura a uno spazio di lavoro; non fornisce all’app la tua password né una chiave API.

Prima di collegare l’app

• Inizia dal client che intendi usare e inserisci lì l’URL del server MCP dosya. Visitare l’indirizzo nel browser non equivale a una richiesta di collegamento.
• Accedi all’account dosya che appartiene allo spazio di lavoro desiderato. La procedura di consenso dura 10 minuti; se la richiesta scade, avviala di nuovo dal client IA.
• I token di accesso emessi durano 1 ora. Il rinnovo mantiene attivo il collegamento solo se usato almeno una volta ogni 30 giorni; ogni autorizzazione richiede comunque un nuovo collegamento entro un massimo assoluto di 180 giorni.
• Per la prima lettura usa un file non sensibile. Dopo che un’app esterna ha letto il contenuto, scollegarla non può eliminare le copie che conserva già.
• Uno spazio di lavoro ordinario può essere proposto se ne sei membro. Gli spazi con cifratura end-to-end sono esclusi perché il server non può leggerne i file. L’approvazione non richiede un piano a pagamento e non può aggirare l’appartenenza allo spazio di lavoro.
• Il catalogo sorgente assegna a ogni collegamento del piano gratuito 100 letture di file di testo e 25 conversioni di immagini al giorno UTC. Le impostazioni predefinite attuali dei piani a pagamento non limitano questi due contatori; un cambio di piano viene rilevato alla chiamata successiva.

Passaggi

1. In Claude, ChatGPT o un altro client MCP, aggiungi https://mcp.dosya.dev/mcp come server e avvia la procedura di collegamento.
2. Se richiesto, accedi a dosya. Se la pagina mostra Questo link non è valido, torna al client e ricomincia; non riutilizzare né modificare l’URL.
3. Controlla il contrassegno di identità. Claude e ChatGPT sono indicati come verificati solo se il codice di autorizzazione torna a un nome host riconosciuto di Claude o ChatGPT. Un altro client remoto mostra Non verificato · invia a host. Un callback loopback avverte: Stai concedendo l’accesso a un’app sul tuo computer.
4. In Spazio di lavoro accessibile in lettura, scegli lo spazio di lavoro desiderato. Se è idoneo un solo spazio, dosya lo seleziona automaticamente; se sono più di uno, Consenti resta disattivato finché non ne scegli uno. Se nessuno è idoneo, la pagina mostra Non hai uno spazio di lavoro leggibile da questa app. Gli spazi crittografati da un capo all’altro non possono essere collegati.
5. Controlla l’elenco degli ambiti. Ricerca e lettura dei file in “spazio di lavoro” è obbligatorio e non può essere deselezionato. Se il client ha richiesto account.read, Lettura del piano e dello spazio di archiviazione compare come permesso facoltativo selezionato, che puoi deselezionare.
6. Verifica le esclusioni indicate: l’autorizzazione non permette di modificare, condividere o eliminare nulla né di aprire altri spazi di lavoro o il tuo Vault.
7. Scegli Consenti a nome app. Per abbandonare la richiesta senza creare un’autorizzazione, seleziona invece Nega. dosya restituisce quindi il risultato dell’autorizzazione all’host di callback mostrato nella pagina.

Risultato previsto

Il client riprende dopo l’autorizzazione e può trovare e leggere file solo nello spazio di lavoro selezionato. Apri il menu dell’account, scegli Profilo, poi App IA collegate. La riga mostra il nome del client, lo spazio di lavoro, l’ora del collegamento e le etichette dei permessi, come Lettura dei file e, se concesso, Piano e spazio di archiviazione.

Prova a leggere un elemento non riservato. Un file di un altro spazio di lavoro, di uno spazio E2EE o del Vault deve restare inaccessibile; il connettore non ha permessi di scrittura, condivisione o eliminazione.

Se il collegamento non riesce

• Questa richiesta è scaduta. Torna all’app IA e collegala di nuovo. indica che la richiesta di consenso, valida per dieci minuti, è scaduta.
• Impossibile collegare l’app. Riprova. segnala un problema imprevisto del client o della rete. Se riprovare non riprende la stessa richiesta, ricomincia dal client.
• Il server ha restituito una destinazione inattesa indica che l’host restituito è diverso da quello mostrato prima dell’approvazione. Fermati e avvia un nuovo collegamento; non seguire manualmente un indirizzo sostitutivo.
• Un 401 durante la procedura ti porta alla pagina di accesso a dosya. L’approvazione deve comunque appartenere allo stesso utente che ha aperto la richiesta di consenso.
• Se non puoi controllare la riga, Impossibile caricare le app collegate. segnala un problema nel caricamento dell’elenco; non dimostra che non esista alcuna autorizzazione. Riprova tra poco.

Guide correlate

• Controllare i permessi delle app IA
• Scollegare un’app IA
• Reagire ad attività sospette