Comparteix a través de


SharePoint listas de herramientas del servidor MCP de referencia

Nota:

Este servidor MCP está en desuso a partir del 13 de marzo de 2026. Use el nuevo SharePoint servidor MCP.

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_SharePointListsTools Microsoft SharePoint listas MCP Server Servidor MCP que proporciona herramientas de Microsoft Graph SharePoint para listas.

Herramientas disponibles

sharepoint_createList

Cree una nueva lista de SharePoint en un sitio.

Parámetros necesarios

  • siteId: el identificador único del sitio
  • displayName: Nombre para mostrar de la lista
  • Lista: Información de la lista, como la plantilla (por ejemplo, genericList, documentLibrary, issueTracking)

sharepoint_createListColumn

Cree una nueva columna (columnDefinition) en una lista de SharePoint específica. Debes proporcionar el siteId y listId destino, además de una definición válida de columna que especifique el nombre de la columna, el nombre para mostrar y exactamente un tipo de columna (como texto, número, opción, dateTime, personOrGroup, búsqueda, booleano o hyperlinkOrPicture).

Parámetros requeridos:

  • siteId: el identificador único del sitio
  • listId: identificador único de la lista
  • name: API/nombre estático de la columna (sin espacios, 1 a 64 caracteres)

Parámetros opcionales:

  • displayName: nombre visible para el usuario
  • description: Descripción de columna
  • enforceUniqueValues: si es true, los valores deben ser únicos
  • hidden: Si es true, la columna está oculta
  • indexed: si es true, los valores se indexan
  • required: si es true, se requiere un valor
  • readOnly: si es true, no se pueden cambiar los valores
  • text, number, choice, boolean, dateTime, personOrGroup, lookup, hyperlinkOrPicture: Configuraciones de tipo de columna (se requiere una)

sharepoint_crearElementoDeLista

Cree un nuevo elemento en una lista de SharePoint.

Parámetros requeridos:

  • siteId: el identificador único del sitio
  • listId: identificador único de la lista
  • fields: valores de campo para el elemento de lista (mapa de clave/valor)

sharepoint_deleteListColumn

Elimine una columnDefinition existente de una lista de SharePoint específica. Proporcionemos siteId, listId, y columnId. Esta acción quita permanentemente la columna del esquema de lista.

Parámetros requeridos:

  • siteId: identificador único del sitio
  • listId: identificador único de la lista
  • columnId: identificador único de la columna que se va a eliminar

sharepoint_deleteListItem

Eliminar un elemento de lista.

Parámetros requeridos:

  • siteId: el identificador único del sitio
  • listId: identificador único de la lista
  • itemId: identificador único del elemento de la lista

Parámetros opcionales:

  • ifMatch: Opcional ETag para el control de concurrencia (por ejemplo, "*")

sharepoint_editListColumn

Actualice una columnDefinition existente en una lista de SharePoint específica. Proporcionemos siteId, listId, y columnId. El cuerpo del mensaje es parcial: incluye solo las propiedades que quieres cambiar (como displayName, descripción, oculto, requerido o configuración de facetas).

Parámetros requeridos:

  • siteId: identificador único del sitio
  • listId: identificador único de la lista
  • columnId: identificador único de la columna que se va a actualizar

Parámetros opcionales:

  • displayName: nombre visible para el usuario
  • description: Descripción de columna
  • hidden: Si es true, la columna está oculta
  • required: si es true, se requiere un valor
  • enforceUniqueValues: si es true, los valores deben ser únicos
  • indexed: si es true, los valores se indexan
  • readOnly: si es true, no se pueden cambiar los valores
  • text, number, choice, dateTime, personOrGroup, lookup, hyperlinkOrPicture: Configuración de tipos de columnas

sharepoint_getSiteByPath

Resuelva un sitio de SharePoint mediante su nombre de host y la ruta de acceso relativa al servidor.

Parámetros requeridos:

  • hostname: Nombre de host del inquilino de SharePoint (por ejemplo, contoso.sharepoint. com)
  • serverRelativePath: Ruta de acceso relativa al servidor del sitio (por ejemplo, sites/Marketing)

sharepoint_listListColumns

Enumerar las definiciones de columna (columnDefinition recursos) para una lista de SharePoint específica. Requiere siteId y listId. Admite parámetros de OData como $select, $topy $skiptoken.

Parámetros requeridos:

  • siteId: el identificador único del sitio
  • listId: identificador único de la lista

Parámetros opcionales:

  • select: lista separada por comas de propiedades que se van a devolver
  • filter: expresión de filtro de OData para restringir los resultados
  • orderBy: lista separada por comas de propiedades que se van a ordenar por
  • top: Tamaño de página (1-999)
  • skiptoken: token opaco para paginar en el siguiente conjunto

