Referencia del servidor MCP de Microsoft 365 SharePoint

Importante

• Esta es una función de vista previa.
• Las características en vista previa no se han diseñado para un uso de producción y pueden tener una funcionalidad restringida. Estas características están sujetas a términos de uso adicionales y están disponibles antes del lanzamiento oficial para que los clientes puedan obtener acceso temprano y brindar comentarios.

Visión general

Id. de servidor	Nombre para mostrar	Descripción
mcp_SharePointRemoteServer	Servidor MCP de Microsoft SharePoint	Servidor MCP 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 ≤5 MB.

Nota:

El servidor MCP de Microsoft SharePoint y OneDrive está en desuso a partir del 13 de marzo de 2026. Si se trata de una conexión existente, todavía se admite. Para configurar nuevas conexiones, use el nuevo servidor MCP de Microsoft SharePoint y el servidor MCP de Microsoft OneDrive.

Herramientas disponibles

encontrarSitio

Busque sitios de SharePoint accesibles para el usuario. Devuelve sitios específicos que coinciden con una consulta de búsqueda o los 20 sitios pertinentes principales si no se proporciona ninguna consulta.

Parámetros opcionales:

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

getSiteByPath

Resuelva un sitio de SharePoint con su nombre de host exacto y la ruta de acceso relativa al servidor. Use solo cuando tenga la estructura completa de la dirección URL del sitio. Use findSite cuando solo se conoce un nombre de sitio.

Parámetros requeridos:

• nombre de host: Nombre de host exacto (por ejemplo, "contoso.sharepoint.com")
• serverRelativePath: Ruta de acceso relativa al servidor (por ejemplo, "sites/Marketing"). La barra diagonal inicial es opcional.

listSubsites

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

Parámetros requeridos:

• siteId: Id. del sitio primario de SharePoint (formato: 'nombre de host,siteCollectionId,webId')

listarBibliotecasDeDocumentosEnSitio

Enumerar bibliotecas de documentos (repositorios) en el sitio de SharePoint especificado.

Parámetros opcionales:

• siteId: Id. del sitio de SharePoint (valor predeterminado: "raíz")

obtenerBibliotecaDeDocumentosPredeterminadaEnSitio

Obtén la biblioteca de documentos (drive) predeterminada en un sitio de SharePoint.

Parámetros opcionales:

• siteId: Id. del sitio de SharePoint (valor predeterminado: "raíz")

getFolderChildren

Enumera los 20 primeros archivos y carpetas (DriveItems) incluidos en una carpeta padre especificada en una biblioteca de documentos (unidad de almacenamiento).

Parámetros requeridos:

• documentLibraryId: Identificador de la biblioteca de documentos (unidad de almacenamiento)

Parámetros opcionales:

