Referencia de SharePoint (vista previa)

Note

Este artículo describe características utilizadas en agentes o flujos de agentes alimentados por el arnés estándar.

Importante

Esta es una característica en vista previa.

• Microsoft publica características en versión preliminar antes de su lanzamiento oficial para que los clientes puedan obtener acceso anticipado y enviar comentarios.
• Las características en versión preliminar tienen funcionalidad restringida y no están pensadas para su uso en producción.
• Microsoft podría cambiar los nombres y parámetros de la herramienta MCP en versión preliminar. Evite las dependencias codificadas de forma rígida. Microsoft mantiene la compatibilidad con escenarios.
• Las características en versión preliminar se rigen por los términos de uso adicionales de Microsoft.

Note

Las herramientas MCP específicas de Microsoft 365 (Copilot, Calendar, Mail, SharePoint, OneDrive, Teams, User y Word) solo están pensadas para fines de compatibilidad hacia atrás y no deben usarse en entornos de producción ni en proyectos nuevos. Para nuevos proyectos que requieren acceso a recursos de Microsoft 365, utiliza Work IQ MCP con el arnés Microsoft Copilot. Para más información, véase Work IQ MCP en Copilot Studio.

Overview

Id. de servidor	Dirección URL a nivel de arrendatario	Nombre para mostrar	Description
mcp_SharePointRemoteServer	https://agent365.svc.cloud.microsoft/ agents/tenants/{tenantId}/servers/ mcp_SharePointRemoteServer	SharePoint	Herramientas para operaciones de SharePoint. Use este servidor para administrar sitios, listas, elementos de lista, columnas, bibliotecas de documentos, archivos, carpetas y uso compartido de archivos. Las operaciones de archivo se limitan a los archivos de 5 MB o menos.

Herramientas disponibles

encontrarSitio

Encuentra los sitios de SharePoint a los que puede acceder. Devuelve sitios específicos que coinciden con una consulta de búsqueda o los 20 sitios relevantes principales si no proporciona una consulta.

Parámetros opcionales:

• searchQuery: Consulta de búsqueda (nombre del sitio completo o parcial). Omitir para devolver los 20 sitios accesibles principales.

getSiteByPath

Resuelve un sitio de SharePoint mediante su nombre de host exacto y la ruta de acceso relativa al servidor. Use este método solo cuando tenga la estructura completa de la dirección URL del sitio. Use findSite cuando solo conozca un nombre de sitio.

Parámetros requeridos:

• Nombre de anfitrión: Nombre exacto de anfitrión (por ejemplo, 'contoso.sharepoint.com')
• serverRelativePath: Camino relativo al servidor (por ejemplo, 'sitios/Marketing'). La barra diagonal inicial es opcional.

listSubsites

Enumera todos los subsitios (sitios secundarios) de un sitio de SharePoint.

Parámetros requeridos:

• SiteId: ID del sitio principal de SharePoint (formato: 'hostname,siteCollectionId,webId')

listarBibliotecasDeDocumentosEnSitio

Enumera las bibliotecas de documentos (unidades) en el sitio de SharePoint especificado.

Parámetros opcionales:

• SiteId: ID del sitio de SharePoint (por defecto: 'root')

obtenerBibliotecaDeDocumentosPredeterminadaEnSitio

Obtiene la biblioteca de documentos predeterminada (drive) de un sitio de SharePoint.

Parámetros opcionales:

• SiteId: ID del sitio de SharePoint (por defecto: 'root')

getFolderChildren

Enumera los 20 archivos y carpetas principales (DriveItems) incluidos en una carpeta primaria especificada en una biblioteca de documentos (unidad).

Parámetros requeridos:

• documentLibraryId: ID de la biblioteca de documentos (unidad)

Parámetros opcionales:

• parentFolderId: ID de la carpeta padre (por defecto: 'root').

findFileOrFolder

Busca un archivo o carpeta (DriveItem) accesible para el usuario mediante una consulta de búsqueda. Busca en todos los sitios y bibliotecas de documentos a los que el usuario tiene acceso.

Parámetros requeridos:

• searchQuery: Consulta de búsqueda (nombre de archivo completo o parcial)

