Referencia del servidor MCP de Microsoft 365 OneDrive

Importante

Debe formar parte del programa de versión preliminar Frontier para obtener acceso anticipado a Microsoft Agent 365. Frontier te conecta directamente con las últimas innovaciones de IA de Microsoft. Las previsualizaciones de Frontier están sujetas a los términos de previsualización existentes de sus acuerdos con clientes. Dado que estas características siguen en desarrollo, su disponibilidad y funcionalidades pueden cambiar con el tiempo.

Visión general

Id. de servidor	Nombre para mostrar	Descripción
mcp_OneDriveRemoteServer	Servidor MCP de Microsoft OneDrive	Servidor MCP para operaciones de OneDrive. Use este servidor para administrar archivos y carpetas en el OneDrive personal del usuario. Todas las operaciones de archivo limitadas a ≤5MB.

Nota:

El servidor MCP de Microsoft SharePoint y OneDrive está en desuso a partir del 13 de marzo de 2026. Si se trata de una conexión existente, todavía se admite. Para configurar nuevas conexiones, use el nuevo servidor MCP de Microsoft SharePoint y el servidor MCP de Microsoft OneDrive.

Herramientas disponibles

getOnedrive

Obtenga información sobre OneDrive del usuario, incluidos los metadatos de unidad, la cuota y la información del propietario.

No se requiere ningún parámetro.

getFolderChildrenInMyOnedrive

Enumera los 20 primeros archivos y carpetas (DriveItems) incluidos en una carpeta primaria especificada en OneDrive del usuario.

Parámetros opcionales:

• parentFolderId: Id. de la carpeta primaria cuyos archivos y carpetas se mostrarán (valor predeterminado: "raíz")

findFileOrFolderInMyDrive

Busca un archivo o carpeta (DriveItem) en la consulta de búsqueda de OneDrive del usuario. Más eficaz que buscar todos los archivos accesibles si sabe que el elemento está en OneDrive del usuario.

Parámetros requeridos:

• searchQuery: Consulta de búsqueda; puede ser el nombre de archivo completo o parcial.

getFileOrFolderMetadataInMyOnedrive

Obtiene los metadatos de un archivo o carpeta (DriveItem) del OneDrive del usuario.

Parámetros requeridos:

• fileOrFolderId: Id. del archivo o carpeta del OneDrive del usuario

getFileOrFolderMetadataByUrl

Obtiene los metadatos de un archivo o carpeta (DriveItem) de una dirección URL de uso compartido. Solo los usuarios con permisos explícitos existentes para acceder al archivo podrán obtener los metadatos.

Parámetros requeridos:

• fileOrFolderUrl: Dirección URL del archivo o carpeta. La dirección URL no se canjeará para compartirla con el usuario; ya deben tener acceso explícito

leerArchivoDeTextoPequeñoDeMiOnedrive

Lee (descarga) un archivo de texto de OneDrive del usuario. Debe proporcionar un fileId (driveItemId) para identificar y descargar el archivo.

Parámetros requeridos:

• fileId: DriveItemId del archivo que se va a leer o descargar

crearArchivoDeTextoPequeñoEnMiOneDrive

Cree o cargue un archivo de texto de tamaño inferior a 5 MB en OneDrive del usuario.

Parámetros requeridos:

• nombre de archivo: Nombre del archivo que se va a crear
• contentText: Contenido de texto del archivo

Parámetros opcionales:

• parentFolderId: Identificador de la carpeta primaria (valor predeterminado: 'root')

crearCarpetaEnMiOnedrive

Cree una nueva carpeta (DriveItem) en OneDrive del usuario como elemento secundario de la carpeta primaria especificada. Si ya existe una carpeta con el mismo nombre, se agrega un sufijo numérico (por ejemplo, NewFolder (1)).

Parámetros requeridos:

• folderName: Nombre de la carpeta que se va a crear

Parámetros opcionales:

• parentFolderId: Identificador de la carpeta primaria (valor predeterminado: 'root')

renameFileOrFolderInMyOnedrive

Cambie el nombre de un archivo o carpeta (DriveItem) en OneDrive del usuario. El nuevo nombre debe cumplir con las convenciones de nomenclatura.

Parámetros requeridos:

• fileOrFolderId: Id. del archivo o carpeta para cambiar el nombre
• newFileOrFolderName: Nuevo nombre para el archivo o carpeta
• etag: Valor de ETag para el control de simultaneidad. La operación solo tiene éxito si el ETag actual de DriveItem coincide con

borrarArchivoOCarpetaEnMiOnedrive

