Как подключить PowerPoint (Microsoft 365) к Gemini через MCP

💡 Без установки? Используйте cloud.anythingmcp.com напрямую. Войдите, нажмите Connectors → PowerPoint (Microsoft 365), вставьте учётные данные, создайте MCP API key, и готово. Без Docker, без git clone, без локального сервера.

PowerPoint (Microsoft 365) + Gemini

Дайте ИИ работать с презентациями PowerPoint в OneDrive и SharePoint: находить презентации, читать их свойства, историю версий и права доступа, смотреть миниатюру слайда, получать их в PDF или исходным файлом, создавать новые презентации из шаблона, переименовывать, перемещать, извлекать и возвращать, восстанавливать прежнюю версию. Microsoft 365 через Microsoft Graph, вход вашей учётной записью Microsoft; ссылки общего доступа и удаление отключены при установке.

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

Полные инструкции по настройке встроены в коннектор (видны в магазине при выборе коннектора). Требуемые переменные окружения:

MICROSOFT_CLIENT_ID, MICROSOFT_CLIENT_SECRET, MICROSOFT_TENANT_ID

Шаг 1 — Получите учётные данные

Настройка занимает около 10 минут. Нужна учётная запись Microsoft, в чьём OneDrive или SharePoint лежат презентации, и бесплатная регистрация приложения в Microsoft Entra.

1. Откройте https://entra.microsoft.com (или https://portal.azure.com) и перейдите в Applications → App registrations → New registration.

2. Назовите приложение, например "AnythingMCP Microsoft 365", и выберите Supported account types. От этого выбора зависит значение MICROSOFT_TENANT_ID:

   • Accounts in this organizational directory only (один клиент): Directory (tenant) ID со страницы Overview приложения (GUID) или ваш домен, например contoso.onmicrosoft.com.
   • Accounts in any organizational directory (несколько клиентов): organizations.
   • Accounts in any organizational directory and personal Microsoft accounts: common (рабочие, учебные и личные учётные записи) или consumers (только личные).

   Если значение не соответствует типу учётных записей, Microsoft отклоняет вход с ошибкой AADSTS50194 или AADSTS50020.

3. В разделе Redirect URI выберите платформу Web и укажите <your AnythingMCP URL>/api/mcp-oauth/callback, в AnythingMCP Cloud https://cloud.anythingmcp.com/api/mcp-oauth/callback. Адрес должен совпадать символ в символ, иначе Microsoft ответит AADSTS50011.

4. Откройте API permissions → Add a permission → Microsoft Graph → Delegated permissions и добавьте offline_access, User.Read и Files.ReadWrite. Добавьте также Files.ReadWrite.All, если ИИ должен добираться до презентаций в SharePoint, в Teams или открытых вам другими (см. Области доступа).

5. Откройте Certificates & secrets → New client secret и скопируйте Value секрета, а не Secret ID; оно показывается только один раз. Запишите срок действия: когда секрет истечёт, коннектор перестанет работать, пока вы не вставите новый.

6. Вставьте Application (client) ID в MICROSOFT_CLIENT_ID, значение секрета в MICROSOFT_CLIENT_SECRET и значение клиента из шага 2 в MICROSOFT_TENANT_ID, затем установите коннектор.

7. На странице коннектора нажмите Authorize with Provider и войдите учётной записью, с презентациями которой должен работать ИИ. Refresh token хранится в зашифрованном виде, access token (действует около часа) обновляется автоматически.

8. Вызовите microsoft_powerpoint_get_my_drive: он покажет, к какому OneDrive подключён коннектор.

Одно приложение Entra для всех коннекторов Microsoft: регистрация, созданная для коннектора Outlook, OneDrive или Excel, подходит и здесь. Добавьте разрешения из шага 4, оставьте тот же redirect URI и используйте тот же client ID, секрет и клиент. Каждый коннектор при авторизации запрашивает только свои области доступа.

Согласие администратора: эти делегированные разрешения обычно не требуют администратора, но многие организации отключают согласие пользователей. Если при входе появляется "Need admin approval" (AADSTS65001 или AADSTS90094), администратор клиента один раз открывает регистрацию приложения и нажимает API permissions → Grant admin consent для организации.

