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

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

Microsoft Planner + Gemini

Пусть ваш ИИ работает с Microsoft Planner: видит ваши задачи во всех планах, просматривает планы и сегменты команды, создаёт и назначает задачи, обновляет ход выполнения, сроки и контрольные списки. Рабочие или учебные учётные записи Microsoft 365 через Microsoft Graph.

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

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

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: не для этого коннектора. Planner не поддерживает личные учётные записи Microsoft, поэтому consumers не работает, а с common коннектором смогут пользоваться только рабочие или учебные учётные записи.

   Если значение не соответствует типу учётных записей, 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 и Tasks.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_planner_list_my_tasks: инструмент показывает задачи, назначенные вам во всех ваших планах.

Одно приложение 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 для организации. После этого авторизоваться может любой пользователь. Каждый коннектор всё равно работает только с тем, что может видеть учётная запись, которая выполнила вход.

Нужна рабочая или учебная учётная запись: Planner входит в Microsoft 365 для организаций. У личных учётных записей Microsoft, например Outlook.com, нет Planner, и они получают ошибку 403 или 400. ИИ видит только планы групп Microsoft 365 и команд, в которых вы состоите.

Разрешения: Planner нужно только Tasks.ReadWrite, и само по себе оно не требует администратора. Group.Read.All или Group.ReadWrite.All тоже подошли бы, но им нужно согласие администратора, поэтому коннектор их не запрашивает. Коннектор Microsoft To Do использует то же разрешение Tasks.ReadWrite.

Только чтение: замените scopes в настройках OAuth коннектора на offline_access User.Read Tasks.Read, авторизуйтесь заново и отключите microsoft_planner_create_task, microsoft_planner_update_task, microsoft_planner_update_task_details и microsoft_planner_create_bucket.

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

Выключен при установке: microsoft_planner_delete_task. Удаление убирает задачу у всей команды, и коннектор не может его отменить, поэтому включайте инструмент, только если ИИ действительно должен удалять задачи.

Планы, сегменты и назначения: планы команды находятся в её группе Microsoft 365. ИИ находит группу, затем план, его сегменты (столбцы доски) и задачи. Ход выполнения бывает 0 (не начато), 50 (выполняется) или 100 (завершено), приоритет: срочный, важный, средний или низкий. Описание, контрольный список и ссылки хранятся в сведениях задачи. Чтобы назначить задачу, ИИ нужен идентификатор пользователя: ваш он берёт из microsoft_planner_get_me, а идентификатор коллеги из задачи, которая уже ему назначена, потому что коннектор не умеет искать людей по имени. При каждом изменении Planner проверяет метку версии; если кто-то успел изменить задачу, ИИ читает её заново и повторяет попытку.

Частые ошибки: 401 InvalidAuthenticationToken означает, что авторизация отозвана или истёк client secret; при необходимости вставьте новый секрет и снова нажмите Authorize with Provider. 403 означает, что не хватает Tasks.ReadWrite или на него не дано согласие, вы не состоите в группе плана, достигнут лимит плана (например, слишком много задач или сегментов) или это личная учётная запись Microsoft. 404 означает, что идентификатор неверный или элемент удалён. 409 или 412 означает, что элемент успели изменить: ИИ читает его заново и повторяет попытку. 400 означает, что значение имеет неверный формат, например сегмент из другого плана или дата без часового пояса. 429 означает, что Microsoft Graph ограничивает запросы этой учётной записи: подождите немного и повторите попытку.

Коннектор не создаёт и не удаляет планы, не читает комментарии к задачам (они хранятся в беседах группы), не загружает вложения, не открывает премиум-планы Planner и не ищет людей в каталоге.

Шаг 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 теперь может вызывать инструменты Microsoft Planner.

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

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

• «Какие задачи в Planner назначены мне и какие из них просрочены?»
• «Покажи план команды маркетинга: сколько задач в каждом сегменте и какие ещё не закрыты?»
• «Создай задачу «Подготовить стенд для выставки» в сегменте «В работе» плана «Мероприятия», назначь её мне, приоритет «Важный», срок 31 октября.»
• «Добавь к этой задаче контрольный список: «Заказать флаеры», «Заказать уборку стенда», «Напечатать бейджи», и переведи её в статус «Выполняется».»

FAQ

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

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

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