Cómo conectar Microsoft OneDrive a Cursor vía MCP

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

Microsoft OneDrive + Cursor

Deja que tu IA trabaje en OneDrive: explora y busca archivos y carpetas, consulta detalles y quién tiene acceso, crea carpetas, sube y actualiza archivos de texto, copia, renombra y mueve. OneDrive para el trabajo o la escuela y OneDrive personal a través de Microsoft Graph, con el inicio de sesión de tu cuenta de Microsoft.

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:

MICROSOFT_CLIENT_ID, MICROSOFT_CLIENT_SECRET, MICROSOFT_TENANT_ID

Paso 1 — Obtener credenciales

1. Abre el centro de administración de Microsoft Entra (entra.microsoft.com) o el portal de Azure y ve a Applications → App registrations → New registration.

2. Ponle un nombre a la app (por ejemplo "AnythingMCP Microsoft 365") y elige los Supported account types. La elección decide qué va en MICROSOFT_TENANT_ID:

   • Accounts in this organizational directory only (un solo inquilino): solo pueden iniciar sesión los usuarios de tu organización. Usa el Directory (tenant) ID de la página Overview de la app (un GUID) o tu dominio, por ejemplo contoso.onmicrosoft.com.
   • Accounts in any organizational directory (multiinquilino): usa organizations.
   • Accounts in any organizational directory and personal Microsoft accounts: usa common (cuentas profesionales, educativas y personales) o consumers (solo cuentas personales).

   Si el valor no coincide con el tipo de cuenta, Microsoft rechaza el inicio de sesión (AADSTS50194 o AADSTS50020).

3. En Redirect URI elige la plataforma Web e introduce https://cloud.anythingmcp.com/api/mcp-oauth/callback. Si alojas AnythingMCP tú mismo, introduce en su lugar https://tu-host-anythingmcp/api/mcp-oauth/callback. El URI debe coincidir carácter por carácter; si no, Microsoft responde AADSTS50011.

4. Abre API permissions → Add a permission → Microsoft Graph → Delegated permissions y añade offline_access, User.Read y Files.ReadWrite. offline_access hace que Microsoft emita un refresh token; sin él, el conector deja de funcionar una hora después de autorizarlo.

5. Abre Certificates & secrets → New client secret. Copia el Value del secreto, no el Secret ID; solo se muestra una vez. Anota la fecha de caducidad: cuando el secreto caduca, el conector deja de funcionar hasta que crees uno nuevo y lo pegues.

6. Pega el Application (client) ID de la página Overview en MICROSOFT_CLIENT_ID, el valor del secreto en MICROSOFT_CLIENT_SECRET y el valor del inquilino del paso 2 en MICROSOFT_TENANT_ID, e instala el conector.

7. En la página del conector, haz clic en Authorize with Provider e inicia sesión con la cuenta cuyo OneDrive debe usar la IA. El refresh token se guarda cifrado y los access tokens (válidos durante una hora aproximadamente) se renuevan automáticamente.

8. Empieza con onedrive_get_drive: muestra en qué OneDrive ha iniciado sesión el conector y cuánto espacio queda libre.

Una sola app de Entra para todos los conectores de Microsoft: el registro de app que creaste para el conector de Outlook, SharePoint o Excel también sirve aquí. Ábrelo, añade el permiso del paso 4 en API permissions, conserva el mismo URI de redirección y reutiliza el mismo ID de cliente, el mismo secreto y el mismo inquilino. Cada conector pide solo sus propios permisos cuando lo autorizas:

• Outlook: Mail.ReadWrite, Mail.Send, Calendars.ReadWrite
• OneDrive: Files.ReadWrite
• Excel: Files.ReadWrite (más Files.ReadWrite.All para libros en SharePoint o compartidos contigo)
• SharePoint: Sites.ReadWrite.All y Files.ReadWrite.All

Todos necesitan además offline_access y User.Read.

Consentimiento del administrador: estos permisos delegados normalmente no necesitan un administrador, pero muchas organizaciones desactivan el consentimiento de los usuarios. Si el inicio de sesión muestra "Need admin approval" (AADSTS65001 o AADSTS90094), un administrador del inquilino abre una vez el registro de la app y hace clic en API permissions → Grant admin consent para la organización. Después, cualquier usuario puede autorizar. Cada conector sigue trabajando solo con lo que puede ver la cuenta que inició sesión.

Archivos compartidos contigo: Files.ReadWrite cubre tu propio OneDrive. Para abrir archivos que otras personas compartieron contigo, añade Files.ReadWrite.All al registro de la app, sustituye con él Files.ReadWrite en los ajustes OAuth del conector y vuelve a autorizar.

Solo lectura: sustituye los scopes en los ajustes OAuth del conector por offline_access User.Read Files.Read (o Files.Read.All), vuelve a autorizar y desactiva onedrive_create_folder, onedrive_upload_text_file, onedrive_replace_file_content, onedrive_copy_item, onedrive_rename_item y onedrive_move_item.

Desactivadas al instalar: onedrive_delete_item, onedrive_create_sharing_link y onedrive_invite. Los enlaces para compartir y las invitaciones están desactivados a propósito: dan a otras personas acceso a tus archivos, y un documento que lee la IA podría contener un texto que le pida compartir algo. Activa una herramienta solo si la IA de verdad la necesita. Los elementos eliminados van a la papelera de reciclaje de OneDrive y se pueden restaurar desde ahí.

Archivos y contenido: el conector lista, busca y describe archivos, pero no los descarga: la IA te da el enlace del archivo. Puede crear archivos de texto (.txt, .md, .csv, .json, .html, .xml) de hasta unos 4 MB y sobrescribirlos; OneDrive conserva el contenido anterior en el historial de versiones del archivo. Para las celdas de los libros de Excel, usa el conector de Microsoft Excel.

Errores frecuentes: 401 InvalidAuthenticationToken significa que la autorización se revocó o que el client secret caducó; pega un secreto nuevo si hace falta y vuelve a hacer clic en Authorize with Provider. 403 accessDenied significa que falta un permiso del paso 4 o que no se dio el consentimiento, o que no puedes modificar ese elemento. 404 itemNotFound significa que el id o la ruta es incorrecto, que el elemento se eliminó o que está en la unidad de otra persona. 409 nameAlreadyExists significa que ya hay un elemento con ese nombre en la carpeta. 423 resourceLocked significa que el archivo está abierto para edición o desprotegido (checked out).

El conector no descarga el contenido de los archivos, no sube archivos binarios ni de más de 4 MB, no restaura versiones, no vacía la papelera de reciclaje y no abre el OneDrive de otros usuarios ni las bibliotecas de SharePoint (de eso se encarga el conector de Microsoft SharePoint).

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

Herramientas disponibles

Ejemplos de prompts

• "¿Qué hay en mi carpeta Documentos/Informes 2026 y qué archivos cambiaron esta semana?"
• "Busca los archivos sobre la feria de Hamburgo, incluidos los que me compartieron mis compañeros."
• "Crea una carpeta Planificación T4 y guarda en ella estas notas de la reunión como notas.md."
• "¿Quién tiene acceso a la carpeta Contratos y tiene algún enlace para compartir?"

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
• Conectar a Gemini
• Conectar a Meta Muse