Использование сервера MCP для создания приложений с помощью агента программирования

Применимо к: Разработчик

Сервер SHAREPoint Embedded MCP — это сервер контекстного протокола модели с открытым кодом, который позволяет клиентам ИИ, совместимым с MCP, настраивать приложения SharePoint Embedded и управлять ими с помощью естественного языка. Поддерживаемые клиенты включают GitHub Copilot в Visual Studio Code или CLI, Claude Desktop, Cursor и Azure AI Foundry. Он распространяется как @microsoft/spe-mcp пакет npm и выполняется локально на компьютере в качестве средства разработчика.

Вместо того, чтобы щелкать порталы и сшивать Microsoft Graph и Azure команды CLI вручную, вы описываете, что вам нужно— "создать пробный тип контейнера для моего приложения", а клиент ИИ вызывает средства сервера для этого.

Примечание.

Сервер SharePoint Embedded MCP — это средство разработчика с открытым исходным кодом, выпущенное в предварительной версии. Его исходный код, полный справочник по инструментам и средство отслеживания проблем хранятся в репозитории microsoft/SharePoint-Embedded-MCP-Server на GitHub.

Важно!

Чтобы начать сборку с SharePoint Embedded, вам потребуется административный доступ к клиенту Microsoft 365.

Если у вас еще нет клиента, вы можете воспользоваться программой разработчика Microsoft 365, Microsoft Customer Digital Experience или бесплатной пробной версией Microsoft 365 E3 лицензии.

Что вы можете сделать с ним

Сервер предоставляет средства, которые клиент ИИ может вызывать от вашего имени, сгруппированные по задачам:

  • Подготовка и состояние. Проверьте удостоверение входа и готовность к подготовке, создайте приложение, владеющее Microsoft Entra ID, а также создайте, зарегистрируйте, перечислите, обновите или удалите типы контейнеров и контейнеры. Один project_provision инструмент может запустить всю последовательность ( тип контейнера приложения → → выставления счетов → регистрации → контейнера ) в одном вызове.
  • Выставление счетов. Выберите подписку Azure и группу Microsoft.Syntex ресурсов, зарегистрируйте поставщика ресурсов, свяжите тип контейнера со стандартным выставлением счетов и проверьте классификацию выставления счетов или срок действия пробной версии.
  • Формирование шаблона, запуск и развертывание. Создайте запускаемое эталонное приложение (React одностраничное приложение с Функции Azure или веб-приложение C#), напишите конфигурацию среды выполнения из состояния подготовки, начального образца содержимого, запустите его локально и разверните в Azure.
  • Операции с содержимым (согласие). После отдельного явного согласия отправьте файлы, создайте папки, выполните поиск, предварительный просмотр, управление общим доступом и разрешениями, а также архивируйте или восстановите контейнеры.
  • Документация. Поиск и получение официальной документации по SharePoint Embedded и Microsoft Graph на основе сервера MCP Microsoft Learn.

Полный список инструментов, флагов ИНТЕРФЕЙСА командной строки и переменных среды с управлением версиями см. в файле README сервера.

Предварительные условия

  • Node.js версии 22 или более поздней.
  • Azure CLI, войдите с помощью az login --allow-no-subscriptions. Флаг --allow-no-subscriptions необходим только для клиентов Microsoft 365, у которых нет Azure подписки.
  • Доступ к клиенту Microsoft 365 и администратору клиента (глобальный администратор или администратор приложений).
  • Клиент, совместимый с MCP, например Visual Studio Code с GitHub Copilot, Claude Desktop или Cursor.

Установка и настройка

Клиенты MCP запускают сервер с npxпомощью , поэтому отдельная глобальная установка отсутствует. Добавьте запись сервера в конфигурацию MCP клиента.

Visual Studio Code

Добавьте запись .vscode/mcp.json сервера MCP в в рабочую область:

{
  "servers": {
    "spe": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@microsoft/spe-mcp", "start"]
    }
  }
}

Флаг -y позволяет Visual Studio Code запустить сервер в неинтерактивном режиме. После регистрации сервера используйте Copilot Chat в режиме агента для вызова его средств.

рабочий стол Claude

Добавьте сервер %APPDATA%\Claude\claude_desktop_config.json в (Windows) или ~/Library/Application Support/Claude/claude_desktop_config.json (macOS):

{
  "mcpServers": {
    "spe": {
      "command": "npx",
      "args": ["-y", "@microsoft/spe-mcp", "start"]
    }
  }
}

Cursor и другие клиенты MCP

Любой клиент, поддерживающий серверы MCP через транспорт stdio, может запустить сервер с помощью той же npx -y @microsoft/spe-mcp start команды. Сведения о регистрации серверов MCP см. в документации клиента.

Выбор способа проверки подлинности сервера

Сервер поддерживает два режима выполнения.

  • Режим начальной загрузки (рекомендуется для начала работы): регистрация приложения не требуется. Сервер использует сеанс интерфейса командной строки Azure для уровня управления и подготавливает Microsoft Entra ID приложение по запросу. Войдите один раз и запустите сервер без идентификатора клиента:

    az login --allow-no-subscriptions

  • Режим предварительно подготовленного приложения. Передайте существующее приложение с общедоступным клиентом Microsoft Entra ID, которое уже имеет делегированные разрешения администратора для FileStorageContainer.Selected, FileStorageContainerType.Manage.Allи FileStorageContainerTypeReg.Manage.All. Укажите идентификатор приложения и идентификатор клиента с помощью SPE_CLIENT_ID переменных среды и SPE_TENANT_ID (или --client-id флагов и --tenant-id ):

    {
  "servers": {
    "spe": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@microsoft/spe-mcp", "start"],
      "env": {
        "SPE_CLIENT_ID": "your-client-id",
        "SPE_TENANT_ID": "your-tenant-id"
      }
    }
  }
}

В режиме начальной загрузки первый вызов SharePoint Embedded открывает браузер для одноразового согласия и кэширует маркер, поэтому отдельный шаг терминала не требуется. Полный каскад проверки подлинности, сведения о хранилище маркеров, а также руководство по безголовой работе и автоматизации см. в разделе Сведения о сервере.

Попробуйте

После регистрации сервера в клиенте и завершения входа в cli Azure попросите клиента ИИ работать с SharePoint Embedded. Например, в Copilot Chat:

  • "Вывод списка типов контейнеров SharePoint Embedded".
  • "Создайте пробный тип контейнера с именем Contoso Docs для идентификатора приложения abc-123".
  • "Подготовьте новое приложение SharePoint Embedded и шаблон React пример".

Клиент вызывает средства сопоставления, запрашивает согласие в первый раз и сообщает результаты.

Управление тем, что может сделать сервер

Сервер содержит элементы управления для ограничения доступных и вызываемых средств, которые удобно использовать, если требуется, чтобы клиент ИИ изучал вашу среду без внесения изменений:

  • Режим только для чтения. Объявляйте и разрешайте только средства чтения, вывода, получения и поиска, а также отклоняйте все изменяющие вызовы. --read-only Задайте флаг или SPE_READ_ONLY переменную среды.
  • Профили инструментов. Ограничьте предоставляемые средства профилем (readOnly, docsOnly, provisioning, contentили admin) или разделенным запятыми списком имен инструментов с помощью флага --tools или переменной SPE_TOOLS среды.

Средства операций с содержимым также находятся за отдельным явным согласием, поэтому клиент ИИ не сможет читать или изменять файлы в контейнерах, пока вы не согласитесь. Сведения о полной модели безопасности см. в разделе Элементы управления безопасностью в репозитории сервера.

Связанные материалы

  • Last updated on