Справочник по серверу MCP средств SharePoint Lists

Это важно

Чтобы получить ранний доступ к Microsoft Agent 365, необходимо быть частью программы предварительного просмотра Фронтир. Frontier напрямую подключает вас к последним инновациям ИИ от Microsoft. Получите практический опыт с прорывными функциями, делитесь своими впечатлениями с продуктовыми командами и помогите сформировать будущее Искусственного интеллекта. Предпросмотры Frontier подчиняются существующим условиям предварительного просмотра в рамках ваших клиентских соглашений. Так как эти функции по-прежнему находятся в разработке, их доступность и возможности могут меняться со временем.

Обзор

Идентификатор сервера	Показать имя	Description
mcp_SharePointListsTools	Microsoft SharePoint Lists MCP Server	Сервер MCP, предоставляющий средства Microsoft Graph SharePoint для списков. Сервер MCP, предоставляющий средства Microsoft Graph SharePoint для списков.

Доступные средства

СозданиеСписка_в_SharePoint

Создайте новый список SharePoint на сайте.

Обязательные параметры

• siteId: Уникальный идентификатор сайта
• displayName: Отображаемое имя списка
• список: Информация о списке, такая как шаблон (например, genericList, documentLibrary, issueTracking)

sharepoint_createListColumn

Создайте новый столбец (columnDefinition) в определенном списке SharePoint. Необходимо указать целевой siteId и идентификатор списка, а также корректное определение столбца, указывающее имя столбца, его отображаемое имя и один единственный тип столбца (например, текст, число, выбор, дата и время, personOrGroup, подстановка, логический тип или гиперссылка или изображение).

Требуемые параметры:

• siteId: Уникальный идентификатор сайта
• listId: Уникальный идентификатор списка
• имя: API/static name of the column (без пробелов, 1–64 символов)

Необязательные параметры

• displayName: Отображаемое имя пользователя
• описание: Описание столбца
• enforceUniqueValues: Если установлено значение true, значения должны быть уникальными
• скрытый: Если значение true, столбец скрыт
• Индексировано: Если истина, значения индексируются
• Обязательно: Если это условие выполнено, необходимо указать значение
• readOnly: Когда true, значения изменить нельзя
• текст, число, выбор, логический, датаВремя, человекИлиГруппа, поиск, гиперссылкаИлиИзображение: Параметры типа столбца (один обязательный)

sharepoint_createListItem

Создайте новый элемент в списке SharePoint.

Требуемые параметры:

• siteId: Уникальный идентификатор сайта
• listId: Уникальный идентификатор списка
• Поля: Значения полей для элемента списка (карта ключа и значения)

sharepoint_deleteListColumn

Удалите существующий столбецDefinition из определенного списка SharePoint. Укажите siteId, listId и columnId. Это действие окончательно удаляет столбец из схемы списка.

Требуемые параметры:

• siteId: Уникальный идентификатор сайта
• listId: Уникальный идентификатор списка
• columnId: Уникальный идентификатор столбца для удаления

sharepoint_deleteListItem

Удаление элемента списка.

Требуемые параметры:

• siteId: Уникальный идентификатор сайта
• listId: Уникальный идентификатор списка
• itemId: Уникальный идентификатор элемента списка

Необязательные параметры

• ifMatch: Необязательный ETag для управления конкурентным доступом (например, "*")

sharepoint_editListColumn

Обновите определение существующего столбца в списке SharePoint. Укажите siteId, listId и columnId. Тело является частичным — включайте только те свойства, которые необходимо изменить (такие как displayName, description, hidden, required или настройки фасет).

Требуемые параметры:

• siteId: Уникальный идентификатор сайта
• listId: Уникальный идентификатор списка
• columnId: Уникальный идентификатор столбца для обновления

Необязательные параметры

• displayName: Отображаемое имя пользователя
• описание: Описание столбца
• скрытый: Если значение true, столбец скрыт
• Обязательно: Если это условие выполнено, необходимо указать значение
• enforceUniqueValues: Если установлено значение true, значения должны быть уникальными
• Индексировано: Если истина, значения индексируются
• readOnly: Когда true, значения изменить нельзя
• text, number, choice, dateTime, personOrGroup, lookup, гиперссылка или изображение: Обновление параметров типа столбца

sharepoint_getSiteByPath

Определите сайт SharePoint, используя его имя узла и относительный путь на сервере.

Требуемые параметры:

• имя узла: Имя узла клиента SharePoint (например, contoso.sharepoint.com)
• serverRelativePath: Относительный путь к сайту (например, sites/Marketing)

sharepoint_listListColumns

Перечисление определений столбцов (ресурсов columnDefinition) для конкретного списка SharePoint. Требуется siteId и listId. Поддерживает такие парамы OData, как $select, $top и $skiptoken.

Требуемые параметры:

