Referencia del servidor MCP de Microsoft SharePoint y OneDrive

Nota:

Este servidor MCP está en desuso. Los nuevos servidores MCP estarán disponibles para reemplazarlos pronto.

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.

Información general

Id. de servidor	Nombre para mostrar	Descripción
mcp_ODSPRemoteServer	Servidor MCP de Microsoft SharePoint y OneDrive	Servidor MCP que proporciona herramientas para trabajar con el contenido de SharePoint y OneDrive. Este servidor se conecta al servidor MCP de SharePoint Online específico del arrendatario. Detecta y pone a disposición automáticamente todas las herramientas que admiten la integración de archivos OneDrive y SharePoint expuestos por el punto de conexión MCP de ODSP.

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 NewFolder (1).

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 NewFolder (1).
• documentLibraryId(string) – ID de la biblioteca de documentos (también llamada unidad) donde se desea crear la carpeta. Si quiere crear una carpeta en el disco del usuario o en su OneDrive, como "mi disco" 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 xyz, pasaría xyz como searchQuery. Si el usuario solo solicita "mis sitios", deje este parámetro vacío.

listarBibliotecasDeDocumentosEnSitio

Enumera las bibliotecas de documentos (también conocidas como unidades o drives) en el sitio de SharePoint especificado. 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 DriveItem) 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 conocido como DriveItems) dentro de la especificada biblioteca de documentos. 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 fileId(driveItemIdarchivo) para identificar y descargar el archivo.

Parámetros requeridos:

• fileId(cadena)
• documentLibraryId(string) – ID de la biblioteca de documentos (también conocida como unidad) del archivo que quieres leer. El usuario pide para 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", debes enviar "me" como 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 de la biblioteca de documentos (también conocida como disco) del archivo que deseas 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", introduce "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 DriveItems. Su ID también puede denominarse a veces driveItemId.
• documentLibraryId(string) – ID de la biblioteca de documentos (también conocida como unidad) del archivo o carpeta cuyo metadato necesitas obtener. 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 unidad" o "Obtener metadatos de una carpeta en mi OneDrive", envíe "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) – Identificador de la biblioteca de documentos (también llamada disco) 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 DriveItems). 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 denominada drive) para la carpeta principal. 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 (DriveItem) 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 a 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 driveId, de la biblioteca de documentos.
• fileId(cadena) – El ID del archivo, también conocido como driveItemId, 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 standard, privileged, autoy unknownFutureValue.
• 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 "drive", 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
• DriveItem Abstracción de 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
• DriveItems representan tanto archivos como carpetas
• Límite de 20 en la enumeración de elementos secundarios de carpeta