该功能仅AI尊享版支持，版本差异请参考版本介绍。
调用邮箱MCP的效果和AI智能体基础能力有关，建议对AI智能体做好提示词和知识库的优化。
一、邮箱MCP服务是什么
MCP，全称模型上下文协议（Model Context Protocol），目标是为大语言模型和AI助手提供一个统一、标准化的接口。它的作用就像USB接口一样，使AI能够轻松连接和操作外部工具并完成更复杂的任务。
邮箱现已支持MCP协议，用户可以通过此协议授权AI操作自己的邮箱，并可通过与AI聊天在邮箱中发送邮件，获取需要的邮件信息。
二、邮箱MCP服务包含哪些能力
具体的工具详细描述和参数等信息可以通过MCP的工具查询接口查看。
功能 | 工具名称 | 作用 |
批量更新邮件 | batch_update_emails | 批量标记邮件已读或未读、添加或移除标签；单次最多 100 封，一次执行一种操作。 |
创建日程 | create_calendar_event | 在指定日历创建约会或会议，支持循环日程，并可向参会人发送邮件通知。 |
创建邮件附件上传会话 | create_email_attachment_upload_url | 为草稿邮件创建附件上传会话，返回临时上传地址；客户端上传文件后，附件才会关联到草稿。 |
创建邮件草稿 | create_email_draft | 在草稿箱中创建邮件草稿，保存主题、正文和收件人等信息；创建后不自动发送。 |
转发(草稿) | create_email_forward_draft | 基于原邮件创建转发草稿，可设置转发正文和收件人；后续通过发送草稿接口发出。 |
回复全部(草稿) | create_email_reply_all_draft | 基于原邮件创建回复全部草稿，回复范围包含发件人、原收件人和抄送人；创建后不自动发送。 |
回复(草稿) | create_email_reply_draft | 基于原邮件创建回复草稿，回复发件人；原邮件设置 Reply-To 时优先回复该地址，创建后不自动发送。 |
创建邮件文件夹 | create_mail_folder | 创建邮件文件夹，可通过父文件夹 ID 指定创建位置。 |
批量删除邮件 | delete_emails | 按邮件 ID 批量删除邮件，单次最多 100 封。 |
删除邮件文件夹 | delete_mail_folder | 按文件夹 ID 删除邮件文件夹，仅支持删除空文件夹。 |
获取日程详情 | get_calendar_event | 按用户邮箱、日历 ID 和日程 ID 获取日程的详细信息。 |
获取邮件详情 | get_email | 按邮件 ID 获取邮件详情；默认返回基本字段，可通过 $select 获取正文、收件人等扩展信息。 |
获取邮件附件下载地址 | get_email_attachment_download_url | 为指定邮件附件获取临时下载地址，供客户端后续下载附件文件。 |
获取会话 | get_email_conversation | 获取邮件会话的主题、摘要、邮件数和已读状态等概览；当前不返回会话内的邮件明细。 |
查询时间范围内的日程 | list_calendar_view | 查询指定日历在时间范围内的日程，并将循环日程展开为单次日程；支持游标分页。 |
查询日历列表 | list_calendars | 查询用户可访问的日历列表，包括自建日历及接受共享后生成的日历。 |
查询邮件附件列表 | list_email_attachments | 按邮件 ID 查询邮件的全部附件，获取附件 ID 等信息。 |
列出会话 | list_email_conversations | 按文件夹分页列出邮件会话，支持时间范围与时间排序，单次最多 100 条。 |
查询邮件文件夹列表 | list_mail_folders | 查询顶层或指定父文件夹下的子文件夹，可选择递归返回全部层级。 |
批量移动邮件 | move_emails | 将邮件批量移动到目标文件夹，单次最多 100 封；目标文件夹不能是草稿箱。 |
搜索邮件 | search_emails | 按主题、正文、发件人、收件人、时间等条件搜索邮件，支持组合查询和分页，单页最多 100 封。 |
搜索用户-关键字 | search_users | 按姓名、昵称、拼音、工号或办公地点等关键词搜索同域用户，获取邮箱地址等信息。 |
发送邮件 | send_email | 按主题、HTML 正文和收件人等信息创建新邮件并立即发送，一次调用完成发信。 |
发送邮件草稿 | send_email_draft | 按草稿邮件 ID 发送草稿箱中的邮件，可指定是否保存到已发送文件夹。 |
更新邮件草稿 | update_email_draft | 修改已有草稿的主题、正文和收件人等信息，仅支持草稿箱中的草稿邮件。 |
更新邮件文件夹名称 | update_mail_folder | 按文件夹 ID 修改邮件文件夹名称。 |
三、如何使用邮箱MCP服务
在邮箱配置MCP服务
步骤 1：进入邮箱设置-AI智能-MCP服务，点击生成Token，输入Token用途，设置过期时间。
步骤 2：复制Token或JSON配置
配置MCP客户端
示例1：在钉钉AI助理配置邮箱MCP
参考钉钉 MCP 技能快速入门中「使用 AI 助理技能模板中 MCP 技能」章节，将邮箱MCP服务JSON配置填入钉钉MCP插件中。
配置完成，检测插件成功后，保存AI助理。
并对话尝试邮箱MCP服务是否生效，例如“帮我看看今天有什么需要处理的邮件”。
示例2：在千问办公配置邮箱MCP
示例3：在阿里云百炼配置邮箱MCP
示例4：在Qoder CN（原通义灵码）插件配置邮箱MCP
两种添加方式，手动添加或配置文件添加。
方式1：手动添加：
远端 MCP URL：
https://qiye.aliyun.com/mcp/streamable/命令：
npx -y mcp-remote https://qiye.aliyun.com/mcp/streamable/ --header "Authorization:Bearer edc7195a19091xxxxxxxxxxxxxxxxxxx15c8c75bab"方式2：配置文件添加
填入邮箱MCP生成的JSON配置。
效果展示
示例5：在悟空配置邮箱MCP
请前往悟空官网下载安装，打开悟空软件。
点击左下角设置。
点击MCP服务，点击添加按钮。
类型选择Streamable HTTP，输入自定义名称、URL（https://qiye.aliyun.com/mcp/streamable/）、HTTP Headers（key：Authorization，值：Bearer acd61799xxxxxxxxxxxxxxxxxxx86），最后点击添加。
Bearer 后面的token值，请参考上文从阿里邮箱MCP设置里生成，填写格式为"Authorization: Bearer xxx"。
等待MCP连接成功。
效果展示
连接成功后，就可以通过聊天窗口对悟空发起MCP邮箱操作。
常见问题
错误信息1：
failed to initialize MCP client for alimail: [35244] Warning: ignoring invalid header argument: "Authorization: [35244] Using automatically selected callback port: 30785 [35244] [35244] Connecting to remote server: https://qiye.aliyun.com/mcp/streamable/ [35244] Using transport strategy: http-first Could not load OAuth Protected Resource metadata, falling back to /.well-known/oauth-authorization-server Error: Resource server does not implement OAuth 2.0 Protected Resource Metadata.
错误信息2：
Could not load OAuth Protected Resource metadata, falling back to /.well-known/oauth-authorization-server Error: Resource server does not implement OAuth 2.0 Protected Resource Metadata.
原因可能是命令拼接不正确，不同的AI工具对MCP支持格式有少许不同，比如是否带引号。
如：
Windows命令行：token需要带有引号
npx -y mcp-remote@latest https://qiye.aliyun.com/mcp/streamable/ --header "Authorization: Bearer <token>"
通义灵码：界面配置token不需要引号
阿里云百炼提示：
请确认JSON配置是否正确，请尝试重新从阿里邮箱生成或复制JSON值。