Чьи презентации он видит: всё выполняется от имени пользователя, авторизовавшего коннектор, поэтому ИИ видит и меняет ровно то, что может этот пользователь. Рабочие и учебные учётные записи (Microsoft 365) поддерживают все инструменты; личный OneDrive поддерживает поиск, свойства, скачивание, PDF, копирование, переименование и перемещение.

Области доступа: коннектор запрашивает offline_access User.Read Files.ReadWrite. offline_access заставляет Microsoft выдать refresh token, Files.ReadWrite покрывает ваш собственный OneDrive. Для презентаций в библиотеках SharePoint, каналах Teams или открытых вам другими людьми, а также для microsoft_powerpoint_find_presentations добавьте Files.ReadWrite.All в регистрацию приложения, замените им Files.ReadWrite в настройках OAuth коннектора и авторизуйтесь заново. Для режима только чтения используйте offline_access User.Read Files.Read.All, авторизуйтесь заново и отключите microsoft_powerpoint_copy_presentation, microsoft_powerpoint_rename_presentation, microsoft_powerpoint_move_presentation, microsoft_powerpoint_restore_version, microsoft_powerpoint_check_out и microsoft_powerpoint_check_in.

Что он читает: презентации PowerPoint (.pptx, .pptm, .ppsx и старый .ppt). Он находит их по имени и содержимому в вашем OneDrive (microsoft_powerpoint_search_my_presentations, который возвращает и другие типы файлов), по пути вроде Documents/Sales/Pitch 2026.pptx, просматривая папки или везде, где у вас есть доступ (OneDrive, SharePoint, Teams, открытые вам файлы), через Microsoft Search и KQL в microsoft_powerpoint_find_presentations, только для рабочих и учебных учётных записей. Для каждой презентации он читает имя, размер, кто и когда её создал и последним изменил, webUrl, открывающий её в PowerPoint для интернета, состояние извлечения, историю версий и права доступа. Чтобы прочитать содержимое, microsoft_powerpoint_convert_to_pdf просит Microsoft 365 превратить презентацию в PDF, который ИИ может прочитать, по странице на слайд: в Graph нет API, возвращающего текст презентации. microsoft_powerpoint_get_thumbnail возвращает изображение первого слайда, которое ИИ может рассмотреть, а microsoft_powerpoint_list_thumbnails перечисляет доступные размеры. microsoft_powerpoint_download_presentation и microsoft_powerpoint_download_version передают исходный файл или прежнюю версию.

Что он пишет: Graph не умеет писать внутрь презентации, а коннектор не умеет загружать файлы. Новая презентация создаётся копированием шаблона через microsoft_powerpoint_copy_presentation под новым именем; копирование идёт в фоне, и копия появляется в целевой папке через несколько секунд. Кроме того, коннектор переименовывает презентации, перемещает их в пределах того же диска, снова делает текущей прежнюю версию через microsoft_powerpoint_restore_version (заменённое содержимое остаётся в истории, так что это можно отменить; только рабочие и учебные учётные записи), извлекает презентации и возвращает их с комментарием в библиотеках SharePoint, где извлечение обязательно. Редактируете слайды вы сами по webUrl.

Отключены при установке: microsoft_powerpoint_create_sharing_link (ссылка view или edit для anonymous, organization или users) и microsoft_powerpoint_delete_presentation. Ссылка общего доступа отдаёт файл другим людям, а презентация, которую читает ИИ, может попросить его что-то открыть или удалить, поэтому администратор включает их, когда они нужны команде. Удалённые презентации попадают в корзину, откуда их можно восстановить.

