Microsoft OneNote в MCP: управляйте Microsoft OneNote из любого AI-агента

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

Microsoft OneNote

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

Настройка

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 и Notes.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 и войдите в ту учётную запись, с чьими записными книжками должен работать ИИ. Refresh-токен хранится в зашифрованном виде, access-токены (действуют около часа) обновляются автоматически.

8. Начните с microsoft_onenote_list_notebooks: инструмент показывает записные книжки, которые может открыть коннектор, и вашу роль в каждой (владелец, участник или читатель).

Одно приложение Entra для всех коннекторов Microsoft: регистрация приложения, которую вы создали для коннектора Outlook, OneDrive, 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
• OneNote: Notes.ReadWrite
• Microsoft To Do: Tasks.ReadWrite
• Planner: Tasks.ReadWrite

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

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

Записные книжки, которыми с вами поделились: Notes.ReadWrite охватывает ваши собственные записные книжки. Чтобы работать в записных книжках, которыми с вами поделились коллеги (рабочие или учебные учётные записи), добавьте Notes.ReadWrite.All в регистрацию приложения, замените им Notes.ReadWrite в настройках OAuth коннектора и авторизуйтесь заново.

Только чтение: замените scopes в настройках OAuth коннектора на offline_access User.Read Notes.Read, авторизуйтесь заново и отключите microsoft_onenote_create_notebook, microsoft_onenote_create_section, microsoft_onenote_create_page, microsoft_onenote_append_to_page и microsoft_onenote_update_page.

Изменения ждут вашего «да»: прежде чем создать записную книжку, раздел или страницу или изменить страницу, ИИ сообщает, что и куда он собирается записать, и ждёт вашего подтверждения.

Выключен при установке: microsoft_onenote_delete_page. Коннектор не может отменить удаление, поэтому включайте инструмент, только если ИИ действительно должен удалять страницы.

Поиск и чтение страниц: в записной книжке есть разделы, которые можно объединять в группы разделов, а в каждом разделе есть страницы. ИИ может искать по заголовкам страниц и фильтровать по дате последнего изменения, но Microsoft Graph не ищет по тексту внутри страниц, поэтому ИИ открывает подходящие страницы и читает их. Изображения на странице открываются только с вашим входом, рукописные заметки не передаются, а очень длинные страницы обрезаются примерно на 200 КБ. Если у вас очень много элементов OneNote, список страниц по всем записным книжкам может завершиться ошибкой 10008; тогда ИИ просматривает раздел за разделом.

Запись страниц: новые страницы поддерживают простое форматирование: заголовки, списки, таблицы, ссылки, флажки задач и изображения с общедоступного веб-адреса. Проще всего добавить заметки в конец страницы с помощью microsoft_onenote_append_to_page. Новой странице нужно несколько секунд, прежде чем OneNote начнёт принимать изменения: если дополнение сразу после создания отвечает 404, ИИ немного ждёт и пробует снова.

Частые ошибки: 401 InvalidAuthenticationToken означает, что авторизация отозвана или истёк client secret; при необходимости вставьте новый секрет и снова нажмите Authorize with Provider. 403 (код 40004 или 40002) означает, что не хватает Notes.ReadWrite или на него не дано согласие либо записной книжкой с вами поделились только для чтения. 404 (или код 20102 либо 20112) означает, что идентификатор неверный или элемент удалён. 20117 означает, что записная книжка или раздел с таким именем там уже есть; 20115, 20153 или 20155 означают, что в имени есть недопустимый символ или оно слишком длинное (128 символов для записных книжек, 50 для разделов). 30105 или 30108 означают, что ваш OneDrive для бизнеса ещё не настроен: откройте OneDrive один раз или попросите администратора проверить вашу лицензию. 429 означает, что Microsoft Graph ограничивает запросы этой учётной записи: подождите немного и повторите попытку.

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

Предварительные требования: MICROSOFT_CLIENT_ID, MICROSOFT_CLIENT_SECRET, MICROSOFT_TENANT_ID

Локальная установка коннектора

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

Откройте http://localhost:3000/connectors/store, выберите OneNote (Microsoft 365) и введите переменные, перечисленные в Предварительных требованиях.

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

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

• «Какие записные книжки OneNote у меня есть и какие разделы в записной книжке «Работа»?»
• «Найди мои страницы за последний месяц со словом «бюджет» в заголовке и кратко перескажи, что в них.»
• «Создай в разделе «Встречи» страницу «Старт проекта Acme» с этими заметками и флажком задачи для каждого пункта к выполнению.»
• «Допиши на страницу «Звонок поставщику»: в пятницу уточнить у Анны дату поставки.»

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

• Подключить к Claude
• Подключить к ChatGPT