Referencia de servidores Microsoft SharePoint y OneDrive MCP

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 hijo de la carpeta padre especificada. Si no especificas 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 quieres crear la carpeta. Si quieres crear una carpeta en la unidad del usuario o en su OneDrive, como "mi disco" o "mi OneDrive", envía "me" como la documentLibraryIdunidad .

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.

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

Lista las bibliotecas de documentos (también llamadas discos) 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

Encuentra un archivo o una carpeta (también llamada 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

Renombra un archivo o una carpeta (también llamada 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

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 especificas una biblioteca de documentos, se utiliza el OneDrive del usuario. Necesitas proporcionar un fileId archivodriveItemId ( de un archivo) 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 leer o descargar un archivo en su unidad o en su OneDrive, como "Lee un archivo en mi unidad", o "Lee un archivo en mi OneDrive" que envías "yo" como el documentLibraryIdarchivo .

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 unidad) del archivo que quieres mover. Utiliza este parámetro cuando un usuario te pida mover un archivo en su disco o en su OneDrive. Por ejemplo, "Mover un archivo en mi unidad" o "Mover un archivo en mi OneDrive" que envías a "me" como el documentLibraryIdarchivo .
• 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 recibir. Utiliza este parámetro cuando un usuario te pida que obtengas un archivo o carpeta en su disco o en su OneDrive. Por ejemplo, "Obtener metadatos de un archivo en mi disco" o "Obtener metadatos de una carpeta en mi OneDrive" que envías en "me" como el documentLibraryIdarchivo .

createSmallTextFile

Crea o sube un archivo de texto menor a 5 MB a una biblioteca de documentos específica. Si no especificas una biblioteca de documentos, se utiliza 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 documentos (también llamada unidad) del archivo. Si un usuario te pide que crees un archivo en su disco o en su OneDrive, como "crear un archivo en mi unidad" o "crear un archivo en mi OneDrive", envía "me" como el documentLibraryIdarchivo .

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:(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 debe tener acceso explícito al archivo.

shareFileOrFolder

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 (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 principales archivos y carpetas dentro de una carpeta padre específica en una biblioteca de documentos. Si no especificas una biblioteca de documentos, se utiliza el OneDrive del usuario.

Parámetros requeridos:

• documentLibraryId(string) – ID de la biblioteca de documentos (también llamada unidad) para la carpeta padre. Si un usuario te pide que obtengas archivos en una carpeta de su disco o de su OneDrive, como "obtener archivos en una carpeta de mi disco" o "obtener archivos en una carpeta de mi OneDrive", envía "me" como el documentLibraryIdarchivo .

Parámetros opcionales:

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

Echo

Devuelve el mensaje al cliente.

Parámetros requeridos:

• message: mensaje que se devolverá

setSensitivityLabelOnFile

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, auto 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

Obtén la biblioteca de documentos predeterminada (también llamada 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

• 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

• 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
• DriveItem Abstracción para archivos y carpetas

Notas

• La biblioteca de documentos predeterminada es "me" (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 acceso explícitos
• DriveItems representan tanto archivos como carpetas
• Límite superior de 20 en la enumeración secundaria de carpetas