Referencia de herramientas de listas del servidor MCP de SharePoint

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	Servidor MCP de Listas de Microsoft SharePoint	Servidor MCP que proporciona herramientas de SharePoint de Microsoft Graph para listas. 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
• list: información de lista como la plantilla (por ejemplo, genericList, documentLibrary, issueTracking)

sharepoint_createListColumn

Crea una nueva columna (columnDefinition) en una lista específica de SharePoint. Debe proporcionar el siteId y listId de destino, además de una definición de columna válida que especifique el nombre, el nombre para mostrar y exactamente un tipo de columna (como text, number, choice, dateTime, personOrGroup, lookup, boolean 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

Elimine una columnDefinition existente de una lista específica de SharePoint. Proporcione 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: ETag opcional para el control de simultaneidad (por ejemplo, "*")

sharepoint_editListColumn

Actualice una columnDefinition existente en una lista específica de SharePoint. Proporcione siteId, listId y columnId. El cuerpo es parcial: incluya solo las propiedades que desea cambiar (como displayName, description, hidden, required o facet settings).

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

Enumerar las definiciones de columna (recursos columnDefinition) 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

Busque SharePoint con 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
• query: Query object with KQL-style search string (Consulta de objeto con cadena de búsqueda de estilo 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

13. 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: ETag opcional para el control de simultaneidad (por ejemplo, "*" para forzar)

Principales características

Administración de listas

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

Operaciones de columna

• Crear columnas con varios tipos de datos (text, number, choice, dateTime, personOrGroup, lookup, boolean, 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 simultaneidad mediante ETag

Detección de sitio

• 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

• Use $select para elegir propiedades.
• Use $filter para filtrar los resultados.
• Use $expand para incluir entidades relacionadas.
• Use $orderby para ordenar los resultados.
• Utilice $top para la paginación.
• Use $skiptoken para paginar conjuntos de resultados grandes.

Tipos de columna admitidos

• Columnas de texto (texto simple o multilínea, sin formato o enriquecido).
• Columnas de número (con posiciones decimales, valores mínimos y máximos).
• Columnas de elección (casillas, lista desplegable o botones de radio).
• Columnas de tipo booleano.
• Columnas DateTime (solo fecha o fecha y hora).
• Columnas de persona o grupo (selección única o múltiple).
• Columnas de búsqueda (haga referencia a otras listas).
• Columnas de hipervínculo o imagen.

Notas

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