Referencia de servidor MCP de Microsoft SharePoint y OneDrive

Información general

Herramientas disponibles

crearCarpeta

Crea una nueva carpeta dentro de una biblioteca de documentos especificada como hijo de la carpeta padre especificada. Si no especifica una biblioteca de documentos, el servidor usa el OneDrive del usuario. Si no especifica una carpeta primaria, el servidor crea la carpeta en la raíz. Si ya existe una carpeta con el mismo nombre, el servidor crea la nueva carpeta con un sufijo numérico, como .

Parámetros requeridos:

• folderName(cadena): nombre de la carpeta que se creará. Si ya existe una carpeta con el mismo nombre, el servidor agrega un sufijo numérico al nuevo nombre de carpeta, como .
• documentLibraryId(string) – ID de la biblioteca de documentos (también llamada unidad) donde quieres crear la carpeta. Si desea crear una carpeta en la unidad del usuario o en su OneDrive, como "mi unidad" o "mi OneDrive", envíe "me" como documentLibraryId.

Parámetros opcionales:

• parentFolderId(string, default = "root") – ID de la carpeta padre bajo la que se crea la nueva carpeta. El valor predeterminado es la raíz de la biblioteca de documentos si no se especifica.

encontrarSitio

Busca SharePoint sitios a los que el usuario puede acceder. Esta herramienta puede encontrar un sitio específico basado en una consulta de búsqueda que proporcione o encontrar los 20 sitios pertinentes principales accesibles por el usuario si no proporciona una consulta de búsqueda.

Parámetros requeridos:

Nada

Parámetros opcionales:

• searchQuery(cadena, valor predeterminado = null): consulta de búsqueda que puede ser el nombre completo o parcial del sitio. Proporcionar una consulta de búsqueda ayuda a buscar un sitio de manera eficaz, pero solo si el usuario busca un sitio específico. Por ejemplo, si el usuario solicita un sitio denominado , pasaría como . Si el usuario solo solicita "mis sitios", deje este parámetro vacío.

listarBibliotecasDeDocumentosEnSitio

Enumera las bibliotecas de documentos (también llamadas repositorios) en el sitio especificado de SharePoint. Si no especifica un sitio, el servidor usa el sitio raíz.

Parámetros requeridos:

Nada

Parámetros opcionales:

• siteId: id. de sitio (valor predeterminado: raíz)

findFileOrFolder

Busca un archivo o una carpeta (también denominado ) que el usuario puede acceder introduciendo una consulta de búsqueda.

Parámetros requeridos:

• searchQuery: consulta de búsqueda que puede ser el nombre de archivo completo o parcial

renameFileOrFolder

Renombra un archivo o una carpeta (también referida como) dentro de la biblioteca de documentos especificada. Nota: El nuevo nombre debe cumplir con las convenciones de nomenclatura.

Parámetros requeridos:

• documentLibraryId: ID de biblioteca de documentos (cadena)
• fileOrFolderId: ID de archivo o carpeta (cadena)
• newFileOrFolderName: nuevo nombre para el archivo o carpeta (cadena)

eliminarArchivoOCarpeta

Elimina un archivo o una carpeta de la biblioteca de documentos especificada.

Parámetros requeridos:

• documentLibraryId: ID de biblioteca de documentos (cadena)
• fileOrFolderId: ID de archivo o carpeta (cadena)

readSmallTextFile

Lee (descarga) un archivo de texto de una biblioteca de documentos específica. Si no especifica una biblioteca de documentos, se usa el OneDrive del usuario. Necesitas proporcionar un nombre de archivo para identificar y descargar el archivo.

Parámetros requeridos:

• fileId(cadena)
• documentLibraryId(string) – ID de la biblioteca de documentos (también denominada 'drive') del archivo que deseas leer. El usuario pide leer o descargar un archivo en su unidad o en su OneDrive, como "Leer un archivo en mi unidad" o "Leer un archivo en mi OneDrive", y envía "me" como la documentLibraryId.

moveSmallFile

