Yandex Disk MCP mit Microsoft Copilot 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 + Microsoft Copilot

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 Microsoft Copilot 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.

Microsoft Copilot nutzt MCP-Server über Agents, die du in Copilot Studio baust: Du fügst AnythingMCP einem Agent als Tool hinzu und veröffentlichst den Agent dann in Microsoft 365 Copilot und Teams. Copilot Studio verbindet sich aus der Cloud von Microsoft per Streamable HTTP, das AnythingMCP unterstützt.

1. Öffne in Copilot Studio deinen Agent (oder leg einen an), geh zu Tools und wähle Add a tool → New tool → Model Context Protocol.
2. Trag einen Server name ein (zum Beispiel AnythingMCP), eine Server description, die sagt, was der Connector kann, und die Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Anhand der Beschreibung entscheidet Copilot Studio, wann es den Server aufruft.
3. Wähle bei der Authentifizierung API key, setze Type auf Header und den Header-Namen auf X-API-Key und klicke auf Create.
4. Wähle in Add tool die Option Create a new connection, füge einen MCP-API-Key aus AnythingMCP ein (MCP Servers → dein Server → API keys) und klicke auf Add to agent.
5. Probier es im Test-Bereich des Agents aus: Bitte um etwas, wofür er die Yandex Disk-Tools braucht.
6. Klicke auf Publish, dann auf Channels → Microsoft 365 and Microsoft Teams, lass Make agent available in Microsoft Copilot aktiviert und wähle Add channel. See agent in Teams installiert den Agent für dich; in Microsoft 365 Copilot tippst du @ und wählst den Agent aus.

Lieber eine Anmeldung pro Person? Wähle statt API key OAuth 2.0 → Dynamic discovery: Dann meldet sich jede Person beim ersten Aufruf des Agents bei AnythingMCP an.

Du hostest selbst? Nimm statt https://cloud.anythingmcp.com die öffentliche HTTPS-Adresse deiner Instanz. Copilot Studio verbindet sich aus der Cloud von Microsoft, 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

Für welchen Copilot gilt das? Für Microsoft 365 Copilot im Unternehmen, über Agents aus Copilot Studio. Die Microsoft-Copilot-App für private Konten bietet keine Möglichkeit, einen eigenen MCP-Server hinzuzufügen.

Was brauche ich? Ein Arbeitskonto mit Zugang zu Copilot Studio (Lizenz oder Testversion), um den Agent zu bauen. Wer ihn in Microsoft 365 Copilot oder Teams nutzen soll, braucht Zugriff auf den Agent: Teile ihn oder lass ihn von einem Admin für die Organisation veröffentlichen. Wendet deine Organisation Datenrichtlinien auf Power-Platform-Connectors an, gelten sie auch für MCP-Server.

Der Agent ruft die Tools nicht auf. Prüfe, dass der Header-Name genau X-API-Key lautet und der Schlüssel zum selben MCP-Server gehört wie die URL, und formuliere die Server description konkret: Copilot Studio entscheidet anhand der Beschreibung, wann es den Server aufruft. Veröffentliche den Agent nach jeder Änderung erneut; in einem offenen Chat holst du die neue Version mit „start over“.

Nächste Schritte

• Connector-Startseite
• Mit Claude verbinden
• Mit ChatGPT verbinden
• Mit Cursor verbinden
• Mit Gemini verbinden
• Mit Meta Muse verbinden