sharepoint_listListItems

Enumerar elementos de una lista de SharePoint.

Parámetros requeridos:

  • siteId: el identificador único del sitio
  • listId: identificador único de la lista

Parámetros opcionales:

  • expand: expansión opcional de OData (por ejemplo, campos)
  • top: tamaño de página opcional
  • filter: expresión de filtro OData opcional
  • select: Cláusula opcional de selección de OData

sharepoint_listLists

Enumera todas las listas de SharePoint en un sitio.

Parámetros requeridos:

  • siteId: el identificador único del sitio

sharepoint_listSubsites

Enumerar sitios secundarios (subsitios) para un sitio determinado.

Parámetros requeridos:

  • siteId: el identificador único del sitio

Busque SharePoint mediante Microsoft Graph Search API con entityTypes=["site"].

Parámetros requeridos:

  • requests: matriz de objetos de búsqueda

Parámetros opcionales:

  • entityTypes: Debe ser [site] para las búsquedas de sitios de SharePoint
  • Consulta: Objeto de consulta con cadena de búsqueda en estilo de lenguaje de consultas por palabras clave (KQL)
  • from: desplazamiento basado en cero del primer resultado
  • size: número de resultados que se van a devolver (1-50)
  • fields: lista opcional de campos que se van a seleccionar en la respuesta

sharepoint_buscarSitiosPorNombre

Buscar SharePoint sitios por nombre para mostrar o dirección URL parcial (lenguaje natural).

Parámetros requeridos:

  • search: Nombre para mostrar o nombre parcial o URL del sitio de SharePoint para realizar la búsqueda

Parámetros opcionales:

  • consistencyLevel: Requerido por Microsoft Graph (valor predeterminado: eventual)

14. actualizaciónElementoLista_de_sharepoint

Actualiza los campos de un elemento de lista existente.

Parámetros requeridos:

  • siteId: el identificador único del sitio
  • listId: identificador único de la lista
  • itemId: identificador único del elemento de la lista
  • fields: valores de campo que se van a actualizar (parciales)

Parámetros opcionales:

  • ifMatch: Opcional ETag para el control de simultaneidad (por ejemplo, "*" para forzar)

Características clave

Gestión de listas

  • Crear nuevas listas de SharePoint con plantillas
  • Enumerar todas las listas en un sitio
  • Soporte para varias plantillas de listas (genericList, documentLibrary, issueTracking)

Operaciones de columna

  • Crea columnas con múltiples tipos de datos (texto, número, elección, dateTime, personOrGroup, búsqueda, booleano, hyperlinkOrPicture)
  • Editar columnas existentes
  • Eliminar columnas
  • Enumerar todas las columnas de una lista
  • Restricciones de validación y unicidad de columnas

Operaciones de elemento

  • Crear elementos de lista con valores de campo
  • Actualizar elementos de lista existentes (actualizaciones parciales)
  • Eliminar elementos de lista
  • Enumerar elementos con filtrado y paginación
  • Control de concurrencia mediante ETag

Descubrimiento del yacimiento

  • Buscar sitios por nombre o dirección URL
  • Resolución de sitios por nombre de host y ruta de acceso
  • Enumerar subsitios
  • Búsqueda de estilo KQL con Microsoft Graph Search API

Compatibilidad con consultas de OData

  • Usar $select para elegir propiedades
  • Uso $filter para filtrar los resultados
  • Uso $expand para incluir tablas relacionadas
  • Uso $orderby para ordenar los resultados
  • Uso $top para la paginación
  • Uso $skiptoken para paginar conjuntos de resultados grandes

Soporte de tipos de columna

  • Columnas de texto (de una o varias líneas, texto plano o enriquecido)
  • Columnas numéricas (con decimales, valores mínimos y máximos)
  • Columnas de elección (casillas de verificación, desplegables o botones de radio)
  • Columnas booleanas
  • DateTime Columnas (solo fecha o fecha y hora)
  • Columnas de persona o grupo (selecciones simples o múltiples)
  • Columnas de búsqueda (referencia a otras listas)
  • Columnas de hipervínculos o imágenes

Notas

  • Todas las operaciones usan Microsoft Graph API v1.0
  • Los nombres de las columnas deben tener entre 1 y 64 caracteres sin espacios
  • Cada columna debe especificar exactamente un tipo de columna
  • El control de concurrencia está disponible a través del If-Match encabezado
  • Las búsquedas en sitios requieren consistencyLevel que se establezca en eventual
  • Los resultados de búsqueda están limitados a 50 elementos por página
  • Se soportan actualizaciones parciales para columnas y elementos de lista