Mueve un archivo ubicado en la biblioteca de documentos especificada a otra carpeta. Esta herramienta solo admite el movimiento de archivos de menos de 5 MB y los movimientos que se encuentran dentro del mismo sitio. No puedes mover archivos entre discos usando esta petición.

Parámetros requeridos:

• documentLibraryId(string) – ID del repositorio de documentos (también conocido como biblioteca) del archivo que quieres mover. Use este parámetro cuando un usuario le pida que mueva un archivo en su unidad o en su OneDrive. Por ejemplo, "Mover un archivo en mi unidad" o "Mover un archivo en mi OneDrive" debes enviar "me" como el documentLibraryId.
• fileId(string) – ID del archivo a mover.
• newParentFolderId(cadena): id. de la carpeta de destino a la que se moverá el archivo. Debe estar en la misma biblioteca de documentos que la ubicación original del archivo.

getFileOrFolderMetadata

Obtén metadatos de un archivo o carpeta de la biblioteca de documentos especificada en un sitio de SharePoint.

Parámetros requeridos:

• FileOrFolderId(string) – ID de un archivo o carpeta. También se les llama . Su ID también puede denominarse a veces .
• documentLibraryId(string) – ID de la biblioteca de documentos (también conocida como unidad de almacenamiento) del archivo o carpeta de los que necesitas obtener los metadatos. Use este parámetro cuando un usuario le pida que obtenga un archivo o carpeta en su unidad o en su OneDrive. Por ejemplo, "Obtener metadatos de un archivo en mi Drive" o "Obtener metadatos de una carpeta en mi OneDrive", envía "me" como documentLibraryId.

createSmallTextFile

Crea o sube un archivo de texto menor a 5 MB a una biblioteca de documentos específica. Si no especifica una biblioteca de documentos, se usa el OneDrive del usuario. Puede cargar el archivo a un carpeta específica. Si no especifica una carpeta, el archivo se carga en la carpeta raíz.

Parámetros requeridos:

• Nombre del archivo (cadena) – Nombre del archivo a crear.
• contentText (cadena) – Contenido de texto del archivo a crear.
• documentLibraryId (cadena) – ID de la biblioteca de archivos (también llamada unidad de almacenamiento) del archivo. Si un usuario le pide que cree un archivo en su unidad o en su OneDrive, como "crear un archivo en mi unidad" o "crear un archivo en mi OneDrive", envíe "me" como documentLibraryId.

Parámetros opcionales:

• parentfolderId(cadena, valor predeterminado = "raíz"): id. de carpeta dentro de la unidad para agregar el nuevo archivo.

getFileOrFolderMetadataByUrl

Obtiene los metadatos de un archivo o carpeta de una dirección URL de uso compartido. Solo los usuarios con permisos explícitos para access el archivo pueden obtener los metadatos.

Parámetros requeridos:

• fileOrFolderUrl:(string) – URL del archivo o carpeta (también conocida como ). El parámetro URL no concede permiso para compartir el objeto con el usuario; el usuario ya debe tener acceso explícito al archivo.

compartirArchivoOCarpeta

Envía una invitación de compartir para conceder permisos en un archivo o carpeta dentro de una biblioteca documental especificada. Admite la asignación de roles y la notificación a los destinatarios.

Parámetros requeridos:

• documentLibraryId: ID de biblioteca de documentos (cadena, requerido)
• fileOrFolderId: ID de archivo o carpeta (cadena, requerido)
• recipientEmails:(cadena[], obligatorio): direcciones de correo electrónico de los destinatarios que se invitarán. Se requiere al menos un correo electrónico de destinatario.

Parámetros opcionales:

• roles(cadena[]):: roles que se asignarán a los destinatarios. Valores aceptados: lectura, escritura (escritura concede acceso de lectura y escritura). El valor predeterminado es el rol de lectura si no se especifica.
• sendInvitation(bool, valor predeterminado = verdadero): indica si se debe enviar una invitación para compartir. Por defecto, es verdadero si no se especifica de otra manera.
• message(cadena, valor predeterminado = "Este es el archivo en el que estamos colaborando."): mensaje personalizado que se incluirá en el correo electrónico de invitación. El valor predeterminado será un mensaje estándar si no se especifica.

getFolderChildren