getFileOrFolderMetadata

Obtiene los metadatos de un archivo o carpeta (DriveItem) de la biblioteca de documentos (drive) especificada en SharePoint.

Parámetros requeridos:

• fileOrFolderId: ID del archivo o carpeta (DriveItem)
• documentLibraryId: ID de la biblioteca de documentos (unidad)

getFileOrFolderMetadataByUrl

Obtiene metadatos de un archivo o carpeta (DriveItem) de una URL compartida. Solo los usuarios con permisos explícitos existentes para acceder al archivo pueden obtener los metadatos.

Parámetros requeridos:

• fileOrFolderUrl: URL del archivo o carpeta. La dirección URL no se utiliza para compartirla con el usuario; este ya debe tener acceso explícito.

readSmallTextFile

Lee (descarga) un archivo de texto de menos de 5 MB de una biblioteca de documentos concreta (unidad).

Parámetros requeridos:

• fileId: ID del archivo (DriveItem) para leer o descargar
• documentLibraryId: ID de la biblioteca de documentos (unidad)

readSmallBinaryFile

Lee un archivo binario de menos de 5 MB de una biblioteca de documentos concreta (drive). El contenido del archivo se devuelve como una cadena codificada en base64.

Parámetros requeridos:

• fileId: ID del archivo (DriveItem) para leer o descargar
• documentLibraryId: ID de la biblioteca de documentos (drive)

createSmallTextFile

Crea o sube un archivo de texto menor a 5 MB a una biblioteca de documentos específica (disco).

Parámetros requeridos:

• filename: Nombre del archivo incluyendo la extensión.
• contentText: Contenido de texto del archivo.
• documentLibraryId: ID de la biblioteca de documentos (drive)

Parámetros opcionales:

• parentFolderId: ID de la carpeta padre (por defecto: 'root').

crearArchivoBinarioPequeño

Crea un archivo binario inferior a 5 MB mediante la codificación base64 de su contenido en una biblioteca de documentos (unidad) específica.

Parámetros requeridos:

• filename: Nombre del archivo incluyendo la extensión.
• base64Content: Contenido binario del archivo codificado como una cadena base64.
• documentLibraryId: ID de la biblioteca de documentos (drive)

Parámetros opcionales:

• parentFolderId: ID de la carpeta padre (por defecto: 'root').

crearCarpeta

Crea una nueva carpeta (DriveItem) en una biblioteca de documentos (drive) especificada. Si existe una carpeta con el mismo nombre, el sistema agrega un sufijo numérico (por ejemplo, NewFolder (1)).

Parámetros requeridos:

• nombreCarpeta: Nombre de la carpeta
• documentLibraryId: ID de la biblioteca de documentos (unidad)

Parámetros opcionales:

• parentFolderId: ID de la carpeta padre (por defecto: 'root').

renameFileOrFolder

Cambia el nombre de un archivo o carpeta (DriveItem) dentro de una biblioteca de documentos (unidad) especificada. El nuevo nombre debe cumplir con las convenciones de nomenclatura.

Parámetros requeridos:

• documentLibraryId: ID de la biblioteca de documentos (unidad)
• archivoOCarpetaId: ID del archivo o carpeta a renombrar
• nuevoNombreDeArchivoOCarpeta: El nuevo nombre

Parámetros opcionales:

• etag: ETag para control de concurrencia

eliminarArchivoOCarpeta

Elimina un archivo o carpeta (DriveItem) de una biblioteca de documentos (unidad) especificada.

Parámetros requeridos:

• documentLibraryId: ID de la biblioteca de documentos (drive)
• fileOrFolderId: ID del archivo o carpeta a eliminar

Parámetros opcionales:

• etag: ETag para control de concurrencia

moveFileOrFolder

Mueve un archivo o carpeta (DriveItem) a una carpeta de destino. Admite trasladar documentos entre diferentes bibliotecas de documentos (repositorios) dentro de SharePoint. Esta operación es asincrónica. Use checkOperationStatus para supervisar el progreso.

Parámetros requeridos:

