Referencia de servidor MCP de Microsoft SharePoint y OneDrive

Importante

Debe formar parte del programa de versión preliminar de Frontier para obtener acceso anticipado a Microsoft Agent 365. Frontier le conecta directamente con las innovaciones de inteligencia artificial más recientes de Microsoft. Las versiones preliminares de Frontier están sujetas a los términos de vista previa existentes en tus 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	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 específico de inquilino de SharePoint Online. Detecta y pone a disposición automáticamente todas las herramientas que admiten la integración de archivos de OneDrive y SharePoint expuestos por el punto de conexión MCP de ODSP.

Herramientas disponibles

createFolder

Crea una nueva carpeta dentro de una biblioteca de documentos especificada como elemento secundario de la carpeta primaria especificada. Si no especifica una biblioteca de documentos, el servidor usa 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(cadena): id. de la biblioteca de documentos (también denominada unidad) donde desea 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(cadena, valor predeterminado = "raíz") : id. de la carpeta primaria en la que se creará la nueva carpeta. El valor predeterminado es la raíz de la biblioteca de documentos si no se especifica.

findSite

Busca sitios de SharePoint 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.

listDocumentLibrariesInSite

Enumera las bibliotecas de documentos (también denominadas unidades) 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) al que el usuario puede acceder pasando una consulta de búsqueda.

Parámetros requeridos:

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

renameFileOrFolder

Cambie el nombre de un archivo o una carpeta (también denominado DriveItems) 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)

deleteFileOrFolder

Elimine 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

Leer (descargar) un archivo de texto de una biblioteca de documentos específica. Si no especifica una biblioteca de documentos, se usa OneDrive del usuario. Debe proporcionar un fileId (driveItemId de un archivo) para identificar y descargar el archivo.

Parámetros requeridos:

• fileId(cadena)
• documentLibraryId(cadena): id. de la biblioteca de documentos (también denominada unidad) del archivo que desea leer. Si el usuario le pide que lea o descargue un archivo en su unidad o en su Onedrive, por ejemplo: leer un archivo en "mi unidad", leer un archivo en "mi onedrive", debe enviar en "me" como documentLibraryId.

moveSmallFile

Mueva 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 se pueden mover archivos entre unidades mediante esta solicitud.

Parámetros requeridos:

• documentLibraryId(cadena): id. de la biblioteca de documentos (también denominada unidad) del archivo que desea mover. Si el usuario le pide mover un archivo en su unidad o en su Onedrive, por ejemplo: mover un archivo en "mi unidad", mover un archivo en "mi onedrive", debe enviar en "me" como documentLibraryId.
• fileId(cadena): id. del archivo que se 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

Obtener metadatos de un archivo o una carpeta de la biblioteca de documentos especificada en un sitio de Sharepoint.

Parámetros requeridos:

• FileOrFolderId(cadena): id. de un archivo o una carpeta. También se denominan DriveItems. Y su identificador también se puede denominar driveItemId.
• documentLibraryId(cadena): id. de la biblioteca de documentos (también denominada unidad) del archivo o carpeta de la que necesita los metadatos. Si el usuario le pide que obtenga un archivo o carpeta en su unidad o en su Onedrive, por ejemplo: "Obtener metadatos de un archivo en mi unidad" u "Obtener metadatos de una carpeta en mi onedrive", debe enviar en "me" como documentLibraryId.

createSmallTextFile

Cree o cargue un archivo de texto inferior a 5 MB en una biblioteca de documentos específica. Si no especifica una biblioteca de documentos, se usa 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:

• filename (cadena): nombre del archivo que se creará
• contentText (cadena): contenido de texto del archivo que se creará
• documentLibraryId (cadena): id. de la biblioteca de documentos (también denominada unidad) para el 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 acceder al archivo pueden obtener los metadatos.

Parámetros requeridos:

• fileOrFolderUrl:(cadena): dirección URL del archivo o carpeta (también denominado DriveItems). La dirección URL no se canjea para compartirla con el usuario; ya deben tener acceso explícito al archivo.

shareFileOrFolder

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

Parámetros requeridos:

• documentLibraryId: id. de biblioteca de documentos (cadena, obligatorio)
• fileOrFolderId: id. de archivo o carpeta (cadena, obligatorio)
• 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 (la 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. El valor predeterminado es verdadero si no se especifica.
• 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 es un mensaje estándar si no se especifica.

getFolderChildren

Enumera los 20 primeros archivos y carpetas dentro de una carpeta primaria especificada en una biblioteca de documentos. Si no especifica una biblioteca de documentos, se usa OneDrive del usuario.

Parámetros requeridos:

• documentLibraryId(cadena) id. de la biblioteca de documentos (también denominada unidad) para la carpeta primaria. Si un usuario le pide que obtenga archivos en una carpeta en su unidad o en su OneDrive, como "obtener archivos en una carpeta en mi unidad" u "obtener archivos en una carpeta en mi onedrive", envíe "me" como documentLibraryId.

Parámetros opcionales:

• parentFolderId:(cadena, valor predeterminado = "raíz") : id. de la carpeta primaria (DriveItem) cuyos archivos y carpetas se muestran. El valor predeterminado es la carpeta raíz de la biblioteca de documentos si no se especifica.

Echo

Devuelve el mensaje al cliente.

Parámetros requeridos:

• message: mensaje que se devolverá

setSensitivityLabelOnFile

Establezca la etiqueta de confidencialidad de un archivo de la biblioteca de documentos especificada.

Parámetros requeridos:

• documentLibraryId(cadena): id. de la biblioteca de documentos, también conocido como driveId, de la biblioteca de documentos
• fileId(string): el id. de 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 estándar, con privilegios, automático y 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.

getDefaultDocumentLibraryInSite

Obtenga la biblioteca de documentos predeterminada (también denominada Unidad) 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 elementos secundarios de carpeta (los 20 principales)
• Mover archivos entre carpetas (dentro del mismo sitio)

Operaciones de archivo

• Crear y cargar archivos de texto pequeños (< 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

• Buscar sitios de 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
• Control de acceso 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 de OneDrive y SharePoint Online
• Conexión de servidor específica del inquilino
• Abstracción de DriveItem para archivos y carpetas

Notas

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