Yandex Disk über MCP mit Meta Muse verbinden

💡 Keine Installation? Nutze cloud.anythingmcp.com direkt. Einloggen, Connectors → Yandex Disk klicken, Zugangsdaten einfügen, MCP-API-Key erzeugen, fertig. Kein Docker, kein git clone, kein lokaler Server.

Yandex Disk + Meta Muse

Lass deine KI in Yandex Disk arbeiten: Ordner durchsuchen, alle Dateien oder die neuesten Uploads auflisten, Dateidetails lesen, Download-Links holen, Ordner anlegen, Dateien kopieren, verschieben, veröffentlichen oder die Freigabe aufheben, eine Datei aus einer URL speichern und aus dem Papierkorb wiederherstellen. Angemeldet mit deinem Yandex-Konto.

Voraussetzungen

Die vollständige Setup-Anleitung ist in den Connector eingebaut (im Store sichtbar, wenn du den Connector auswählst). Benötigte Umgebungsvariablen für diesen Connector:

YANDEX_DISK_CLIENT_ID, YANDEX_DISK_CLIENT_SECRET

Schritt 1 — Zugangsdaten holen

Die Einrichtung dauert etwa 5 Minuten. Du brauchst das Yandex-Konto, mit dessen Disk die KI arbeiten soll, und eine dafür registrierte App bei Yandex OAuth.

1. Melde dich mit diesem Yandex-Konto an, öffne oauth.yandex.ru/client/new (oder oauth.yandex.com) und lege eine App an.
2. Wähle als Plattform Web services. Trage als Redirect URI https://cloud.anythingmcp.com/api/mcp-oauth/callback ein. Wenn du AnythingMCP selbst betreibst, trage stattdessen https://dein-anythingmcp-host/api/mcp-oauth/callback ein.
3. Füge beim Datenzugriff die Berechtigungen der Yandex Disk REST API hinzu: cloud_api:disk.read (die ganze Disk lesen), cloud_api:disk.write (überall auf der Disk schreiben) und cloud_api:disk.info (Informationen zur Disk). Wähle nicht nur cloud_api:disk.app_folder: Damit bleibt die App auf ihren eigenen Ordner beschränkt.
4. Lege die App an, kopiere die ClientID in YANDEX_DISK_CLIENT_ID und das Client secret in YANDEX_DISK_CLIENT_SECRET und installiere den Connector.
5. Klicke auf der Connector-Seite auf Authorize with Provider, wähle das Yandex-Konto und erlaube den Zugriff.
6. Beginne mit yandex_disk_get_disk_info: Das Tool zeigt, an wessen Disk der Connector angemeldet ist, wie viel Speicher belegt ist und wie groß der Papierkorb ist.

Berechtigungen und Nur-Lesen: Yandex vergibt genau die Berechtigungen, die du in Schritt 3 in der App angehakt hast. Für ein reines Lese-Setup registrierst du die App nur mit cloud_api:disk.read und cloud_api:disk.info und schaltest yandex_disk_create_folder, yandex_disk_copy, yandex_disk_move, yandex_disk_publish, yandex_disk_unpublish, yandex_disk_upload_from_url und yandex_disk_restore_from_trash aus.

Anmeldung: Ein Yandex-Token gilt etwa ein Jahr und kommt mit einem Refresh-Token, mit dem AnythingMCP es erneuert. Beide werden verschlüsselt gespeichert. Wenn du die App unter id.yandex.ru/security widerrufst oder ihre Berechtigungen änderst, klicke erneut auf Authorize with Provider.

Pfade: Dateien und Ordner werden als disk:/ordner/datei.txt angesprochen, die oberste Ebene ist disk:/, Einträge im Papierkorb sind trash:/.... Du kannst einfach einen Ordner oder eine Datei nennen; die KI verwendet die genauen Namen samt Dateiendung.

Änderungen erst nach deinem Ja: Ordner anlegen, kopieren, verschieben oder umbenennen, veröffentlichen und Freigaben aufheben, eine Datei aus einer URL speichern und aus dem Papierkorb wiederherstellen verändern deine Disk. Die KI sagt, was passieren wird, und wartet auf deine Bestätigung; eine vorhandene Datei überschreibt sie nur, wenn du zustimmst. yandex_disk_publish macht eine Datei oder einen Ordner für jeden mit dem Link lesbar; yandex_disk_unpublish beendet den Link, und erneutes Veröffentlichen erzeugt einen neuen.

Bei der Installation ausgeschaltet: yandex_disk_delete. Schaltet ein Administrator das Tool ein, verschiebt es Elemente in den Papierkorb, aus dem yandex_disk_restore_from_trash sie zurückholt. Endgültig gelöscht wird nur, wenn du das ausdrücklich verlangst.

