Referencia de Work IQ OneDrive (versión preliminar)

Importante

• Esta es una característica en vista previa.
• Las características en versión preliminar no se han diseñado para un uso de producción y pueden tener una funcionalidad restringida. Estas características están sujetas a condiciones de uso adicionales y están disponibles antes del lanzamiento oficial para que los clientes puedan tener un acceso anticipado y proporcionar comentarios.

Información general

Id. de servidor	Nombre para mostrar	Description
mcp_OneDriveRemoteServer	Work IQ 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:

• Las conexiones existentes que usan versiones anteriores de servidores MCP de Microsoft, como el servidor MCP de Microsoft Teams, siguen siendo compatibles.
• Para todas las conexiones nuevas, use los servidores MCP de Work IQ más recientes, como Work IQ Teams.

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")

buscarArchivoOCarpetaEnMiOneDrive

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

readSmallTextFileFromMyOnedrive

Lee (descarga) un archivo de texto de OneDrive del usuario.

Parámetros requeridos:

• fileId: Identificador del archivo (DriveItem) para 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

Parámetros opcionales:

• 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

Parámetros opcionales:

• 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: 'lectura', 'escritura' (la escritura 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: Identificador del archivo (DriveItem)
• sensitivityLabelId: Id. de la etiqueta de confidencialidad que se asignará o cadena vacía para quitar

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")

crearArchivoBinarioPequeñoEnMiOnedrive

Cree un archivo binario de tamaño inferior a 5 MB mediante la codificación base64 de su contenido en el OneDrive del usuario.

Parámetros requeridos:

• nombre de archivo: Nombre del archivo que se va a crear, incluida la extensión de archivo
• base64Content: El contenido del archivo binario codificado como una cadena base64

Parámetros opcionales:

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

readSmallBinaryFileFromMyOnedrive

Lea un archivo binario de tamaño inferior a 5 MB del OneDrive del usuario. El contenido del archivo se devuelve como una cadena codificada en base64.

Parámetros requeridos:

• fileId: Identificador del archivo (DriveItem) para leer o descargar

copiarArchivoOCarpetaEnMiOnedrive

Copie un archivo o carpeta (DriveItem) en una carpeta de destino dentro del OneDrive del usuario. Esta operación es asincrónica; use checkOperationStatusInMyOnedrive para supervisar el progreso.

Parámetros requeridos:

• sourcefileid: Identificador del archivo o carpeta de origen (DriveItem) que se va a copiar
• destfolderid: id. de la carpeta de destino (debe existir en el OneDrive del usuario).

Parámetros opcionales:

• newfilename: Nuevo nombre para el elemento copiado (el valor predeterminado es el nombre original)

moveFileOrFolderInMyOnedrive

Mueva un archivo o carpeta (DriveItem) a una carpeta de destino dentro del OneDrive del usuario. Esta operación es asincrónica; use checkOperationStatusInMyOnedrive para supervisar el progreso.

Parámetros requeridos:

• sourcefileid: Identificador del archivo o carpeta de origen (DriveItem) que se va a mover
• destfolderid: id. de la carpeta de destino (debe existir en el OneDrive del usuario).

Parámetros opcionales:

• newfilename: Nuevo nombre para el elemento movido (el valor predeterminado es el nombre original)

checkOperationStatusInMyOnedrive

Compruebe el estado de una operación asincrónica (como copiar o mover) mediante el token de operación devuelto desde la operación original. Devuelve información de progreso si aún está en curso, detalles del error si se produce un error o los metadatos finales de archivo o carpeta si se completan correctamente.

Parámetros requeridos:

• operationToken: El token de operación devuelto desde una operación asincrónica como copyFileOrFolderInMyOnedrive o moveFileOrFolderInMyOnedrive

Funciones principales

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 binarios y de texto (≤5MB)
• Leer archivos binarios y de texto (≤5MB)
• Eliminación de archivos con control de simultaneidad
• Cambiar el nombre de los archivos con protección eTag
• Copiar y mover archivos y carpetas de forma asincrónica

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 normativo

• 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 y cambio de nombre admiten eTags para el control de simultaneidad
• 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

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.