一、邮箱MCP服务是什么
MCP,全称模型上下文协议(Model Context Protocol),目标是为大语言模型和AI助手提供一个统一、标准化的接口。它的作用就像USB接口一样,使AI能够轻松连接和操作外部工具并完成更复杂的任务。
邮箱现已支持MCP协议,用户可以通过此协议授权AI操作自己的邮箱,并可通过与AI聊天在邮箱中发送邮件,获取需要的邮件信息。
二、邮箱MCP服务包含哪些能力
具体的工具详细描述和参数等信息可以通过MCP的工具查询接口查看。
tools列表
搜索邮件: search_mail
基于KQL表达式,支持日期、关键词等条件搜索邮件。
获取邮件:get_mail
基于邮件id(可以通过搜索邮件获得),获取完整邮件内容,包含收发件人及正文等。
生成草稿:create_draft
生成邮件内容草稿,并保存在「草稿箱」文件夹。
发送邮件:send
指定收件人、主题、正文发送邮件。
获取日历:list_calendars
获取账号日历信息,包括 ID,名字,是否共享等信息,默认日历 Id 是 1,名字是calendar。
获取日历视图:get_calendar_events_view
根据日历 ID 获取指定时间区间的日程列表。
获取日程详情:get_calendar_event
根据日历 ID 和日程 ID(获取日历视图接口可以获取日程 ID) 获取日程详情,包括开始结束时间、组织者、参会人、主题和正文等。
创建或发送日程:create_calendar_event
指定组织者、参会人和开始结束时间等,创建或发送日程,其中 notify 设为 true,则会发送日程给参会人,若 notify 设为 false,则只在组织者日历中创建日程,并不会发送给参会人。
三、如何使用邮箱MCP服务
步骤 1:进入邮箱设置-MCP服务

步骤 2:生成Token
复制Token或JSON配置

示例1:在钉钉AI助理配置邮箱MCP
参考钉钉 MCP 技能快速入门中「使用 AI 助理技能模板中 MCP 技能」章节,将邮箱MCP服务JSON配置填入钉钉MCP插件中。

配置完成,检测插件成功后,保存AI助理。
并对话尝试邮箱MCP服务是否生效,例如“帮我看看今天有什么需要处理的邮件”。

示例2:在阿里云百炼配置邮箱MCP
进入阿里云百炼控制台,MCP管理--自定义服务--创建MCP服务。

目前在阿里云百炼中配置自定义MCP需要开通函数计算产品。

说明 您的MCP服务会被部署到函数计算(Function Compute)中,FC会为您准备好计算资源,并以弹性、可靠的方式运行您的代码,按实际调用时长和次数计费,具体用量可前往FC资源用量明细查看。
填写阿里邮箱MCP配置信息,并提交部署。

单击进入创建好的服务(非编辑),切换到工具选项卡,等待服务连接,连接成功后会出现相应的邮箱接口。

在应用管理中,给应用添加对应的阿里邮箱MCP服务,即可正常使用。


示例3:在通义灵码配置邮箱MCP
两种添加方式,手动添加或配置文件添加。

方式1:手动添加:
参数
-y mcp-remote@latest https://qiye.aliyun.com/mcp/streamable/ --header Authorization:${AUTH_TOKEN}
环境变量
Key:AUTH_TOKEN
Value:Bearer <token>
说明 <token>请替换为邮箱MCP生成的token值。

方式2:配置文件添加
填入邮箱MCP生成的JSON配置。

配置成功。

效果展示


常见问题
无法连接到阿里邮箱的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值。