Yandex Disk su MCP: lavora su Yandex Disk da qualsiasi agente AI

💡 Niente installazione? Vai direttamente su cloud.anythingmcp.com. Accedi, clicca Connectors → Yandex Disk, inserisci le credenziali, genera una MCP API key e hai finito. Niente Docker, niente git clone, niente server locale.

Yandex Disk

Fai lavorare la tua AI su Yandex Disk: sfoglia le cartelle, elenca tutti i file o i caricamenti recenti, leggi i dettagli dei file, ottieni link di download, crea cartelle, copia, sposta, pubblica o rimuovi la pubblicazione dei file, salva un file da un URL e ripristina dal Cestino. Con l'accesso del tuo account Yandex.

Setup

La configurazione richiede circa 5 minuti. Ti servono l'account Yandex con il cui Disk deve lavorare l'AI e un'app registrata per quell'account su Yandex OAuth.

1. Accedi con quell'account Yandex, apri oauth.yandex.ru/client/new (oppure oauth.yandex.com) e crea un'app.
2. Come piattaforma scegli Web services. Come Redirect URI inserisci https://cloud.anythingmcp.com/api/mcp-oauth/callback. Se gestisci AnythingMCP in autonomia, inserisci invece https://tuo-host-anythingmcp/api/mcp-oauth/callback.
3. Nell'accesso ai dati aggiungi i permessi della Yandex Disk REST API cloud_api:disk.read (leggere tutto il Disk), cloud_api:disk.write (scrivere ovunque sul Disk) e cloud_api:disk.info (informazioni sul Disk). Non scegliere solo cloud_api:disk.app_folder: limiterebbe l'app alla sua cartella.
4. Crea l'app, copia il ClientID in YANDEX_DISK_CLIENT_ID e il Client secret in YANDEX_DISK_CLIENT_SECRET e installa il connettore.
5. Nella pagina del connettore clicca Authorize with Provider, scegli l'account Yandex e consenti l'accesso.
6. Inizia con yandex_disk_get_disk_info: mostra a quale Disk è collegato il connettore, quanto spazio è occupato e quanto è grande il Cestino.

Permessi e sola lettura: Yandex concede esattamente i permessi che hai selezionato nell'app al passo 3. Per una configurazione di sola lettura registra l'app solo con cloud_api:disk.read e cloud_api:disk.info e disattiva yandex_disk_create_folder, yandex_disk_copy, yandex_disk_move, yandex_disk_publish, yandex_disk_unpublish, yandex_disk_upload_from_url e yandex_disk_restore_from_trash.

Accesso: un token Yandex dura circa un anno e arriva con un refresh token, che AnythingMCP usa per rinnovarlo. Entrambi sono salvati cifrati. Se revochi l'app su id.yandex.ru/security o ne cambi i permessi, clicca di nuovo Authorize with Provider.

Percorsi: file e cartelle si indicano come disk:/cartella/file.txt, la radice è disk:/ e le voci del Cestino sono trash:/.... Puoi semplicemente nominare una cartella o un file; l'AI usa i nomi esatti, estensione compresa.

Le modifiche aspettano il tuo sì: creare cartelle, copiare, spostare o rinominare, pubblicare e togliere la pubblicazione, salvare un file da un URL e ripristinare dal Cestino cambiano il tuo Disk. L'AI dice cosa succederà e attende la tua conferma, e sovrascrive un file esistente solo se sei d'accordo. yandex_disk_publish rende un file o una cartella leggibile da chiunque abbia il link; yandex_disk_unpublish disattiva il link, e una nuova pubblicazione crea un link diverso.

Disattivato all'installazione: yandex_disk_delete. Quando un amministratore lo attiva, sposta gli elementi nel Cestino, da cui yandex_disk_restore_from_trash li recupera. Elimina definitivamente solo se lo chiedi in modo esplicito.

Nessuna ricerca: l'API di Yandex Disk non cerca per nome né per contenuto. Per trovare un file l'AI elenca la cartella con yandex_disk_list_folder, scorre tutti i file con yandex_disk_list_files (anche solo immagini, documenti e così via) e confronta i nomi, oppure guarda gli ultimi caricamenti con yandex_disk_list_last_uploaded.

Contenuto dei file: il connettore non legge né carica il contenuto dei file. yandex_disk_get_download_link restituisce un link temporaneo da aprire (una cartella si scarica come zip), e yandex_disk_upload_from_url salva un file che è già su internet. yandex_disk_get_public_resource legge qualsiasi link pubblico di Yandex Disk, tuo o di altri.

Operazioni in background: copia, spostamento, ripristino o eliminazione di cartelle grandi, e ogni caricamento da URL, vengono eseguiti da Yandex in background. L'AI controlla l'avanzamento con yandex_disk_get_operation_status finché l'operazione non è conclusa.

Errori comuni: 401 UnauthorizedError significa che l'accesso manca, è stato revocato o è scaduto; autorizza di nuovo. 403: all'app manca un permesso del passo 3 (per esempio cloud_api:disk.write per una modifica), il Disk ha superato la quota oppure è in sola lettura. 404: il percorso non esiste; controlla grafia, estensione e prefisso disk:/. 409: la destinazione esiste già oppure manca la cartella superiore. 423: l'elemento è bloccato da un'altra operazione o i caricamenti sono in pausa; riprova più tardi. 507: spazio libero insufficiente sul Disk. 429: troppe richieste; attendi e riprova.

Il connettore non legge né carica il contenuto dei file, non modifica proprietà personalizzate, non svuota il Cestino, non condivide cartelle con persone specifiche e non cambia le impostazioni di amministrazione di Yandex 360.

Prerequisiti: YANDEX_DISK_CLIENT_ID, YANDEX_DISK_CLIENT_SECRET

Installazione locale del connettore

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Apri http://localhost:3000/connectors/store, scegli Yandex Disk e inserisci le variabili elencate nei Prerequisiti.

Tool disponibili

Esempi di prompt

• "Quanto spazio resta sul mio Yandex Disk, e quanto è grande il Cestino?"
• "Quali foto ho caricato la settimana scorsa, e in quali cartelle si trovano?"
• "Crea sul mio Disk la cartella Clienti/Acme e spostaci il PDF del contratto Acme che sta in Downloads."
• "Crea un link pubblico per Presentazioni/Pitch.pdf e dammelo, poi elenca tutto il resto che ho condiviso pubblicamente."

Prossimi passi

• Collegare a Claude
• Collegare a ChatGPT