Listas de SharePoint herramientas MCP Server Reference

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

Herramientas disponibles

sharepoint_createList

Creación de una lista nueva 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 lista como plantilla (por ejemplo, genericList, documentLibrary, issueTracking)

sharepoint_createListColumn

Crea una nueva columna (columnDefinition) en una lista específica de SharePoint. Debes proporcionar el siteId y listID destino, además de una definición válida de columna que especifique el nombre de la columna, nombre de visualización y exactamente un tipo de columna (como texto, número, elección, dateTime, personOrGroupbú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 para mostrar orientado al 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: Configuración de tipo de columna (se requiere uno)

sharepoint_createListItem

Creación de un elemento nuevo 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

Elimina una que exista columnDefinition de una lista específica de SharePoint. 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

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

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 para mostrar orientado al 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 actualización de tipo de actualizar

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 al sitio (por ejemplo, sitios o marketing)

sharepoint_listListColumns

Definiciones de columnas de lista (columnDefinition recursos) para una lista específica de SharePoint. Requiere siteId y listId. Admite parámetros de OData como $select, $top y $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: OData opcional expand (por ejemplo, campos)
• top: tamaño de página opcional
• filter: expresión de filtro OData opcional
• select: Cláusula select de OData opcional

sharepoint_listLists

Enumerar 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

sharepoint_search

Busca en SharePoint usando la API de búsqueda de Microsoft Graph con entityTypes=["site"].

Parámetros requeridos:

• requests: matriz de objetos searchRequest

Parámetros opcionales:

• entityTypes: debe ser ["site"] para las búsquedas de sitios de SharePoint
• Consulta: Objeto de consulta con cadena de búsqueda de lenguaje de consulta 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_searchSitesByName

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

Parámetros requeridos:

• search: nombre para mostrar o nombre o dirección URL parcial del sitio de SharePoint para buscar

Parámetros opcionales:

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

14. sharepoint_updateListItem

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 concurrencia (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

• Usa $select para elegir propiedades
• Usa $filter para filtrar resultados
• Utiliza $expand para incluir tablas relacionadas
• Usa $orderby para ordenar resultados
• Usa $top para la paginación
• Usa $skiptoken para pasar por grandes conjuntos de resultados

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 selección, desplegable o botones de opción)
• Columnas booleanas
• DateTime Columnas (solo fecha o fecha y hora)
• Columnas de persona o grupo (selecciones simples o múltiples)
• Columna de consulta (consulta otras listas)
• Columnas de hipervínculos o imágenes

Notas

• Todas las operaciones utilizan 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