• parentFolderId: Identificador de la carpeta primaria (valor predeterminado: '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

Obtén los metadatos de un archivo o carpeta (DriveItem) desde una biblioteca de documentos (drive) especificada en SharePoint.

Parámetros requeridos:

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

getFileOrFolderMetadataByUrl

Obtiene los metadatos de un archivo o carpeta de una dirección URL de uso compartido. Solo se permitirán los usuarios con permisos explícitos existentes para acceder al archivo.

Parámetros requeridos:

• fileOrFolderUrl: Dirección URL del archivo o carpeta. La dirección URL no se canjeará para compartirla con el usuario; ya deben tener acceso explícito

readSmallTextFile

Leer (descargar) un archivo de texto de tamaño inferior a 5 MB desde una biblioteca de documentos específica (unidad).

Parámetros requeridos:

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

readSmallBinaryFile

Lee un archivo binario de tamaño inferior a 5 MB de una biblioteca de documentos específica (unidad). El contenido del archivo se devuelve como una cadena codificada en base64.

Parámetros requeridos:

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

createSmallTextFile

Cree o cargue un archivo de texto de menos de 5 MB en una biblioteca de documentos específica (almacenamiento).

Parámetros requeridos:

• nombre de archivo: Nombre del archivo, incluida la extensión
• contentText: Contenido de texto del archivo
• documentLibraryId: Identificador de la biblioteca de documentos (drive)

Parámetros opcionales:

• parentfolderId: Identificador de la carpeta primaria (valor predeterminado: 'root')

crearArchivoBinarioPequeño

Cree un archivo binario de tamaño inferior a 5 MB codificando su contenido en base64 para una biblioteca de documentos específica.

Parámetros requeridos:

• nombre de archivo: Nombre del archivo, incluida la extensión
• base64Content: Contenido de archivo binario codificado como una cadena base64
• documentLibraryId: Identificador de la biblioteca de documentos (drive)

Parámetros opcionales:

• parentfolderId: Identificador de la carpeta primaria (valor predeterminado: 'root')

crearCarpeta

Creación de una nueva carpeta (DriveItem) dentro de una biblioteca de documentos (drive) especificada. Si existe una carpeta con el mismo nombre, se agrega un sufijo numérico (por ejemplo, NewFolder (1)).

Parámetros requeridos:

• folderName: Nombre de la carpeta
• documentLibraryId: Identificador de la biblioteca de documentos (drive)

Parámetros opcionales:

• parentFolderId: Identificador de la carpeta primaria (valor predeterminado: 'root')

renameFileOrFolder

Cambie 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: Identificador de la biblioteca de documentos (drive)
• fileOrFolderId: Id. del archivo o carpeta para cambiar el nombre
• newFileOrFolderName: Nuevo nombre

Parámetros opcionales:

• etag: ETag para el control de simultaneidad

eliminarArchivoOCarpeta

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

Parámetros requeridos:

• documentLibraryId: Identificador de la biblioteca de documentos (drive)
• fileOrFolderId: Identificador del archivo o carpeta que se va a eliminar

Parámetros opcionales:

• etag: ETag para el control de simultaneidad

moveSmallFile

Mueva un archivo (DriveItem) a otra carpeta dentro de la misma biblioteca de documentos. Solo admite archivos inferiores a 5 MB. No se puede mover entre unidades.

Parámetros requeridos:

• documentLibraryId: Identificador de la biblioteca de documentos (drive)
• fileId: Identificador del archivo que se va a mover
• newParentFolderId: Identificador de la carpeta de destino (debe estar en la misma biblioteca de documentos)

Parámetros opcionales:

• etag: ETag para el control de simultaneidad

copiarArchivoOCarpeta

Copie 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: Identificador de la biblioteca de documentos de origen (disco)
• sourcefileid: Identificador del archivo o carpeta de origen que se va a copiar
• destdoclibid: Identificador de la biblioteca de documentos de destino (drive)
• destfolderid: Identificador de la carpeta de destino (debe existir)

Parámetros opcionales:

• newfilename: Nuevo nombre para el elemento copiado

checkOperationStatus

Compruebe el estado de una operación asincrónica (por ejemplo, una copia) 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 asincrónica, como copyFileOrFolder

subirArchivoDesdeUrl

Cargue 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; no se realizan cambios en el original.

Parámetros requeridos:

• sourceUrl: Dirección URL de origen (debe ser una dirección URL válida de SharePoint o OneDrive)
• destinationDocumentLibraryId: Identificador de la biblioteca de documentos de destino. Usar "me" para OneDrive del usuario

Parámetros opcionales:

• destinationFolderId: Identificador de la carpeta de destino (valor predeterminado: 'root')
• nombre de archivo: Nuevo nombre de archivo; el valor predeterminado es el nombre de archivo original.

compartirArchivoOCarpeta

Envía una invitación para compartir para conceder permisos de lectura y escritura en un archivo o carpeta (DriveItem) dentro de una biblioteca de documentos (unidad) especificada.

Parámetros requeridos:

• documentLibraryId: Identificador de la biblioteca de documentos (drive)
• fileOrFolderId: Identificador del archivo o carpeta que se va a compartir
• recipientEmails: Matriz de direcciones de correo electrónico de destinatarios
• roles: Arreglo de roles: "read", "write" (el rol 'write' otorga permisos de lectura y escritura)

Parámetros opcionales:

• Mensaje: Mensaje personalizado para el correo electrónico de invitación (valor predeterminado: "Este es el archivo en el que estamos colaborando".
• sendInvitation: Si se va a enviar una invitación para compartir (valor predeterminado: true)

establecerEtiquetaDeSensibilidadEnArchivo

Establezca la etiqueta de confidencialidad de un archivo de la biblioteca de documentos (almacenamiento) especificada.

Parámetros requeridos:

• documentLibraryId: Identificador de la biblioteca de documentos (drive)
• fileId: DriveItemId del archivo
• sensitivityLabelId: Identificador de la etiqueta de confidencialidad o cadena vacía que se va a quitar

Parámetros opcionales:

• assignmentMethod: Método de asignación: "standard", "privileged", "auto" o "unknownFutureValue" (valor predeterminado: "privileged")
• justificationText: Texto de justificación para la auditoría; obligatorio al degradar o quitar (valor predeterminado: 'Cambiado por MCPServer')

listarListas

Obtenga 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

Cree una nueva lista de SharePoint dentro de un sitio.

Parámetros requeridos:

• siteId: Id. del sitio de SharePoint
• displayName: Nombre para mostrar de la nueva lista

Parámetros opcionales:

• columnas: Colección de columnas en forma de 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 (valor predeterminado: 'genericList'). Opciones: ListaGenérica, BibliotecaDeDocumentos, Eventos, Tareas, Anuncios, Contactos, Enlaces, Encuesta, SeguimientoDeIncidentes, ForoDeDiscusión

eliminarLista

Eliminar una lista de SharePoint de un sitio. Elimina todo el contenedor de listas y todos los elementos que contiene. No se puede deshacer.

Parámetros requeridos:

• siteId: Id. del sitio de SharePoint
• listId: Identificador de la lista que se va a eliminar

Parámetros opcionales:

• etag: ETag para el control de simultaneidad

enviarInvitaciónParaLista

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

Parámetros requeridos:

• listId: Identificador de la lista de SharePoint que se va a compartir
• recipientEmails: Matriz de direcciones de correo electrónico de destinatarios
• rol: Rol: 'read' (solo vista), 'contribute' (ver, agregar, actualizar, eliminar elementos), 'edit' (edición completa, incluida la estructura de lista)

Parámetros opcionales:

• siteUrl: Dirección URL del sitio de SharePoint que contiene la lista
• sendEmail: Si se debe enviar una notificación por correo electrónico (valor predeterminado: true)

listListItems

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

Parámetros requeridos:

• siteId: Id. del sitio de SharePoint
• listId: Identificador de la lista de SharePoint

getListItem

Obtenga un solo elemento (fila/registro) de una lista de SharePoint por su identificador.

Parámetros requeridos:

• siteId: Id. del sitio de SharePoint
• listId: Identificador de la lista de SharePoint
• itemId: Identificador del elemento de lista específico

crearElementoLista

Cree un nuevo elemento (fila/registro) en una lista de SharePoint.

Parámetros requeridos:

• siteId: Id. del sitio de SharePoint
• listId: Identificador de la lista de SharePoint
• campos: Pares clave-valor para los valores de campo: [{ Key: 'Title', Value: 'Software Engineer' }, { Key: 'Department', Value: 'Engineering' }]. Normalmente, el campo 'Título' es obligatorio

updateListItem

Actualice un elemento existente (fila/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: Identificador de la lista de SharePoint
• itemId: Identificador del elemento que se va a actualizar
• campos: Pares clave-valor de los campos que se van a actualizar

Parámetros opcionales:

• etag: ETag para el control de simultaneidad

eliminarElementoDeLista

Eliminar un elemento (fila/registro) de una lista de SharePoint.

Parámetros requeridos:

• siteId: Id. del sitio de SharePoint
• listId: Identificador de la lista de SharePoint
• itemId: Identificador del elemento que se va a eliminar

Parámetros opcionales:

• etag: ETag para el control de simultaneidad

listaColumnas

Obtener todas las columnas de una lista de SharePoint.

Parámetros requeridos:

• siteId: Id. del sitio de SharePoint
• listId: Identificador de la lista de SharePoint

crearColumna

Cree una nueva columna en una lista de SharePoint. 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: Identificador de la lista de SharePoint
• name: Nombre de columna interno (identificador de programación)
• columnType: Tipo de columna: texto, nota, número, entero, booleano, fechaHora, elección, eleccióneMúltiple, moneda, búsqueda, usuario, url, calculado, término, términoMúltiple, ubicación, geolocalización, miniatura, contador, computado, idTipoContenido, archivo, adjunto, guid, resultadoElección, estadoAprobación

Parámetros opcionales:

• columnProperties: Configuración específica del tipo (por ejemplo, { "maxLength": 255 } para texto, { "choices": ["A","B","C"] } para elección)
• descripción: Descripción de la columna
• displayName: Nombre para mostrar que se muestra en la interfaz de usuario (el valor predeterminado es "name")
• Obligatorio: Haga que la columna sea necesaria (valor predeterminado: false)
• oculto: Ocultar columna de vistas (valor predeterminado: false)

actualizarColumna

Actualice una columna existente en una lista de SharePoint.

Parámetros requeridos:

• siteId: Id. del sitio de SharePoint
• listId: Identificador de la lista de SharePoint
• columnId: Identificador de la columna que se va a actualizar

Parámetros opcionales:

• columnType: Tipo de columna (obligatorio al proporcionar 'columnProperties')
• columnProperties: Propiedades específicas del tipo que se van a actualizar
• descripción: Nueva descripción
• displayName: Nuevo nombre para mostrar
• oculto: Ocultar o mostrar columna
• Obligatorio: Hacer que la columna sea necesaria o opcional

eliminarColumna

Eliminar una columna de una lista de SharePoint. Advertencia: Quita todos los datos almacenados en esa columna para todos los elementos.

Parámetros requeridos:

• siteId: Id. del sitio de SharePoint
• listId: Identificador de la lista de SharePoint
• columnId: Identificador de la columna que se va a eliminar

Características clave

Administración de sitios

• Buscar sitios por nombre o explorar sitios accesibles
• Obtener el sitio por ruta URL exacta
• Enumeración de sitios secundarios y subsitios
• Navegación completa de la jerarquía de sitios

Administración de bibliotecas de documentos

• Enumerar todas las bibliotecas de documentos de un sitio
• Obtener la biblioteca de documentos predeterminada
• Examinar el contenido de la carpeta (hasta 20 elementos)
• Creación y administración de estructuras de carpetas

Operaciones de archivo

• Crear archivos binarios y de texto (≤5MB)
• Leer archivos binarios y de texto (≤5MB)
• Eliminar, cambiar el nombre y mover archivos
• Copia de archivos y carpetas entre bibliotecas de documentos
• Cargar archivos desde direcciones URL de SharePoint o OneDrive
• Buscar archivos y carpetas en todos los sitios accesibles
• Obtención de metadatos de archivo y carpeta

Operaciones asincrónicas

• Copiar archivos y carpetas de forma asincrónica entre bibliotecas de documentos
• Comprobación del 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 (genérica, biblioteca de documentos, eventos, tareas)
• Compartir listas con permisos basados en roles
• Administrar elementos de lista (crear, leer, actualizar, eliminar)

Administración de columnas

• Cree columnas con una amplia variedad de tipos (texto, nota, número, booleano, fechaHora, opción, búsqueda, usuario, url, calculado, y más).
• Actualizar propiedades y metadatos de columna
• Configuración de los requisitos y la visibilidad de las columnas
• Propiedades de columna específicas del tipo

Uso compartido y permisos

• Compartir archivos, carpetas y listas con usuarios
• Control de acceso basado en rol (lectura, escritura, contribución, edición)
• Notificaciones por correo electrónico para compartir
• Mensajes personalizados en invitaciones

Seguridad y cumplimiento

• Aplicar y quitar etiquetas de confidencialidad
• Varios métodos de asignación (estándar, con privilegios, automático)
• Soporte para la justificación de auditoría
• Control de simultaneidad con eTags

Notas

• Las operaciones de archivo se limitan a ≤5MB para la carga y descarga
• Las operaciones de movimiento solo funcionan dentro de la misma biblioteca de documentos
• Las operaciones de copia son asincrónicas; usar checkOperationStatus para supervisar el progreso
• Las operaciones de copia admiten la copia entre bibliotecas dentro de SharePoint
• uploadFileFromUrl requiere una dirección URL de origen válida de SharePoint o OneDrive
• eTags proporcionan control de simultaneidad para actualizaciones y eliminaciones
• Sufijo numérico automático para nombres de carpeta duplicados
• No se puede deshacer la eliminación de una lista
• 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
• Todas las operaciones usan Microsoft Graph API

Nota:

Los nombres y parámetros de las herramientas MCP están sujetos a cambios y se deben evitar las dependencias codificadas de forma rígida. Se mantendrá la compatibilidad con escenarios.