Keine Suche: Die Yandex-Disk-API kann weder nach Namen noch nach Inhalten suchen. Um eine Datei zu finden, listet die KI den Ordner mit yandex_disk_list_folder auf, blättert mit yandex_disk_list_files durch alle Dateien (auf Wunsch nur Bilder, Dokumente und so weiter) und vergleicht die Namen, oder sie prüft die neuesten Uploads mit yandex_disk_list_last_uploaded.

Dateiinhalte: Der Connector liest und lädt keine Dateiinhalte hoch. yandex_disk_get_download_link liefert einen befristeten Link, den du öffnen kannst (ein Ordner wird als ZIP geladen), und yandex_disk_upload_from_url speichert eine Datei, die schon im Internet liegt. yandex_disk_get_public_resource liest jeden öffentlichen Yandex-Disk-Link, deinen eigenen oder den von anderen.

Hintergrundvorgänge: Kopieren, Verschieben, Wiederherstellen oder Löschen großer Ordner und jeder Upload aus einer URL laufen bei Yandex im Hintergrund. Die KI prüft den Fortschritt mit yandex_disk_get_operation_status, bis der Vorgang abgeschlossen ist.

Häufige Fehler: 401 UnauthorizedError heißt, dass die Anmeldung fehlt, widerrufen wurde oder abgelaufen ist; autorisiere erneut. 403: Der App fehlt eine Berechtigung aus Schritt 3 (zum Beispiel cloud_api:disk.write für eine Änderung), die Disk hat ihr Kontingent überschritten oder ist im Nur-Lese-Modus. 404: Der Pfad existiert nicht; prüfe Schreibweise, Dateiendung und das Präfix disk:/. 409: Das Ziel existiert schon oder sein übergeordneter Ordner fehlt. 423: Das Element ist durch einen anderen Vorgang gesperrt oder Uploads sind pausiert; versuche es später erneut. 507: nicht genug freier Speicher auf der Disk. 429: zu viele Anfragen; warte kurz und versuche es erneut.

Der Connector liest und lädt keine Dateiinhalte hoch, bearbeitet keine benutzerdefinierten Eigenschaften, leert nicht den Papierkorb, teilt keine Ordner mit bestimmten Personen und ändert keine Yandex-360-Administratoreinstellungen.

Schritt 2 — Adapter installieren

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

Schritt 3 — Connector in Muse hinzufügen

Deine Server-URL: Öffne in AnythingMCP MCP Servers → den Server, auf dem dieser Connector liegt, und kopiere seine URL (https://cloud.anythingmcp.com/mcp/…). Setze sie überall ein, wo diese Anleitung YOUR_SERVER_ID zeigt.

Muse bindet Remote-MCP-Server als Custom Connectors ein und meldet sich per OAuth bei ihnen an.

1. Öffne in Muse Settings → Connectors und wähle Add custom connector.
2. Füge die MCP-Server-URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID ein.
3. Muse öffnet die Anmeldeseite von AnythingMCP: Melde dich an und bestätige den Zugriff.
4. Bitte Muse im Chat um etwas, wofür es die Yandex Disk-Tools braucht.

Du kannst den Connector auch per Chat einrichten, im Web, in den Apps für iOS und Android oder in WhatsApp. Schick Muse diese Nachricht:

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

Du hostest selbst? Nimm statt https://cloud.anythingmcp.com die öffentliche HTTPS-Adresse deiner Instanz. Muse verbindet sich aus der Cloud von Meta, localhost funktioniert deshalb nicht.

Verfügbare Tools

Beispiel-Prompts

• „Wie viel Speicher ist auf meiner Yandex Disk noch frei, und wie groß ist der Papierkorb?“
• „Welche Fotos habe ich letzte Woche hochgeladen, und in welchen Ordnern liegen sie?“
• „Leg auf meiner Disk den Ordner Kunden/Acme an und verschieb das PDF mit dem Acme-Vertrag aus Downloads dorthin.“
• „Erstelle einen öffentlichen Link für Präsentationen/Pitch.pdf und gib ihn mir, dann liste alles andere auf, was ich öffentlich geteilt habe.“

FAQ

Wo ist Muse verfügbar? Meta bietet Muse derzeit in den USA und in Kanada an, im Web, in den Apps für iOS und Android und in WhatsApp.

Prüft Meta diesen Connector? Nein. Meta prüft Custom Connectors nicht. Muse sieht nur die Tools, die du in AnythingMCP für diesen MCP-Server eingeschaltet hast, und du kannst den Connector jederzeit unter Settings → Connectors trennen.

Nächste Schritte

• Connector-Startseite
• Mit Claude verbinden
• Mit ChatGPT verbinden