Cómo conectar pCloud a Cursor vía MCP

💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → pCloud, pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin git clone, sin servidor local.

pCloud + Cursor

Deja que tu IA trabaje con tus archivos de pCloud: explora carpetas, lee detalles, revisiones y archivos de texto pequeños, obtén enlaces de descarga y lista los enlaces públicos, y tras tu confirmación crea carpetas, copia, mueve y renombra, o comparte con un enlace público. Cuentas en EE. UU. y la UE. Acceso con tu propia app de pCloud.

Requisitos previos

Las instrucciones de configuración completas están incluidas en el conector (visibles en el store al seleccionarlo). Las variables de entorno requeridas:

PCLOUD_CLIENT_ID, PCLOUD_CLIENT_SECRET, PCLOUD_API_HOST

Paso 1 — Obtener credenciales

La configuración lleva unos 5 minutos. Creas una pequeña app propia en pCloud y luego inicias sesión con tu cuenta de pCloud.

Primero, comprueba la región de tus datos. pCloud guarda cada cuenta en Estados Unidos o en Europa (Luxemburgo), según lo que elegiste al registrarte, y su API solo responde en la región de la cuenta. Si entras en la app web por e.pcloud.com, tu cuenta está en Europa: usa eapi.pcloud.com. Si entras por my.pcloud.com, está en Estados Unidos: usa api.pcloud.com. Con el host equivocado, el inicio de sesión falla o cada llamada responde "Invalid 'access_token' provided".

1. Inicia sesión en docs.pcloud.com, abre My Apps y haz clic en Create new app. Elige a qué puede acceder la app: solo a su propia carpeta o a todo el espacio. Elige todo el espacio si la IA debe trabajar con los archivos que ya tienes.
2. En la configuración de la app, añade la redirect URI https://cloud.anythingmcp.com/api/mcp-oauth/callback. Si alojas AnythingMCP por tu cuenta, añade en su lugar https://tu-host-anythingmcp/api/mcp-oauth/callback.
3. Copia el Client ID en PCLOUD_CLIENT_ID y el Client secret en PCLOUD_CLIENT_SECRET, escribe el host de tu región (eapi.pcloud.com o api.pcloud.com, sin https://) en PCLOUD_API_HOST e instala el conector.
4. En la página del conector, haz clic en Authorize with Provider, inicia sesión en pCloud y permite el acceso. Los tokens de pCloud no caducan, así que no hay nada que renovar.
5. Empieza con pcloud_get_user_info: muestra la cuenta, el plan y el espacio usado.

Qué lee: el contenido de cada carpeta, empezando por la raíz; los detalles de un archivo como tamaño, tipo, fechas y, en fotos y vídeos, ancho y alto; las revisiones anteriores de un archivo; el texto de archivos de texto pequeños como txt, csv, md, json o html (hasta unos 100 KB); enlaces de descarga temporales para cualquier archivo o revisión, pensados para ti y no para compartir; y tus enlaces públicos con las descargas hasta ahora.

Sin búsqueda: la API de pCloud no tiene búsqueda. Para encontrar un archivo, la IA recorre las carpetas y compara nombres, así que dile dónde buscar si lo sabes.

Los cambios esperan tu sí: crear carpetas, copiar, mover y renombrar archivos y carpetas, y crear enlaces públicos cambian tu espacio o hacen que los archivos sean accesibles para cualquiera con el enlace. Antes de cada operación, la IA te muestra exactamente qué pasará (origen, destino, nombre nuevo o ajustes del enlace) y espera tu confirmación. Mover o copiar sobre un archivo con el mismo nombre lo reemplaza, y la IA te avisa cuando eso ocurriría. Los enlaces públicos pueden tener fecha de caducidad, límite de descargas y, en los planes premium, contraseña.

Solo lectura: en la página del conector, desactiva pcloud_create_folder, pcloud_copy_file, pcloud_copy_folder, pcloud_move_file, pcloud_move_folder, pcloud_create_file_public_link y pcloud_create_folder_public_link.

Desactivadas al instalar: pcloud_delete_file y pcloud_delete_folder. Un administrador las activa a conciencia; los elementos eliminados van entonces a la papelera de pCloud, y la IA solo elimina tras tu confirmación. Una carpeta tiene que estar vacía para poder eliminarla.

Errores habituales: "Log in required" o "Invalid 'access_token' provided" significa que el acceso se revocó o que PCLOUD_API_HOST apunta a la otra región; corrige el host y vuelve a autorizar. "Access denied": una app limitada a su propia carpeta intentó acceder a otros archivos. Un archivo o una carpeta que no existe indica un id o una ruta incorrectos; los nombres distinguen mayúsculas y minúsculas. Cuota superada: el espacio está lleno. Demasiadas solicitudes: espera un minuto.

El conector no sube ni elimina archivos (eliminar está desactivado), no vacía la papelera, no comparte carpetas con otros usuarios de pCloud, no crea enlaces de subida ni archivos zip, no reproduce vídeo ni audio en streaming y no abre las carpetas pCloud Crypto, que se cifran en tu dispositivo y la API no puede leer.

Paso 2 — Instalar el 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

Paso 3 — Añadir el conector en Cursor

La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestra YOUR_SERVER_ID.

Cursor lee los servidores MCP de ~/.cursor/mcp.json. Añade esta entrada:

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

1. Crea una clave de API MCP en AnythingMCP en MCP Servers → tu servidor → API keys y pégala en lugar de YOUR_MCP_API_KEY.
2. Guarda el archivo y reinicia Cursor.
3. Abre Cursor → Settings → MCP y comprueba que anythingmcp aparece en la lista y está conectado.
4. Empieza a chatear: el agente ya puede usar las herramientas de pCloud.

Herramientas disponibles

Ejemplos de prompts

• "¿Cuánto espacio libre me queda en pCloud y hasta cuándo está pagado mi plan?"
• "¿Qué hay en mi carpeta Projects y qué archivos se modificaron más recientemente?"
• "Muéstrame las revisiones anteriores de notes.md y dame un enlace de descarga de la versión de la semana pasada."
• "Crea la carpeta Clientes/Acme y mueve allí el contrato de Acme desde Downloads. Enséñame antes lo que vas a hacer."
• "¿Qué enlaces públicos he creado y cuántas veces se ha descargado cada uno?"

FAQ

¿Cursor admite servidores MCP personalizados en el plan gratuito? Sí, MCP está disponible en los planes Hobby, Pro y Business.

Siguientes pasos

• Página del conector
• Conectar a Claude
• Conectar a ChatGPT