它解决的问题
为人工智能客户端提供一个精确的操作邮箱
当指令只指出类别,却没有指出 Gmail 对象时,邮件操作会变得有风险。MCP Abilities – Google Workspace 为一个被模拟的 Google Workspace 邮箱公开已注册的 WordPress 能力,使人工智能客户端可以针对确切的邮件、会话、标签或附件进行搜索、检查、修改或发送。
插件会执行你请求的操作。获得授权的操作员决定检查、修改或发送什么,包括是否适合发送外发邮件。
保护邮箱的决策
三个边界让每项操作都可追溯
使用这些规则区分设置、对象选择,以及 Gmail 状态发生变化的时点。
01
配置一个委派身份
使用原始 service account JSON,绝不要使用本地文件路径。配置会验证客户端电子邮件和私钥,保存设置,并为一个被模拟的 Google Workspace 邮箱测试身份验证。
02
使用前检查连接
使用所需的读取、发送、修改和标签权限范围设置全域委派,然后在使用邮箱前检查它是否已配置并连接。
03
将目标和修改视为精确对象
在需要时使用相应的邮件、会话、附件或标签标识符。标签修改、邮箱状态快捷操作、发送和回复会立即生效,不会经过单独的确认阶段。
从设置到操作的实用路径
连接邮箱,检查目标,然后执行操作
这是推荐的操作员实践。能力负责执行指定操作;操作员负责决定是否继续。
01
授权委派邮箱
设置带有全域委派的 Google service account,并为目标 Google Workspace 邮箱授予所需的读取、发送、修改和标签权限范围。
02
配置并检查状态
提交原始 service account JSON 以及要模拟的邮箱。配置会验证并测试身份验证;状态随后会报告连接是否已配置并连接。
03
修改前先检查
搜索并翻页查看邮件或会话,列出标签,或检索确切的邮件、会话、标签或附件。在选择修改或外发操作前,先选择相关标识符。
04
执行一项明确操作
针对所选操作使用确切的邮件、标签、会话、收件人、主题和正文。Gmail 发送、回复、标签修改和邮箱状态快捷操作会立即生效。
先读取,再决定
找到你真正要处理的邮件、会话或附件
将邮箱发现与检查分开,让所选对象以及标记为已读可能产生的影响保持明确。
搜索邮件
搜索 Gmail 邮件并翻阅结果,以确定候选邮件。
搜索会话
搜索 Gmail 会话并翻阅结果,适用于以会话而非单封邮件作为工作单位的情况。
检查一封邮件
通过标识符检索一封确切邮件。只有在明确请求时才将其标记为已读。
检查一个会话
通过标识符检索一个确切会话,让决定或回复拥有正确的对话上下文。
检索一个附件
通过标识符检索一个确切附件。将响应限制设置为 1 字节至 20 MB。
让标签保持有意为之
管理 Gmail 标签而不丢失目标
将标签检查与修改分开。每次修改都指定一个确切标签,并立即生效。
列出标签
列出系统标签和用户标签,在操作前查看可用的标签标识符。
检查一个标签
通过标识符检索一个确切标签,在决定是否修改前检查其当前名称和可见性。
创建一个标签
使用提供的名称、可见性以及可选颜色字段创建一个标签。
更新一个标签
使用标签标识符和你要修改的字段更新一个确切标签。
删除一个标签
删除一个确切的标签标识符。删除会立即发生,不会经过单独的确认阶段。
邮箱状态
修改一封邮件而不丢失目标
对于一封确切的 Gmail 邮件,邮箱状态操作会添加或移除指定标签。明确的快捷操作可以将该邮件标记为已读或未读、归档,或移入垃圾箱。
这些修改会立即发生,不会增加单独的确认阶段。请求修改前,明确选择邮件标识符和目标状态。操作需要一个拥有 manage_options 的已认证 WordPress 用户。
选择外发路径
使用匹配邮件的传输方式发送
每条路径都使用你指定的目标和内容。成功调用会立即发送,这些能力不会增加单独的确认阶段。
通过 Gmail 发送
通过已配置的 Gmail 身份发送新邮件。提供确切的收件人、主题和正文,可选 CC 和 BCC 收件人。
在 Gmail 中回复
使用请求的正文回复一封确切的现有邮件和会话。除非明确请求,否则禁用回复全部。
通过 WordPress 邮件发送
当网站要求使用该投递路径时,使用网站的 WordPress 邮件传输。它仍然独立于已配置的 Gmail 身份。
所需运行环境
MCP Abilities – Google Workspace 的依赖项
让这些源所有者负责的依赖项在其权威目标位置保持可用。
WordPress 6.9 或更高版本
WordPress 6.9+提供 WordPress 运行环境和已注册的 Abilities API。
PHP 8.0 或更高版本
PHP 8.0+提供所需的服务器运行环境。
启用 WordPress Abilities API
WordPress Abilities API负责能力注册、架构、注释和授权回调。
启用 MCP Adapter
WordPress MCP Adapter向已认证的 MCP 客户端公开已注册的 WordPress 能力。
启用 MCP Expose Abilities 插件
MCP Expose Abilities为已注册能力提供 Devenia 传输策略。
为 Google Workspace 中的委派身份启用
Google Workspace Gmail API提供通过已配置的 Google Workspace 身份使用的邮箱、邮件、会话、附件、标签和发送操作。
让邮箱发挥作用
获取一个邮箱的 WordPress 路径
如果你的人工智能客户端需要通过 WordPress 使用一个已配置的 Google Workspace 邮箱,请下载 MCP Abilities – Google Workspace。先配置委派的 service account,然后在使用邮箱能力前检查连接是否已配置并连接。