Форматы данных: каждый инструмент принимает drive_id и item_id презентации. Поиск и запрос по пути возвращают их как id и parentReference.driveId; в microsoft_powerpoint_find_presentations результаты лежат в hitsContainers[0].hits[], с resource.id и resource.parentReference.driveId. microsoft_powerpoint_list_folder с item_id root показывает верхний уровень диска. Размеры миниатюр: small (96 px в ширину), medium (176 px), large (800 px) или свой размер вроде c1600x900. Идентификаторы версий выглядят как 4.0 и идут от новых к старым. Файлы, включая PDF, прикрепляются до 10 МБ; более крупные описываются, но не прикрепляются, и ИИ вместо этого даёт вам webUrl. Преобразование в PDF работает для файлов .pptx, .ppt, .ppsx, .pps и .odp и не меняет сохранённый файл.

Постраничный вывод и лимиты: ответы списков и поиска содержат @odata.nextLink, пока есть ещё результаты; ИИ вызывает тот же инструмент снова с skip_token, равным значению $skiptoken из этой ссылки. microsoft_powerpoint_find_presentations листает через from и size, а moreResultsAvailable сообщает, есть ли ещё. Microsoft Graph ограничивает запросы на пользователя и на приложение: 429 или 503 с Retry-After означает подождать и повторить. Преобразование большой презентации в PDF может занять несколько секунд.

Частые ошибки: 401 InvalidAuthenticationToken означает, что авторизацию отозвали или истёк секрет клиента: при необходимости вставьте новый секрет и снова нажмите Authorize with Provider. 403 accessDenied означает, что не хватает разрешения или согласия на него, либо презентация принадлежит другому человеку, а в области доступа нет Files.ReadWrite.All; microsoft_powerpoint_find_presentations отвечает 403 без Files.Read.All или Files.ReadWrite.All. 404 itemNotFound значит неверный идентификатор диска, элемента или версии либо удалённый элемент. 406 или 415 при преобразовании в PDF значит, что тип файла не преобразуется или файл защищён паролем. 409 nameAlreadyExists значит, что такое имя в папке уже есть: выберите другое или задайте conflict_behavior равным rename. 423 resourceLocked значит, что файл извлечён другим человеком или заблокирован для редактирования.

Коннектор не загружает файлы PowerPoint, не редактирует слайды, не читает и не добавляет примечания и не управляет сайтами SharePoint (это делает коннектор Microsoft SharePoint).

Шаг 2 — Установите адаптер

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Шаг 3 — Добавьте коннектор в Gemini

URL вашего сервера: в AnythingMCP откройте MCP Servers → сервер, на котором находится этот коннектор, и скопируйте его URL (https://cloud.anythingmcp.com/mcp/…). Используйте его везде, где в этом руководстве указано YOUR_SERVER_ID.

Gemini CLI читает MCP-серверы из ~/.gemini/settings.json (в Windows: %USERPROFILE%\.gemini\settings.json). Добавь:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Создай MCP API-ключ в AnythingMCP в разделе MCP Servers → твой сервер → API keys и вставь его вместо YOUR_MCP_API_KEY.
2. Сохрани файл и перезапусти gemini.
3. Выполни /mcp в Gemini CLI (или gemini mcp list в терминале): anythingmcp должен отображаться как подключённый.
4. Начинай писать промпты: Gemini CLI теперь может вызывать инструменты PowerPoint (Microsoft 365).

Доступные инструменты

Примеры запросов

• «Найди в SharePoint самую свежую презентацию для инвесторов и кратко изложи ключевые цифры по слайдам.»
• «Создай новую презентацию из Templates/Company deck.pptx в папке Sales/2026 и назови её Pitch Acme 2026.pptx.»
• «Покажи титульный слайд Documents/Sales/Pitch 2026.pptx.»
• «Кто менял эту презентацию на прошлой неделе? Покажи историю версий и восстанови версию от понедельника.»
• «У каких презентаций в моём OneDrive есть ссылка на редактирование для всей организации?»

FAQ

Где Gemini CLI ищет MCP-серверы? В ~/.gemini/settings.json для твоего пользователя или в .gemini/settings.json внутри проекта. gemini mcp list показывает каждый сервер и статус подключения.

Следующие шаги

• Страница коннектора
• Подключить к Claude
• Подключить к ChatGPT
• Подключить к Cursor
• Подключить к Meta Muse
• Подключить к Microsoft Copilot