阿里邮箱MCP服务说明

说明
  • 该功能仅AI尊享版支持,版本差异请参考版本介绍

  • 调用邮箱MCP的效果和AI智能体基础能力有关,建议对AI智能体做好提示词和知识库的优化。

一、邮箱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服务

  • 在邮箱配置MCP服务

步骤 1:进入邮箱设置-MCP服务

image.png

步骤 2:生成Token

image.png复制TokenJSON配置

image

  • 配置MCP客户端

示例1:在钉钉AI助理配置邮箱MCP

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

image.png

配置完成,检测插件成功后,保存AI助理。

并对话尝试邮箱MCP服务是否生效,例如“帮我看看今天有什么需要处理的邮件”。

image.png

示例2:在阿里云百炼配置邮箱MCP

进入阿里云百炼控制台,MCP管理--自定义服务--创建MCP服务。

image

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

image

说明

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

填写阿里邮箱MCP配置信息,并提交部署。

image

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

image

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

image

image

示例3:在通义灵码配置邮箱MCP

两种添加方式,手动添加或配置文件添加。

image.png

方式1:手动添加:

参数

-y mcp-remote@latest https://qiye.aliyun.com/mcp/streamable/ --header Authorization:${AUTH_TOKEN}

环境变量

Key:AUTH_TOKEN

Value:Bearer <token>

说明

<token>请替换为邮箱MCP生成的token值。

image

方式2:配置文件添加

填入邮箱MCP生成的JSON配置。

image

配置成功。

image

效果展示

image

image

常见问题

无法连接到阿里邮箱的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>"

image

通义灵码:界面配置token不需要引号

image

阿里云百炼提示:image

请确认JSON配置是否正确,请尝试重新从阿里邮箱生成或复制JSON值。