Conectar OneDrive MCP con Microsoft Copilot

💡 ¿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 + Microsoft Copilot

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

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.

Microsoft Copilot usa servidores MCP a través de agentes creados en Copilot Studio: añades AnythingMCP a un agente como herramienta y luego publicas el agente en Microsoft 365 Copilot y Teams. Copilot Studio se conecta desde la nube de Microsoft por Streamable HTTP, que AnythingMCP admite.

1. En Copilot Studio, abre tu agente (o crea uno), ve a Tools y elige Add a tool → New tool → Model Context Protocol.
2. Escribe un Server name (por ejemplo AnythingMCP), una Server description que diga qué hace el conector y la Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio usa la descripción para decidir cuándo llamar al servidor.
3. En la autenticación, elige API key, pon Type en Header y X-API-Key como nombre de la cabecera, y selecciona Create.
4. En Add tool, elige Create a new connection, pega una clave de API MCP de AnythingMCP (MCP Servers → tu servidor → API keys) y selecciona Add to agent.
5. Pruébalo en el panel Test del agente: pide algo que necesite las herramientas de Microsoft OneDrive.
6. Selecciona Publish y luego Channels → Microsoft 365 and Microsoft Teams, deja marcada Make agent available in Microsoft Copilot y elige Add channel. See agent in Teams lo instala para ti; en Microsoft 365 Copilot, escribe @ y elige el agente.

¿Prefieres que cada persona inicie sesión? En lugar de la clave de API elige OAuth 2.0 → Dynamic discovery: cada usuario inicia sesión en AnythingMCP la primera vez que el agente lo llama.

¿Lo alojas tú mismo? Usa la dirección HTTPS pública de tu instancia en lugar de https://cloud.anythingmcp.com. Copilot Studio se conecta desde la nube de Microsoft, así que localhost no funciona.

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

¿Para qué Copilot es? Para Microsoft 365 Copilot en el trabajo, mediante agentes de Copilot Studio. La app de Microsoft Copilot para cuentas personales no permite añadir tu propio servidor MCP.

¿Qué necesito? Una cuenta de trabajo con acceso a Copilot Studio (licencia o prueba) para crear el agente. Quien lo use en Microsoft 365 Copilot o Teams necesita acceso al agente: compártelo o pide a un administrador que lo publique para la organización. Si tu organización aplica directivas de datos a los conectores de Power Platform, también cubren los servidores MCP.

El agente no llama a las herramientas. Comprueba que el nombre de la cabecera sea exactamente X-API-Key y que la clave pertenezca al mismo servidor MCP que la URL, y escribe una Server description concreta: Copilot Studio la usa para decidir cuándo llamar al servidor. Vuelve a publicar el agente después de cada cambio; en un chat abierto, escribe "start over" para usar la nueva versión.

Siguientes pasos

• Página del conector
• Conectar a Claude
• Conectar a ChatGPT
• Conectar a Cursor
• Conectar a Gemini
• Conectar a Meta Muse