• sourcedoclibid: ID de la biblioteca de documentos de origen (unidad)
• sourcefileid: ID del archivo o carpeta de origen que se va a mover
• destdoclibid: ID de la biblioteca de documentos de destino (disco)
• destfolderid: ID de la carpeta de destino (debe existir)

Parámetros opcionales:

• newfilename: Nuevo nombre para el elemento trasladado

copiarArchivoOCarpeta

Copia un archivo o carpeta (DriveItem) en una carpeta de destino. Admite la copia en diferentes bibliotecas de documentos dentro de SharePoint. Esta operación es asincrónica. Use checkOperationStatus para supervisar el progreso.

Parámetros requeridos:

• sourcedoclibid: ID de la biblioteca de documentos de origen (unidad)
• sourcefileid: ID del archivo o carpeta de origen que se va a copiar
• destdoclibid: ID de la biblioteca de documentos de destino (drive)
• destfolderid: ID de la carpeta de destino (debe existir)

Parámetros opcionales:

• newfilename: Nuevo nombre para el elemento copiado

checkOperationStatus

Comprueba el estado de una operación asincrónica, como una copia o movimiento, mediante el token de operación devuelto desde la operación original.

Parámetros requeridos:

• operationToken: El token de operación devuelto desde una operación asíncrona como copyFileOrFolder o moveFileOrFolder

subirArchivoDesdeUrl

Carga un archivo desde una URL de SharePoint o OneDrive a una carpeta de destino en una biblioteca de documentos (drive). El archivo se copia de la dirección URL de origen, por lo que el archivo original no cambia.

Parámetros requeridos:

• UrlFuente: URL de la fuente (debe ser una URL válida de SharePoint o OneDrive)
• destinationDocumentLibraryId: ID de la biblioteca de documentos de destino. Utilice me para el OneDrive del usuario

Parámetros opcionales:

• destinationFolderId: ID de la carpeta de destino (por defecto: root)
• Nombre de archivo: Nuevo nombre de archivo; por defecto el nombre original

compartirArchivoOCarpeta

Envía una invitación de uso compartido para conceder permisos de lectura o escritura sobre un archivo o carpeta (DriveItem) en una biblioteca de documentos (drive) especificada.

Parámetros requeridos:

• documentLibraryId: ID de la biblioteca de documentos (unidad)
• archivoOCarpetaId: ID del archivo o carpeta a compartir
• recipientEmails: Conjunto de direcciones de correo electrónico de los destinatarios
• roles: Array de roles: 'read', 'write' (write otorga permisos de lectura y escritura)

Parámetros opcionales:

• Mensaje: Mensaje personalizado para el correo de invitación (por defecto: Aquí está el archivo en el que estamos colaborando.)
• sendInvitation: Si se debe enviar una invitación para compartir (por defecto: true)

establecerEtiquetaDeSensibilidadEnArchivo

Establece la etiqueta de confidencialidad de un archivo de la biblioteca de documentos (unidad) especificada.

Parámetros requeridos:

• documentLibraryId: ID de la biblioteca de documentos (drive)
• Id de archivo: ID del archivo (DriveItem)
• sensitivityLabelId: ID de la etiqueta de sensibilidad, o cadena vacía para eliminarla

Parámetros opcionales:

• Método de asignación: Método de asignación: 'standard', 'privileged', 'auto' o 'unknownFutureValue' (por defecto: 'privileged')
• justificationText: Texto de justificación para fines de auditoría; requerido al degradar o eliminar una etiqueta (por defecto: 'Modificado por MCPServer')

listarListas

Obtiene todas las listas de SharePoint disponibles en un sitio específico. Use para detectar qué listas existen en un sitio.

Parámetros requeridos:

• SiteId: ID del sitio de SharePoint (formato: 'hostname,siteCollectionId,webId')

crearLista

Crea una nueva SharePoint list dentro de un sitio.

Parámetros requeridos:

• SiteId: ID del sitio de SharePoint
• displayName: Nombre de visualización de la nueva lista

Parámetros opcionales:

• Columnas: Colección de columnas como pares clave-valor: [{ Key: 'JobTitle', Value: 'text' }]. Tipos válidos: texto, textoMultilínea, número, booleano, fechaHora, opción, búsqueda, personaOGrupo, hipervínculo, moneda, calculado
• Plantilla: Tipo de plantilla de lista (por defecto: 'genericList'). Opciones: listaGenérica, bibliotecaDocumentos, eventos, tareas, anuncios, contactos, enlaces, encuesta, seguimientoDeProblemas, foroDeDiscusión

eliminarLista

Elimina una lista de SharePoint de un sitio. Elimina todo el contenedor de listas y todos los elementos que contiene. Esta acción no se puede deshacer.

Parámetros requeridos:

• SiteId: ID del sitio de SharePoint
• listId: ID de la lista que se va a eliminar

Parámetros opcionales:

• etag: ETag para control de concurrencia

enviarInvitaciónParaLista

Envía una invitación para compartir para conceder permisos en una lista de SharePoint.

Parámetros requeridos:

• listId: ID de SharePoint list para compartir
• recipientEmails: Lista de direcciones de correo electrónico de los destinatarios
• role: Rol: 'read' (solo ver), 'contribute' (ver, añadir, actualizar, eliminar elementos), 'edit' (edición completa incluyendo estructura de lista)

Parámetros opcionales:

• siteUrl: URL del sitio de SharePoint que contiene la lista
• sendEmail: Si se envía una notificación por correo electrónico (por defecto: true)

listListItems

Obtiene elementos (filas o registros) de una lista específica de SharePoint.

Parámetros requeridos:

• SiteId: ID del sitio de SharePoint
• listId: ID de la SharePoint list

getListItem

Obtiene un solo elemento (fila o registro) de una lista de SharePoint mediante su identificador.

Parámetros requeridos:

• SiteId: ID del sitio de SharePoint
• listId: ID de la SharePoint list
• itemId: ID del elemento específico de la lista

crearElementoLista

Crea un nuevo elemento (fila o registro) en un SharePoint list.

Parámetros requeridos:

• SiteId: ID del sitio de SharePoint
• listId: ID de la SharePoint list
• campos: Pares clave-valor para los valores de campo, como [{ Key: 'Title', Value: 'Software Engineer' }, { Key: 'Department', Value: 'Engineering' }]. Normalmente se requiere el campo 'Título'.

updateListItem

Actualiza un elemento existente (fila o registro) en una lista de SharePoint. Solo se actualizan los campos especificados; Los campos omitidos conservan sus valores.

Parámetros requeridos:

• SiteId: ID del sitio de SharePoint
• listId: ID de la SharePoint list
• itemId: ID del elemento a actualizar
• Campos: Pares clave-valor de campos a actualizar

Parámetros opcionales:

• etag: ETag para control de concurrencia

eliminarElementoDeLista

Elimina un elemento (fila o registro) de una lista de SharePoint.

Parámetros requeridos:

• SiteId: ID del sitio de SharePoint
• listId: ID de la SharePoint list
• itemId: ID del elemento a eliminar

Parámetros opcionales:

• etag: ETag para control de concurrencia

listaColumnas

Obtiene todas las columnas de una lista de SharePoint.

Parámetros requeridos:

• SiteId: ID del sitio de SharePoint
• listId: ID de la SharePoint list

crearColumna

Crea una nueva columna en un SharePoint list. Admite muchos tipos de columna, incluyendo texto, número, opción, fechaHora, booleano, usuario, búsqueda, calculado y más.

Parámetros requeridos:

• SiteId: ID del sitio de SharePoint
• listId: ID de la SharePoint list
• Nombre: Nombre interno de la columna (identificador programático)
• columnType: Tipo de columna: texto, nota, número, entero, booleano, fechaTiempo, opción, multielección, moneda, búsqueda, usuario, URL, calculado, término, multitérmino, ubicación, geolocalización, miniatura, contador, calculado, contentTypeId, archivo, adjunto, guid, elección de resultado, estado de aprobación

Parámetros opcionales:

• columnProperties: Ajustes específicos de tipo (por ejemplo, { "maxLength": 255 } para texto, { "choices": ["A","B","C"] } para elección)
• Descripción: Descripción de la columna
• displayName: Nombre mostrado en la interfaz (por defecto 'nombre')
• required: Hace que la columna sea obligatoria (por defecto: false)
• oculto: Ocultar la columna en las vistas (por defecto: false)

