Come collegare pCloud a Cursor via MCP

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

pCloud + Cursor

Fai lavorare la tua AI con i tuoi file pCloud: sfoglia le cartelle, leggi dettagli, revisioni e piccoli file di testo, ottieni link di download ed elenca i link pubblici, e dopo la tua conferma crea cartelle, copia, sposta e rinomina, o condividi con un link pubblico. Account negli Stati Uniti e nell'UE. Accesso con la tua app pCloud.

Prerequisiti

Le istruzioni di setup complete sono incluse nel connettore stesso (visibili nello store quando lo selezioni). Le variabili d'ambiente richieste sono:

PCLOUD_CLIENT_ID, PCLOUD_CLIENT_SECRET, PCLOUD_API_HOST

Step 1 — Ottieni le credenziali

La configurazione richiede circa 5 minuti. Crei una piccola app tutta tua su pCloud e poi accedi con il tuo account pCloud.

Prima controlla la regione dei tuoi dati. pCloud conserva ogni account negli Stati Uniti oppure in Europa (Lussemburgo), a seconda della scelta fatta all'iscrizione, e la sua API risponde solo nella regione dell'account. Se accedi all'app web da e.pcloud.com, il tuo account è in Europa: usa eapi.pcloud.com. Se accedi da my.pcloud.com, è negli Stati Uniti: usa api.pcloud.com. Con l'host sbagliato l'accesso non riesce oppure ogni chiamata risponde "Invalid 'access_token' provided".

1. Accedi a docs.pcloud.com, apri My Apps e fai clic su Create new app. Scegli cosa può raggiungere l'app: solo la propria cartella o tutto lo spazio. Scegli tutto lo spazio se l'AI deve lavorare con i file che hai già.
2. Nelle impostazioni dell'app aggiungi il redirect URI https://cloud.anythingmcp.com/api/mcp-oauth/callback. Se ospiti AnythingMCP in proprio, aggiungi invece https://il-tuo-host-anythingmcp/api/mcp-oauth/callback.
3. Copia il Client ID in PCLOUD_CLIENT_ID e il Client secret in PCLOUD_CLIENT_SECRET, inserisci l'host della tua regione (eapi.pcloud.com o api.pcloud.com, senza https://) in PCLOUD_API_HOST e installa il connettore.
4. Nella pagina del connettore fai clic su Authorize with Provider, accedi a pCloud e consenti l'accesso. I token di pCloud non scadono, quindi non c'è nulla da rinnovare.
5. Inizia con pcloud_get_user_info: mostra l'account, il piano e lo spazio usato.

Cosa legge: il contenuto di ogni cartella, a partire dalla radice; i dettagli di un file come dimensione, tipo, date e, per foto e video, larghezza e altezza; le revisioni precedenti di un file; il testo dei piccoli file di testo come txt, csv, md, json o html (fino a circa 100 KB); link di download temporanei per qualsiasi file o revisione, pensati per te e non per la condivisione; e i tuoi link pubblici con i download fatti finora.

Nessuna ricerca: l'API di pCloud non ha una funzione di ricerca. Per trovare un file l'AI scorre le cartelle e confronta i nomi, quindi indicale dove cercare se lo sai.

Le modifiche aspettano il tuo sì: creare cartelle, copiare, spostare e rinominare file e cartelle e creare link pubblici cambiano il tuo spazio o rendono i file raggiungibili da chiunque abbia il link. Prima di ogni operazione l'AI ti mostra esattamente cosa succederà (origine, destinazione, nuovo nome o impostazioni del link) e aspetta la tua conferma. Spostare o copiare su un file con lo stesso nome lo sostituisce, e l'AI ti avvisa quando succederebbe. I link pubblici possono avere una scadenza, un limite di download e, nei piani premium, una password.

Solo lettura: nella pagina del connettore disattiva pcloud_create_folder, pcloud_copy_file, pcloud_copy_folder, pcloud_move_file, pcloud_move_folder, pcloud_create_file_public_link e pcloud_create_folder_public_link.

Disattivati all'installazione: pcloud_delete_file e pcloud_delete_folder. Un amministratore li attiva consapevolmente; gli elementi eliminati finiscono poi nel cestino di pCloud, e l'AI elimina solo dopo la tua conferma. Una cartella deve essere vuota per poter essere eliminata.

Errori comuni: "Log in required" o "Invalid 'access_token' provided" significa che l'accesso è stato revocato o che PCLOUD_API_HOST punta all'altra regione; correggi l'host e autorizza di nuovo. "Access denied": un'app limitata alla propria cartella ha provato a raggiungere altri file. Un file o una cartella mancante indica un id o un percorso sbagliato; i nomi distinguono tra maiuscole e minuscole. Spazio esaurito: la quota è piena. Troppe richieste: aspetta un minuto.

Il connettore non carica né elimina file (l'eliminazione è disattivata), non svuota il cestino, non condivide cartelle con altri utenti pCloud, non crea link di caricamento né archivi zip, non riproduce video o audio in streaming e non apre le cartelle pCloud Crypto, cifrate sul tuo dispositivo e illeggibili per l'API.

Step 2 — Installa l'adapter

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

Step 3 — Aggiungi il connettore in Cursor

L'URL del tuo server: in AnythingMCP apri MCP Servers → il server su cui si trova questo connettore e copia il suo URL (https://cloud.anythingmcp.com/mcp/…). Usalo ovunque questa guida mostra YOUR_SERVER_ID.

Cursor legge i server MCP da ~/.cursor/mcp.json. Aggiungi questa voce:

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

1. Crea una chiave API MCP in AnythingMCP da MCP Servers → il tuo server → API keys e incollala al posto di YOUR_MCP_API_KEY.
2. Salva il file e riavvia Cursor.
3. Apri Cursor → Settings → MCP e verifica che anythingmcp sia elencato e connesso.
4. Inizia a chattare: l'agente ora può usare i tool di pCloud.

Tool disponibili

Esempi di prompt

• "Quanto spazio libero resta nel mio pCloud, e fino a quando è pagato il mio piano?"
• "Cosa c'è nella mia cartella Projects, e quali file sono stati modificati più di recente?"
• "Mostrami le revisioni precedenti di notes.md e dammi un link di download per la versione della settimana scorsa."
• "Crea la cartella Clienti/Acme e spostaci il contratto Acme da Downloads. Mostrami prima cosa farai."
• "Quali link pubblici ho creato, e quante volte è stato scaricato ciascuno?"

FAQ

Cursor supporta server MCP personalizzati nel piano gratuito? Sì, MCP è disponibile nei piani Hobby, Pro e Business.

Prossimi passi

• Landing del connettore
• Collegare a Claude
• Collegare a ChatGPT