Подключить OneDrive MCP к Microsoft Copilot

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

Microsoft OneDrive + Microsoft Copilot

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

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

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

MICROSOFT_CLIENT_ID, MICROSOFT_CLIENT_SECRET, MICROSOFT_TENANT_ID

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

1. Откройте центр администрирования Microsoft Entra (entra.microsoft.com) или портал Azure и перейдите в 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 и введите https://cloud.anythingmcp.com/api/mcp-oauth/callback. Если вы размещаете AnythingMCP сами, введите вместо этого https://your-anythingmcp-host/api/mcp-oauth/callback. URI должен совпадать символ в символ, иначе Microsoft ответит AADSTS50011.

4. Откройте API permissions → Add a permission → Microsoft Graph → Delegated permissions и добавьте offline_access, User.Read и Files.ReadWrite. offline_access нужен, чтобы Microsoft выдал refresh-токен; без него коннектор перестанет работать через час после авторизации.

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

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

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

8. Начните с onedrive_get_drive: инструмент показывает, в какой OneDrive выполнен вход и сколько места в нём осталось.

Одно приложение Entra для всех коннекторов Microsoft: регистрация приложения, которую вы создали для коннектора Outlook, SharePoint или Excel, подходит и здесь. Откройте её, добавьте разрешение из шага 4 в разделе API permissions, оставьте тот же redirect URI и используйте тот же идентификатор приложения (client ID), тот же секрет и то же значение клиента (tenant). При авторизации каждый коннектор запрашивает только свои разрешения:

• Outlook: Mail.ReadWrite, Mail.Send, Calendars.ReadWrite
• OneDrive: Files.ReadWrite
• Excel: Files.ReadWrite (плюс Files.ReadWrite.All для книг в SharePoint или книг, которыми с вами поделились)
• SharePoint: Sites.ReadWrite.All и Files.ReadWrite.All

Всем им также нужны offline_access и User.Read.

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

Файлы, которыми с вами поделились: Files.ReadWrite охватывает ваш собственный OneDrive. Чтобы открывать файлы, которыми с вами поделились другие люди, добавьте Files.ReadWrite.All в регистрацию приложения, замените им Files.ReadWrite в настройках OAuth коннектора и авторизуйтесь заново.

Только чтение: замените scopes в настройках OAuth коннектора на offline_access User.Read Files.Read (или Files.Read.All), авторизуйтесь заново и отключите onedrive_create_folder, onedrive_upload_text_file, onedrive_replace_file_content, onedrive_copy_item, onedrive_rename_item и onedrive_move_item.

Выключены при установке: onedrive_delete_item, onedrive_create_sharing_link и onedrive_invite. Ссылки общего доступа и приглашения выключены намеренно: они открывают другим людям доступ к вашим файлам, а документ, который читает ИИ, может содержать текст с просьбой чем-то поделиться. Включайте инструмент, только если он действительно нужен ИИ. Удалённые элементы попадают в корзину OneDrive, и их можно оттуда восстановить.

Файлы и содержимое: коннектор выводит списки файлов, ищет их и показывает сведения о них, но не скачивает: вместо этого ИИ даёт вам ссылку на файл. Он может создавать текстовые файлы (.txt, .md, .csv, .json, .html, .xml) размером примерно до 4 МБ и перезаписывать их; OneDrive сохраняет прежнее содержимое в журнале версий файла. Для работы с ячейками книг Excel используйте коннектор Microsoft Excel.

Частые ошибки: 401 InvalidAuthenticationToken означает, что авторизация отозвана или истёк client secret; при необходимости вставьте новый секрет и снова нажмите Authorize with Provider. 403 accessDenied означает, что не хватает разрешения из шага 4 или на него не дано согласие либо вам нельзя изменять этот элемент. 404 itemNotFound означает, что идентификатор или путь неверный, элемент удалён или находится в чужом хранилище. 409 nameAlreadyExists означает, что в папке уже есть элемент с таким именем. 423 resourceLocked означает, что файл открыт для редактирования или извлечён (checked out).

Коннектор не скачивает содержимое файлов, не загружает двоичные файлы и файлы больше 4 МБ, не восстанавливает версии, не очищает корзину и не открывает OneDrive других пользователей и библиотеки 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 — Добавьте коннектор в Microsoft Copilot

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

Microsoft Copilot использует MCP-серверы через агентов, созданных в Copilot Studio: ты добавляешь AnythingMCP в агента как инструмент, а затем публикуешь агента в Microsoft 365 Copilot и Teams. Copilot Studio подключается из облака Microsoft по Streamable HTTP, который AnythingMCP поддерживает.

1. В Copilot Studio открой своего агента (или создай нового), перейди в Tools и выбери Add a tool → New tool → Model Context Protocol.
2. Укажи Server name (например, AnythingMCP), Server description, которое объясняет, что делает коннектор, и Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. По описанию Copilot Studio решает, когда вызывать сервер.
3. В аутентификации выбери API key, установи Type в Header, укажи имя заголовка X-API-Key и нажми Create.
4. В окне Add tool выбери Create a new connection, вставь MCP API-ключ из AnythingMCP (MCP Servers → твой сервер → API keys) и нажми Add to agent.
5. Проверь в панели Test агента: попроси о том, для чего нужны инструменты Microsoft OneDrive.
6. Нажми Publish, затем Channels → Microsoft 365 and Microsoft Teams, оставь включённым Make agent available in Microsoft Copilot и нажми Add channel. See agent in Teams установит агента для тебя; в Microsoft 365 Copilot введи @ и выбери агента.

Хочешь, чтобы каждый входил под своей учётной записью? Вместо API-ключа выбери OAuth 2.0 → Dynamic discovery: каждый пользователь войдёт в AnythingMCP при первом вызове агентом.

Размещаешь сам? Используй публичный HTTPS-адрес своего экземпляра вместо https://cloud.anythingmcp.com. Copilot Studio подключается из облака Microsoft, поэтому localhost не подойдёт.

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

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

• «Что лежит в моей папке «Документы/Отчёты 2026» и какие файлы изменились на этой неделе?»
• «Найди файлы о выставке в Гамбурге, включая те, которыми со мной поделились коллеги.»
• «Создай папку «Планирование Q4» и сохрани в ней эти заметки со встречи как notes.md.»
• «У кого есть доступ к папке «Договоры» и есть ли у неё ссылки общего доступа?»

FAQ

Для какого Copilot это руководство? Для Microsoft 365 Copilot на работе — через агентов Copilot Studio. В приложении Microsoft Copilot для личных аккаунтов добавить свой MCP-сервер нельзя.

Что нужно? Рабочий аккаунт с доступом к Copilot Studio (лицензия или пробная версия), чтобы создать агента. Тем, кто будет пользоваться им в Microsoft 365 Copilot или Teams, нужен доступ к агенту: поделись им или попроси администратора опубликовать его для организации. Если в организации действуют политики данных для коннекторов Power Platform, они распространяются и на MCP-серверы.

Агент не вызывает инструменты. Проверь, что имя заголовка — ровно X-API-Key, а ключ относится к тому же MCP-серверу, что и URL, и сделай Server description конкретным: по нему Copilot Studio решает, когда вызывать сервер. После каждого изменения опубликуй агента заново; в открытом чате введи «start over», чтобы перейти на новую версию.

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

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