Enumera los 20 principales archivos y carpetas dentro de una carpeta padre específica en una biblioteca de documentos. Si no especifica una biblioteca de documentos, se usa el OneDrive del usuario.

Parámetros requeridos:

• documentLibraryId(string) – ID de la biblioteca de documentos (también llamada unidad de almacenamiento) para la carpeta padre. Si un usuario le pide que obtenga archivos en una carpeta en su unidad o su OneDrive, como "obtener archivos en una carpeta en mi unidad" o "obtener archivos en una carpeta de mi OneDrive", envíe "me" como la documentLibraryId.

Parámetros opcionales:

• parentFolderId:(cadena, por defecto = "root") – ID de la carpeta padre () cuyos archivos y carpetas están listados. Por defecto, se establece en la carpeta raíz de la biblioteca de documentos si no se especifica.

Echo

Devuelve el mensaje al cliente.

Parámetros requeridos:

• message: mensaje para enviar de vuelta

establecerEtiquetaDeSensibilidadEnArchivo

Establece la etiqueta de sensibilidad de un archivo de la biblioteca de documentos especificada.

Parámetros requeridos:

• documentLibraryId(string) – El ID de la biblioteca de documentos, también conocido como , de la biblioteca de documentos.
• fileId(cadena) – El ID del archivo, también conocido como , del archivo.
• sensitivityLabelId(cadena): obligatorio. ID de la etiqueta de confidencialidad que se asignará, o cadena vacía para quitar la etiqueta de confidencialidad.

Parámetros opcionales:

• assignmentMethod(cadena, valor predeterminado = "con privilegios") : método de asignación de la etiqueta en el documento. Indica si la asignación de la etiqueta se realizó automáticamente, estándar o como una operación con privilegios (equivalente a una operación de administrador). Los valores posibles son , , y .
• justificationText(cadena, valor predeterminado = "Cambiado por MCPServer"): opcional. Texto de justificación para fines de auditoría y es obligatorio al degradar o quitar una etiqueta.

obtenerBibliotecaDeDocumentosPredeterminadaEnSitio

Obtenga la biblioteca de documentos predeterminada (también conocida como almacenamiento) en un sitio de SharePoint. Si no especifica un sitio, se usa el sitio raíz.

Parámetros requeridos:

Nada

Parámetros opcionales:

• siteId: id. de sitio (valor predeterminado: raíz)

Características clave

Administración de carteras

• Crear carpetas con resolución automática de conflictos de nomenclatura
• Enumerar los 20 elementos principales de la carpeta
• Mover archivos entre carpetas (dentro del mismo sitio)

Operaciones de archivo

• Crea y sube pequeños archivos de texto (menos de 5 MB)
• Leer y descargar archivos de texto
• Cambiar nombre de archivos y carpetas
• Eliminar archivos y carpetas
• Obtener metadatos de archivo y carpeta por id. o dirección URL

Detección de sitios y bibliotecas

• Búsqueda de sitios SharePoint por consulta de búsqueda
• Enumerar bibliotecas de documentos en un sitio
• Obtener la biblioteca de documentos predeterminada

Uso compartido y permisos

• Compartir archivos y carpetas con asignaciones de roles
• Enviar invitaciones de uso compartido con mensajes personalizados
• Access control a través de permisos explícitos

Seguridad y cumplimiento

• Establecer etiquetas de confidencialidad en archivos
• Compatibilidad con métodos de asignación con privilegios, estándar y automático
• Texto de justificación para la auditoría de cumplimiento

Integración

• compatibilidad con OneDrive y SharePoint Online
• Conexión de servidor específica del inquilino
• Abstracción para archivos y carpetas

Notas

• La biblioteca de documentos predeterminada es "me" (la OneDrive del usuario)
• La carpeta primaria predeterminada es 'raíz'
• Conflictos de nombres de carpeta resueltos con sufijos numéricos
• El archivo se mueve limitado a menos de 5 MB y dentro del mismo sitio
• Las direcciones URL de uso compartido requieren permisos de access explícitos
• representan tanto archivos como carpetas
• Límite de 20 en la enumeración de elementos secundarios de carpeta