Note
本文中的功能由 標準線束驅動，該線束使用標準線束所描述的授權服務 人員帳單選項。 學習如何在 Access 標準代理與代理流程中存取標準功能。
Important
這是預覽功能。
- Microsoft 會在正式發行前釋出預覽功能，讓客戶能搶先體驗並提供回饋。
- 預覽功能功能有限，且不適合生產環境使用。
- Microsoft 可能會更改預覽版 MCP 工具名稱和參數。 避免硬編碼的相依關係。 Microsoft 維持情境支援。
- 預覽功能須遵守Microsoft補充使用條款。
Overview
| 伺服器識別碼 | 租戶層級 URL | 顯示名稱 | Description |
|---|---|---|---|
mcp_MailTools |
https://agent365.svc.cloud.microsoft/agents/tenants/{tenantId}/servers/mcp_MailTools |
郵件 | Microsoft Graph 郵件操作工具，包括建立、發送、回覆及管理電子郵件。 |
可用工具
mcp_MailTools_graph_mail_createMessage
建立一封草稿電子郵件。 透過設定 body.body.contentType = "HTML"支援 HTML 。
必要參數：
- 題： 訊息主題
- 收件人： 包含電子郵件地址的收件人陣列
- 身體： 訊息主體包含內容類型（Text/HTML）及內容
選擇性參數：
- preferHtml： HTML 內容設定為 true（真）
- 標題： 可選的額外標頭
mcp_郵件工具_圖形_郵件_刪除訊息
刪除已登入使用者信箱中的訊息。
必要參數：
- ID： 訊息識別碼
選擇性參數：
-
If-Match: 選擇性的
ETag，用於並行控制
mcp_MailTools_graph_mail_getMessage
從已登入使用者的信箱中依 ID 取得訊息。 使用 preferHtml 來請求 HTML 主體。
必要參數：
- ID： 訊息識別碼
選擇性參數：
- 選擇： OData 選擇子句
- 擴展： OData 擴展子句
- preferHtml： 請求 HTML 正文格式
- 標題： 可選的 HTTP 標頭
mcp_MailTools_graph_mail_listSent
在已寄件的郵件中列出訊息。
選擇性參數：
- 篩選器： OData 篩選器
- 搜尋： 搜尋條件
- Orderby： 排序表達式
- 頂： 需歸還物品數量
- 選擇： 要回傳的欄位
mcp_MailTools_graph_mail_reply
回覆現有訊息。 支援透過 preferHtml 或 headers 實現的 HTML。
必要參數：
- ID： 回覆訊息 ID
選擇性參數：
- 註解： 回覆文字
- 訊息： 可選訊息替代
- preferHtml： 啟用 HTML 格式化
- 標題： 可選的 HTTP 標頭
郵件工具_圖形_郵件_全部回覆
請對現有訊息使用「全部回覆」。 支援透過 preferHtml 或 headers 實現的 HTML。
必要參數：
- ID： 回覆全部的訊息 ID
選擇性參數：
- 註解： 回覆文字
- 訊息： 可選訊息替代
- preferHtml： 啟用 HTML 格式化
- 標題： 可選的 HTTP 標頭
mcp_MailTools_graph_mail_searchMessages
使用 Microsoft Graph Search API 搭配關鍵字查詢語言（KQL）風格查詢，搜尋 Outlook 訊息。
必要參數：
-
requests: 包含
entityTypes、query、from、size 參數的搜尋請求陣列
支援搜尋訊息內容、主旨、正文及附件
mcp_MailTools_graph_mail_sendDraft
用 ID 發送已存在的草稿訊息。
必要參數：
- ID： 要發送的草擬訊息 ID
mcp_MailTools_graph_mail_sendMail
以登入使用者身份寄電子郵件。
必要參數：
-
訊息： 具有主旨、
toRecipients和內文的訊息物件 - 題： 電子郵件主題
- 收件人： 主要得獎者
- 內容： 電子郵件正文，包含內容類型（文字/HTML）及內容
選擇性參數：
- cc 收件人： 碳複製收件人
- bcc 受益者： 盲目碳複製收件人
- saveToSentItems： 儲存為已寄件物品（預設：true）
- preferHtml： 強制 HTML 渲染
- 標題： 可選的額外 HTTP 標頭
10. mcp_MailTools_graph_mail_updateMessage
更新訊息的可變屬性，例如主旨、主體和類別。
必要參數：
- ID： 訊息識別碼
選擇性參數：
- 題： 新科目
- 內容： 新訊息主體
- 分類： 訊息類別
- 重要： 低、普通或高
-
If-Match:
ETag用於並行存取控制
重點功能
電子郵件撰寫
- 製作草稿並發送電子郵件
- HTML 與純文字支援
- 收件人、抄送及密件副本收件人
- 豐富格式選項
Email 管理
- 接收、更新及刪除訊息。
- 回覆和全部回覆功能。
- 草稿管理。
- 分類與重要性設定。
搜尋與篩選
- KQL 風格的訊息搜尋。
- OData 查詢支援。
- 在主旨、內文及附件中搜尋。
- 分頁與過濾。
傳送物品
- List已經發送訊息了。
- 可選擇儲存到寄件備份。
- 篩選並搜尋已寄件物品。
Notes
- 所有操作皆使用 Microsoft Graph Mail API。
- HTML 內容需要
contentType = "HTML"在正文中。 -
preferHtml標頭請求 HTML 正文格式。 - 搜尋使用 Microsoft Graph Search API 搭配 KQL 查詢。
- 草稿訊息可以分別建立、更新並傳送。
-
ETag支援更新時的並行控制。