• siteId: Уникальный идентификатор сайта
• listId: Уникальный идентификатор списка

Необязательные параметры

• выберите: Разделённый запятыми список свойств для возврата
• фильтр: Выражение фильтра OData для ограничения результатов
• orderBy: Разделенный запятыми список свойств для упорядочивания по
• Вверх: Размер страницы (1–999)
• skiptoken: Непрозрачный маркер для перехода к следующему набору страниц

sharepoint_listListItems

Список элементов из списка SharePoint.

Требуемые параметры:

• siteId: Уникальный идентификатор сайта
• listId: Уникальный идентификатор списка

Необязательные параметры

• расширение: Необязательное использование параметра расширения OData (например, поля)
• Вверх: Необязательный размер страницы
• фильтр: Необязательное выражение фильтра OData
• select: Необязательное выражение OData select

sharepoint_listLists

Список всех списков SharePoint на сайте.

Требуемые параметры:

• siteId: Уникальный идентификатор сайта

sharepoint_listSubsites

Вывод списка дочерних сайтов (подсайтов) для данного сайта.

Требуемые параметры:

• siteId: Уникальный идентификатор сайта

ШареПойнт_поиск

Поиск в SharePoint с использованием API поиска Microsoft Graph и заданным параметром entityTypes=["site"].

Требуемые параметры:

• Запросы: Массив объектов searchRequest

Необязательные параметры

• entityTypes: Должно быть ["site"] для поиска на сайте SharePoint
• запрос: Объект запроса со строкой поиска в стиле KQL
• От: Отсчитываемый от нуля смещение первого результата
• размер: Количество возвращаемых результатов (1–50)
• Поля: Необязательный список полей для выбора в ответе

13. sharepoint_searchSitesByName

Поиск сайтов SharePoint по отображаемого имени или частичному URL-адресу (естественному языку).

Требуемые параметры:

• искать: Отображаемое имя или частичное имя или URL-адрес сайта SharePoint для поиска

Необязательные параметры

• consistencyLevel: Требуется Microsoft Graph (по умолчанию: в конечном итоге)

14. sharepoint_updateListItem

Обновите поля существующего элемента списка.

Требуемые параметры:

• siteId: Уникальный идентификатор сайта
• listId: Уникальный идентификатор списка
• itemId: Уникальный идентификатор элемента списка
• Поля: Значения полей для обновления (частично)

Необязательные параметры

• ifMatch: Необязательный ETag для элемента управления параллелизмом (например, "*" для принудительного выполнения)

Ключевые функции

Управление списками

• Создание списков SharePoint с помощью шаблонов
• Вывод списка всех списков на сайте
• Поддержка различных шаблонов списков (genericList, documentLibrary, issueTracking)

Операции с столбцами

• Создание столбцов с несколькими типами данных (текст, число, выбор, датаВремя, человекИлиГруппа, поиск, булево, гиперссылкаИлиИзображение)
• Изменение существующих столбцов
• Удаление столбцов
• Перечислите все столбцы в списке
• Ограничения проверки и уникальности столбцов

Операции с элементами

• Создание элементов списка со значениями полей
• Обновление существующих элементов списка (частичные обновления)
• Удаление элементов списка
• Список элементов с фильтрацией и разбивкой на страницы
• Управление параллелизмом с помощью ETag

Обнаружение сайтов

• Поиск сайтов по имени или URL-адресу
• Определение сайтов по имени хоста и пути
• Перечисление дочерних сайтов
• Поиск в стиле KQL с помощью API поиска Microsoft Graph

Поддержка запросов OData

• Используйте $select для выбора свойств.
• Используйте $filter для фильтрации результатов.
• Используйте $expand для включения связанных сущностей.
• Используйте $orderby для сортировки результатов.
• Используйте $top для разбиения на страницы.
• Используйте $skiptoken для постраничного просмотра больших наборов результатов.

Поддержка типов столбцов

• Текстовые столбцы (однострочный или многострочный, обычный или форматированный текст).
• Числовые столбцы (с десятичными знаками, минимальными и максимальными значениями).
• Столбцы выбора (флажки, раскрывающийся список или переключатели).
• Логические столбцы.
• Столбцы DateTime (только дата или дата и время).
• Столбцы 'Человек' или 'Группа' (одиночный или множественный выбор).
• Столбцы поиска (ссылка на другие списки).
• Гиперссылка или столбец изображения.

Примечания.

1. Все операции используют API Microsoft Graph версии 1.0.
2. Имена столбцов должны быть 1–64 символами без пробелов.
3. Каждый столбец должен указывать ровно один тип столбца.
4. Управление параллелизмом доступно через заголовок If-Match.
5. Для поиска на сайте требуется consistencyLevel задать значение eventual.
6. Результаты поиска ограничены 50 элементами на страницу.
7. Частичные обновления поддерживаются для столбцов и элементов списка.