Elimine un archivo o carpeta (DriveItem) del OneDrive del usuario.

Parámetros requeridos:

• fileOrFolderId: Identificador del archivo o carpeta que se va a eliminar
• etag: Valor de ETag para el control de simultaneidad

moverArchivoPequeñoEnMiOneDrive

Mueva un archivo (DriveItem) de OneDrive del usuario a otra carpeta. Solo admite archivos inferiores a 5 MB.

Parámetros requeridos:

• fileId: Identificador del archivo que se va a mover
• newParentFolderId: Identificador de la carpeta de destino (debe estar en OneDrive del usuario)
• etag: Valor de ETag para el control de simultaneidad

compartirArchivoOCarpetaEnMiOnedrive

Envía una invitación para compartir para conceder permisos de lectura y escritura en un archivo o carpeta (DriveItem) en OneDrive del usuario.

Parámetros requeridos:

• fileOrFolderId: Identificador del archivo o carpeta que se va a compartir
• recipientEmails: Matriz de direcciones de correo electrónico de destinatarios que se van a invitar
• roles: Matriz de roles que se van a asignar. Valores aceptados: "read", "write" (write concede lectura y escritura)

Parámetros opcionales:

• Mensaje: Mensaje personalizado que se va a incluir en el correo electrónico de invitación (valor predeterminado: "Este es el archivo en el que estamos colaborando".
• sendInvitation: Si se va a enviar una invitación para compartir (valor predeterminado: true)

establecerEtiquetaDeSensibilidadEnArchivoEnMiOnedrive

Establezca la etiqueta de confidencialidad de un archivo en OneDrive del usuario.

Parámetros requeridos:

• fileId: DriveItemId del archivo
• sensitivityLabelId: Identificador de la etiqueta de confidencialidad que se va a asignar, o cadena vacía para eliminarla

Parámetros opcionales:

• assignmentMethod: Método de asignación: "standard", "privileged", "auto" o "unknownFutureValue" (valor predeterminado: "privileged")
• justificationText: Texto de justificación para fines de auditoría; obligatorio al degradar o quitar una etiqueta (valor predeterminado: "Cambiado por MCPServer")

Características clave

administración de OneDrive

• Obtener información de OneDrive (cuota, propietario)
• Acceso a OneDrive personal del usuario
• Todas las operaciones tienen como destino oneDrive autenticado del usuario

Búsqueda y detección de archivos

• Buscar archivos y carpetas por nombre en OneDrive del usuario
• Obtención de metadatos de archivo o carpeta por identificador o dirección URL de uso compartido
• Examinar el contenido de la carpeta (hasta 20 elementos)

Operaciones de archivo

• Crear archivos de texto (≤5MB)
• Leer archivos de texto
• Eliminación de archivos con control de simultaneidad
• Cambiar el nombre de los archivos con protección eTag
• Mover archivos entre carpetas

Administración de carteras

• Creación de carpetas con rutas de acceso primarias opcionales
• Sufijo numérico automático para nombres de carpeta duplicados
• Enumerar el contenido de la carpeta (hasta 20 elementos)
• Obtener metadatos de carpeta
• Eliminar carpetas con control de concurrencia
• Cambiar el nombre de las carpetas con protección eTag

Uso compartido y permisos

• Uso compartido de archivos y carpetas con usuarios
• Control de acceso basado en rol (lectura, escritura)
• Notificaciones por correo electrónico para compartir
• Mensajes personalizados en invitaciones

Seguridad y cumplimiento

• Aplicar y quitar etiquetas de confidencialidad
• Varios métodos de asignación (estándar, con privilegios, automático)
• Soporte para la justificación de auditoría
• Control de simultaneidad con eTags

Notas

• Todas las operaciones tienen como destino oneDrive personal del usuario autenticado.
• Las operaciones de archivo se limitan a ≤5MB para la carga y descarga
• Las operaciones de eliminación, cambio de nombre y movimiento requieren eTags para el control de simultaneidad
• Todas las operaciones usan Microsoft Graph API
• El uso compartido requiere direcciones de correo electrónico válidas y permisos adecuados
• Las etiquetas de confidencialidad requieren una configuración y licencias adecuadas
• La lista de carpetas devuelve un máximo de 20 elementos de forma predeterminada
• La protección de eTag evita conflictos en operaciones simultáneas

Nota:

Los nombres y parámetros de las herramientas MCP están sujetos a cambios y se deben evitar las dependencias codificadas de forma rígida. Se mantendrá la compatibilidad con escenarios.