Provare un’operazione MCP dosya di sola lettura

Esegui list_workspaces e list_folder sullo spazio di lavoro vincolato, esamina i campi di paginazione strutturati e verifica che i contenuti non cambino.

Ultima revisione

Gli screenshot mostrano l’interfaccia in inglese.

Usa una chiamata di elenco per la prima prova MCP. Dimostra autenticazione, confinamento allo spazio di lavoro, output strutturato e sola lettura senza scaricare byte dei file o consumare la quota giornaliera di lettura dei contenuti.

Quattro pannelli mostrano list_workspaces, elenco della radice dello spazio scelto, campi di paginazione e verifica che i file restino invariati.
Quattro pannelli mostrano list_workspaces, elenco della radice dello spazio scelto, campi di paginazione e verifica che i file restino invariati. Apri lo screenshot a dimensione intera.

Passaggi

  1. Nel client MCP collegato chiama list_workspaces senza argomenti. Annota workspace_id restituito; un’autorizzazione valida elenca solo lo spazio scelto nel consenso OAuth.
  2. Chiama list_folder con quel workspace_id e ometti folder_id per richiedere la radice accessibile. Per un membro confinato a una cartella è l’ancoraggio consentito, non l’intera radice dello spazio di lavoro. Ometti anche i valori di paginazione per pagina 1 e 25 voci predefinite.
  3. Esamina structuredContent.entries. Le righe di cartelle e file includono kind, id, name, folder_id e un URL dell’app; i file riportano anche dimensione in byte, tipo MIME e ora di modifica quando disponibili.
  4. Leggi page e next_page. Se next_page è un numero, chiama lo stesso strumento con quella pagina; fermati quando è null. Un client può richiedere da 1 a 100 voci per pagina.
  5. Apri dosya separatamente con lo stesso account e confronta i nomi restituiti con la radice accessibile nello spazio scelto. Per un membro confinato confronta l’ancoraggio consentito. Contenuti nascosti ed eliminati sono esclusi e la connessione non deve rivelare altri spazi o uno Space crittografato da un capo all’altro.
  6. Aggiorna l’elenco web e verifica che nessun file, cartella, condivisione o versione sia cambiato. Il server MCP non espone strumenti di modifica e ogni operazione registrata si dichiara di sola lettura e non distruttiva.

list_folder usa capacità di richieste API ma non conta come lettura di contenuto. Se provi poi read_file, i valori predefiniti attuali sono una finestra di 100.000 caratteri, limite di conversione di 25 MiB e termine di 45 secondi. Il piano gratuito prevede 100 letture di file e 25 conversioni di immagini per giorno UTC; i valori predefiniti a pagamento sono illimitati.

Riferimento per la prova MCP in sola lettura: panoramica API REST dosya con link Get API Key e View SDKs.
Riferimento per la prova MCP in sola lettura: panoramica API REST dosya con link Get API Key e View SDKs. Apri lo screenshot a dimensione intera.

Risultato previsto

list_workspaces restituisce lo spazio vincolato e list_folder un’istantanea strutturata e paginata della radice accessibile al membro, incluso l’ancoraggio consentito per chi è confinato a una cartella. Un controllo in dosya mostra che l’operazione non ha creato, modificato, condiviso o eliminato nulla.

Il risultato indica Not visible to this connection. Verifica che l’identificativo appartenga allo spazio scelto nel consenso OAuth e che il membro autenticato abbia ancora accesso.

Il servizio risulta indisponibile. Riprova tra poco senza ricollegarti; errori temporanei del gateway producono intenzionalmente dosya could not be reached just now invece di invalidare la credenziale.

Guide correlate

Ti è stata utile?

Caricamento delle valutazioni…

Quando voti, salviamo un cookie tecnico per un massimo di 180 giorni, così puoi cambiare la tua risposta.

Domande e risposte

Fai una domanda sui passaggi di questa guida. Le domande vengono revisionate prima della pubblicazione.

Non inserire dati dell’account, credenziali o file privati nelle domande pubbliche. Usa l’assistenza privata in questi casi.

Caricamento delle domande…

    Accedi al tuo account dosya per fare una domanda.

    Controlla il risultato prima di riprovare

    Usa questi controlli quando devi verificare il risultato di un’attività.