SharePoint Embedded Samples MCP
MCP-сервер из папки AI/mcp-server отдает агенту около 60 инструментов для контейнеров, файлов и прав в SharePoint Embedded.
- 108 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Сервер удаляет контейнеры, меняет права и перезаписывает файлы с правами приложения Microsoft Entra.
Установка
- Работает в
Ручная установка
Клонируй репозиторий, перейди в `AI/mcp-server`, заполни `.env` по `.env.example`, выполни `npm install` и `npm run dev`, затем подключи `http://localhost:3000/mcp` как MCP-сервер и вызови `/health`.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Сервер удаляет контейнеры, меняет права и перезаписывает файлы с правами приложения Microsoft Entra.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Репозиторий Microsoft собирает примеры для SharePoint Embedded, хранилища документов на базе Microsoft 365. Для агента в нем нужна папка `AI/mcp-server`: MCP-сервер на Node.js, который работает через Microsoft Graph API и открывает около 60 инструментов в четырех областях. Контейнеры: создание, список, блокировка, восстановление, права, свойства и корзина. Диски: метаданные, обзор по путям и отслеживание изменений. Файлы и папки: загрузка, скачивание, перенос, копирование, поиск, версии и ссылки на предпросмотр. Права на файлы и папки: выдача, изменение и отзыв. Сервер запускается локально либо разворачивается в Azure Container Apps скриптом `deploy.sh`.
Для кого. Разработчикам приложений на SharePoint Embedded, которые управляют контейнерами и файлами из Claude, Cursor или GitHub Copilot.
Подходит, если
- Агент создает контейнер и загружает в него тестовые документы для нового приложения.
- Из контейнера выгружают файлы и версии для разбора ошибок.
- После смены схемы доступа агент выдает и отзывает права на папки.
- Для интерфейса нужна заготовка: в репозитории лежат шаблоны на React, TypeScript и ASP.NET Core.
Не подходит, если
- Нет подписки Azure и регистрации приложения в Entra ID.
- Нужны обычные библиотеки SharePoint Online без SharePoint Embedded.
- Сервер собираются открыть в сеть без защиты: инструменты умеют удалять контейнеры.
Пример запроса к агенту
Создай контейнер, загрузи в него три файла и покажи список версий одного из них.MCP
- Транспорт
- http
- Авторизация
- API-ключ
Переменные окружения
TENANT_IDобязательная- Идентификатор каталога Entra ID
APP_IDобязательная- Идентификатор клиента зарегистрированного приложения
CLIENT_SECRETобязательная, секрет- Секрет клиента приложения
CONTAINER_TYPE_IDобязательная- Идентификатор типа контейнера SharePoint Embedded
Ограничения
Для запуска нужны подписка Azure, регистрация приложения в Entra ID, тип контейнера SharePoint Embedded, Azure CLI и Node.js 22 или новее. Приложению выдают разрешения `FileStorageContainer.Selected` и `Files.ReadWrite.All` с согласием администратора, а секрет клиента хранят в `.env` и не коммитят. Сервер действует правами приложения: инструменты удаляют контейнеры и меняют доступ. Остальные примеры репозитория — это учебные заготовки для разработчиков, а не готовые продукты.
Как отключить. Удалите запись сервера из настроек MCP-клиента, остановите `npm run dev` и удалите развернутое приложение в Azure. Секрет клиента отзовите в Entra ID.
Частые вопросы
Какой адрес у сервера?
Локально это `http://localhost:3000/mcp`. После развертывания в Azure скрипт `deploy.sh` печатает адрес Streamable HTTP и устаревший адрес SSE.
Какие клиенты подходят?
В README описаны Lovable, Claude, Cursor и GitHub Copilot. Подойдет любой клиент с поддержкой удаленных MCP-серверов.
Что нужно задать в `.env`?
Идентификаторы `TENANT_ID`, `APP_ID`, `CONTAINER_TYPE_ID` и секрет `CLIENT_SECRET`. Порт `PORT` по умолчанию 3000.
Как проверить, что сервер работает?
Запрос `curl http://localhost:3000/health` возвращает JSON со статусом `ok` и версией сервиса.
Где взять тип контейнера?
Список выводит команда `Get-SPOContainerType` из модуля PowerShell SharePoint Online. Создание описано в руководстве Microsoft по SharePoint Embedded.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыЛокальная база документов для агента: гибридный поиск по смыслу и словам и веб-интерфейс для просмотра и загрузки
ONLYOFFICE DocSpace MCP — комнаты и файлы в агенте
ONLYOFFICE Apps MCP Server
Официальный MCP-сервер ONLYOFFICE: агент управляет комнатами, папками, файлами и правами доступа в DocSpace по OAuth или ключу
MCP-сервер, который превращает PDF, DOCX, XLSX, PPTX, изображения, аудио, веб-страницы и расшифровки YouTube в Markdown
MCP-сервер для создания и правки файлов Excel без установленного Microsoft Office: формулы, форматы, графики, сводные таблицы
PowerPoint MCP Server — презентации на Windows
PowerPoint MCP Server
PowerPoint MCP для Windows: агент открывает установленный PowerPoint, заполняет шаблоны, вставляет формулы LaTeX и графики, добавляет анимацию
Свой MCP-сервер с 130 инструментами для офисного пакета Google: файлы, документы, таблицы, презентации и календарь
Коротко о README
Корневой README разбивает репозиторий на примеры приложений, скрипты проверки, материалы для ИИ, Power Platform и утилиты. Для агента важен каталог `AI`.