Как подключить Microsoft OneNote к Claude через MCP

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

Microsoft OneNote + Claude

Пусть ваш ИИ работает в OneNote: просматривает записные книжки, разделы и страницы, читает страницы, создаёт записные книжки, разделы и страницы и добавляет заметки на существующие страницы. OneNote для работы и учёбы и личный OneNote через 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 и 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.

Шаг 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 — Добавьте коннектор в Claude

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

Рекомендуемый путь: работает в claude.ai web без редактирования конфигурационных файлов.

1. Открой в Claude Customize → Connectors.
2. Нажми +, затем Add custom connector.
3. Введи название, например Microsoft OneNote, и URL удалённого MCP-сервера https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID, затем нажми Add.
4. Нажми Connect и войди в AnythingMCP (OAuth), чтобы разрешить доступ.

Все инструменты ниже появятся в чате: начинайте писать промпты.

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

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

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

FAQ

Работает ли с Claude Code так же как с Claude Desktop? Да, оба указывайте на https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID.

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

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