Поделиться через


Справочник по серверу Microsoft Mail MCP

Это важно

Чтобы получить ранний доступ к Microsoft Agent 365, необходимо быть частью программы предварительного просмотра Фронтир. Frontier напрямую подключает вас к последним инновациям ИИ от Microsoft. Получите практический опыт с прорывными функциями, делитесь своими впечатлениями с продуктовыми командами и помогите сформировать будущее Искусственного интеллекта. Предпросмотры Frontier подчиняются существующим условиям предварительного просмотра в рамках ваших клиентских соглашений. Так как эти функции по-прежнему находятся в разработке, их доступность и возможности могут меняться со временем.

Обзор

Идентификатор сервера Показать имя Description
mcp_MailTools Microsoft Outlook Mail MCP Server Сервер MCP, предоставляющий средства Microsoft Graph Mail.

Доступные средства

1. mcp_MailTools_graph_mail_createMessage

Создайте черновик электронной почты. Поддерживает HTML, задав body.body.contentType = HTML.

Требуемые параметры:

  • Тема: Тема сообщения
  • toRecipients: Массив получателей с адресами электронной почты
  • тело сообщения: Тело сообщения с contentType (Text/HTML) и содержимым

Необязательные параметры

  • preferHtml: Задайте значение true для HTML-содержимого
  • Заголовки: Необязательные дополнительные заголовки

mcp_MailTools_graph_mail_deleteMessage

Удалите сообщение из почтового ящика пользователя, вошедшего в систему.

Требуемые параметры:

  • идентификатор: Идентификатор сообщения

Необязательные параметры

  • If-Match: Необязательный ETag для управления параллелизмом

mcp_MailTools_graph_mail_getMessage

Получите сообщение по идентификатору из почтового ящика пользователя, вошедшего в систему. Используйте preferHtml для запроса текста HTML.

Требуемые параметры:

  • идентификатор: Идентификатор сообщения

Необязательные параметры

  • выбирать: Предложение OData select
  • расширение: Клаузула расширения OData
  • preferHtml: Формат текста ЗАПРОСА HTML
  • Заголовки: Необязательные заголовки HTTP

mcp_MailTools_graph_mail_listSent

Просмотр сообщений в папке "Отправленные".

Необязательные параметры

  • фильтр: Фильтр OData
  • искать: Поисковый запрос
  • orderby: Выражение сортировки
  • Максимум: Количество возвращаемых элементов
  • выбор: Поля для возврата

mcp_MailTools_graph_mail_reply

Отправьте ответ существующему сообщению. Поддерживает HTML с помощью preferHtml или headers.

Требуемые параметры:

  • идентификатор: Идентификатор сообщения для ответа

Необязательные параметры

  • комментарий: Текст ответа
  • Сообщение: Переопределение сообщений (необязательно)
  • preferHtml: Включение форматирования HTML
  • Заголовки: Необязательные заголовки HTTP

mcp_MailTools_graph_mail_replyAll

Ответьте всем участникам цепочки сообщений. Поддерживает HTML с помощью preferHtml или headers.

Требуемые параметры:

  • идентификатор: Идентификатор сообщения для ответа всем

Необязательные параметры

  • комментарий: Текст ответа
  • Сообщение: Переопределение сообщений (необязательно)
  • preferHtml: Включение форматирования HTML
  • Заголовки: Необязательные заголовки HTTP

mcp_MailTools_graph_mail_searchMessages

Поиск сообщений Outlook с помощью API поиска Microsoft Graph с помощью запросов в стиле KQL.

Требуемые параметры:

  • Запросы: Массив поисковых запросов с параметрами entityTypes, query, from, size.

Поддерживает поиск содержимого сообщения, темы, текста и вложений

mcp_MailTools_graph_mail_sendDraft

Отправьте один из существующих черновиков сообщения по идентификатору.

Требуемые параметры:

  • идентификатор: Идентификатор черновика сообщения для отправки

mcp_MailTools_graph_mail_sendMail

Отправьте сообщение электронной почты в качестве пользователя, вошедшего в систему.

Требуемые параметры:

  • Сообщение: Объект сообщения с темой, toRecipients и текстом
  • Тема: Тема электронной почты
  • toRecipients: Основные получатели
  • тело: Текст электронной почты с contentType (Text/HTML) и содержимым

Необязательные параметры

  • ccRecipients: Получатели углеродного копирования
  • bccRecipients: Получатели скрытой копии
  • saveToSentItems: Сохранение в Отправленные (по умолчанию: истина)
  • preferHtml: Принудительное отображение HTML
  • Заголовки: Необязательные дополнительные заголовки HTTP

10. mcp_MailTools_graph_mail_updateMessage

Обновите изменяемые свойства сообщения (например, тема, текст, категории).

Требуемые параметры:

  • идентификатор: Идентификатор сообщения

Необязательные параметры

  • Тема: Новая тема
  • тело: Текст нового сообщения
  • Категории: Категории сообщений
  • важность: Низкий, обычный или высокий
  • If-Match: ETag для конкурентного управления

Ключевые особенности

Композиция электронной почты

  • Создание черновика и отправка сообщений электронной почты
  • Поддержка HTML и обычного текста
  • Получатели: Кому, Копия (CC), скрытая копия (BCC)
  • Расширенные параметры форматирования

управление Email

  • Получение, обновление и удаление сообщений
  • Функции ответа и ответа всем
  • Управление черновиками
  • Параметры категории и важности

Поиск и фильтрация

  • Поиск сообщений в стиле KQL
  • Поддержка запросов OData
  • Поиск по теме, тексту, вложениям
  • Разбивка на страницы и фильтрация

Sentitems

  • Список отправленных сообщений
  • Опциональное сохранение в "Отправленные"
  • Фильтрация и поиск отправленных элементов

Примечания.

  1. Все операции используют API почты Microsoft Graph
  2. Для HTML-содержимого требуется contentType = "HTML" в тексте
  3. Запрос заголовка preferHtml на формат HTML тела сообщения.
  4. Поиск использует API поиска Microsoft Graph с запросами KQL
  5. Черновики сообщений можно создавать, обновлять и отправлять отдельно
  6. Поддержка ETag для управления параллелизмом при обновлениях