pCloud über MCP mit Gemini verbinden

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

pCloud + Gemini

Lass deine KI mit deinen pCloud-Dateien arbeiten: Ordner durchsuchen, Dateidetails, Revisionen und kleine Textdateien lesen, Download-Links holen und öffentliche Links auflisten, sowie nach deiner Bestätigung Ordner anlegen, kopieren, verschieben, umbenennen oder per öffentlichem Link teilen. Konten in den USA und der EU. Anmeldung über deine eigene pCloud-App.

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:

PCLOUD_CLIENT_ID, PCLOUD_CLIENT_SECRET, PCLOUD_API_HOST

Schritt 1 — Zugangsdaten holen

Die Einrichtung dauert etwa 5 Minuten. Du legst bei pCloud eine kleine eigene App an und meldest dich dann mit deinem pCloud-Konto an.

Prüf zuerst deine Datenregion. pCloud speichert jedes Konto entweder in den USA oder in Europa (Luxemburg), festgelegt bei der Registrierung, und die API antwortet nur in der Region des Kontos. Meldest du dich in der Web-App unter e.pcloud.com an, liegt dein Konto in Europa: nimm eapi.pcloud.com. Meldest du dich unter my.pcloud.com an, liegt es in den USA: nimm api.pcloud.com. Mit dem falschen Host scheitert die Anmeldung oder jeder Aufruf meldet "Invalid 'access_token' provided".

1. Melde dich auf docs.pcloud.com an, öffne My Apps und klicke auf Create new app. Wähle, worauf die App zugreifen darf: nur auf ihren eigenen App-Ordner oder auf den ganzen Speicher. Nimm den ganzen Speicher, wenn die KI mit deinen vorhandenen Dateien arbeiten soll.
2. Trag in den Einstellungen der App die Redirect URI https://cloud.anythingmcp.com/api/mcp-oauth/callback ein. Wenn du AnythingMCP selbst betreibst, trag stattdessen https://dein-anythingmcp-host/api/mcp-oauth/callback ein.
3. Kopiere die Client ID in PCLOUD_CLIENT_ID und das Client secret in PCLOUD_CLIENT_SECRET, trag deinen Regions-Host (eapi.pcloud.com oder api.pcloud.com, ohne https://) in PCLOUD_API_HOST ein und installiere den Connector.
4. Klicke auf der Connector-Seite auf Authorize with Provider, melde dich bei pCloud an und erlaube den Zugriff. pCloud-Tokens laufen nicht ab, es gibt also nichts zu erneuern.
5. Starte mit pcloud_get_user_info: Es zeigt das Konto, den Tarif und den belegten Speicher.

Was sie liest: den Inhalt jedes Ordners, ab dem Stammordner; die Details einer Datei wie Größe, Typ, Datum und bei Fotos und Videos Breite und Höhe; frühere Revisionen einer Datei; den Text kleiner Textdateien wie txt, csv, md, json oder html (bis etwa 100 KB); temporäre Download-Links für jede Datei oder Revision, gedacht für dich und nicht zum Teilen; und deine öffentlichen Links mit den bisherigen Downloads.

Keine Suche: Die pCloud-API hat keine Suche. Um eine Datei zu finden, geht die KI die Ordner durch und vergleicht Namen. Sag ihr also, wo sie suchen soll, wenn du es weißt.

Änderungen nur nach deinem Ja: Ordner anlegen, Dateien und Ordner kopieren, verschieben und umbenennen sowie öffentliche Links erstellen ändern deinen Speicher oder machen Dateien für alle mit dem Link erreichbar. Vor jedem Schritt zeigt dir die KI genau, was passiert (Quelle, Ziel, neuer Name oder Link-Einstellungen), und wartet auf deine Bestätigung. Verschieben oder Kopieren auf eine Datei mit gleichem Namen ersetzt sie, und die KI sagt dir, wenn das passieren würde. Öffentliche Links können ein Ablaufdatum, ein Download-Limit und in Premium-Tarifen ein Passwort haben.

Nur lesen: Schalte auf der Connector-Seite pcloud_create_folder, pcloud_copy_file, pcloud_copy_folder, pcloud_move_file, pcloud_move_folder, pcloud_create_file_public_link und pcloud_create_folder_public_link aus.

Bei der Installation deaktiviert: pcloud_delete_file und pcloud_delete_folder. Ein Administrator schaltet sie bewusst ein; gelöschte Elemente landen dann im pCloud-Papierkorb, und die KI löscht erst nach deiner Bestätigung. Ein Ordner muss leer sein, damit er gelöscht werden kann.

Häufige Fehler: "Log in required" oder "Invalid 'access_token' provided" bedeutet, dass die Anmeldung widerrufen wurde oder PCLOUD_API_HOST auf die andere Region zeigt; korrigiere den Host und autorisiere erneut. "Access denied": Eine App, die auf ihren eigenen Ordner beschränkt ist, wollte auf andere Dateien zugreifen. Eine fehlende Datei oder ein fehlender Ordner heißt, dass ID oder Pfad falsch sind; Namen unterscheiden Groß- und Kleinschreibung. Speicher voll: Das Kontingent ist erschöpft. Zu viele Anfragen: eine Minute warten.

Der Connector lädt keine Dateien hoch und löscht keine (Löschen ist ausgeschaltet), leert nicht den Papierkorb, teilt keine Ordner mit anderen pCloud-Nutzern, erstellt keine Upload-Links oder ZIP-Archive, streamt keine Videos oder Audiodateien und öffnet keine pCloud-Crypto-Ordner, die auf deinem Gerät verschlüsselt und für die API nicht lesbar sind.

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 Gemini 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.

Gemini CLI liest MCP-Server aus ~/.gemini/settings.json (unter Windows %USERPROFILE%\.gemini\settings.json). Füge hinzu:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Erstelle in AnythingMCP unter MCP Servers → dein Server → API keys einen MCP-API-Key und setze ihn anstelle von YOUR_MCP_API_KEY ein.
2. Speichere die Datei und starte gemini neu.
3. Führe in der Gemini CLI /mcp aus (oder gemini mcp list im Terminal): anythingmcp sollte als verbunden erscheinen.
4. Leg los: Gemini CLI kann jetzt die pCloud-Tools aufrufen.

Verfügbare Tools

Beispiel-Prompts

• „Wie viel Platz ist in meinem pCloud noch frei, und bis wann ist mein Tarif bezahlt?“
• „Was liegt in meinem Ordner Projects, und welche Dateien wurden zuletzt geändert?“
• „Zeig mir die früheren Revisionen von notes.md und gib mir einen Download-Link für die Version von letzter Woche.“
• „Leg den Ordner Kunden/Acme an und verschieb den Acme-Vertrag aus Downloads dorthin. Zeig mir vorher, was du tun wirst.“
• „Welche öffentlichen Links habe ich erstellt, und wie oft wurde jeder davon heruntergeladen?“

FAQ

Wo sucht Gemini CLI nach MCP-Servern? In ~/.gemini/settings.json für deinen Benutzer oder in .gemini/settings.json innerhalb eines Projekts. gemini mcp list zeigt jeden Server und ob er sich verbindet.

Nächste Schritte

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