actualizarColumna

Actualiza una columna existente en un SharePoint list.

Parámetros requeridos:

• SiteId: ID del sitio de SharePoint
• listId: ID de la SharePoint list
• columnId: ID de la columna a actualizar

Parámetros opcionales:

• columnType: Tipo columna (necesario al proporcionar 'columnProperties')
• columnProperties: Propiedades específicas de tipo a actualizar
• Descripción: Nueva descripción
• Nombre de visualización: Nuevo nombre de visualización
• oculto: Ocultar o mostrar la columna
• Obligatorio: Haz que la columna sea obligatoria u opcional

eliminarColumna

Elimina una columna de un SharePoint list. Advertencia: Esta acción elimina todos los datos almacenados en esa columna para todos los elementos.

Parámetros requeridos:

• siteId: ID del sitio de SharePoint
• listId: ID de SharePoint list
• columnId: ID de la columna a eliminar

Funciones principales

Administración de sitios

• Buscar sitios por su nombre o explorar sitios accesibles.
• Obtener un sitio por la ruta exacta de la URL.
• Liste sitios infantiles y subsitios.
• Navegación completa de la jerarquía de sitios.

Administración de bibliotecas de documentos

• Enumere todas las bibliotecas de documentos de un sitio.
• Obtenga la biblioteca de documentos predeterminada.
• Explora el contenido de las carpetas (hasta 20 elementos).
• Cree y administre estructuras de carpetas.

Operaciones de archivo

• Crea archivos de texto y binarios (5 MB o menos).
• Lee texto y archivos binarios (5 MB o menos).
• Elimine, cambie el nombre y mueva archivos y carpetas.
• Copiar archivos y carpetas entre bibliotecas de documentos.
• Cargue archivos desde direcciones URL de SharePoint o OneDrive.
• Busque archivos y carpetas en todos los sitios accesibles.
• Obtiene los metadatos de archivo y carpeta.

Operaciones asincrónicas

• Copie y mueva archivos y carpetas de forma asincrónica entre bibliotecas de documentos.
• Compruebe el estado de las operaciones asincrónicas mediante tokens de operación.

Operaciones de lista

• Crear, leer y eliminar listas.
• Compatibilidad con varias plantillas de lista, como la biblioteca de documentos, los eventos y las tareas genéricas.
• Compartir listas con permisos basados en roles.
• Administre los elementos de lista mediante la creación, lectura, actualización y eliminación de ellos.

Administración de columnas

• Cree columnas con una amplia variedad de tipos, como texto, nota, número, booleano, fecha y hora, elección, búsqueda, usuario, URL, calculado y más.
• Actualice las propiedades y los metadatos de la columna.
• Configure los requisitos y la visibilidad de las columnas.
• Establecer propiedades de columna según el tipo.

Uso compartido y permisos

• Compartir archivos, carpetas y listas con usuarios.
• Use el control de acceso basado en roles con roles de lectura, escritura, contribución y edición.
• Notificaciones por correo electrónico para compartir.
• Mensajes personalizados en las invitaciones.

Seguridad y cumplimiento normativo

• Aplicar y eliminar etiquetas de confidencialidad.
• Use varios métodos de asignación, incluidos estándar, con privilegios y automático.
• Compatibilidad con la justificación de auditoría.
• Use el control de simultaneidad con eTags.

Notas

• Las operaciones de archivo se limitan a los archivos de 5 MB o menos para la carga y descarga.
• Las operaciones de copia y movimiento son asincrónicas. Use checkOperationStatus para supervisar el progreso.
• Las operaciones de copia y movimiento admiten operaciones entre bibliotecas dentro de SharePoint.
• uploadFileFromUrlrequiere una URL de origen válida de SharePoint o OneDrive.
• eTags proporcionan control de simultaneidad para las actualizaciones y eliminaciones.
• Sufijo numérico automático para nombres duplicados de carpetas.
• No se puede deshacer la eliminación de listas.
• La eliminación de columnas quita todos los datos almacenados en esa columna.
• Las operaciones de búsqueda devuelven los 20 resultados principales de forma predeterminada.