Mailtea

Mailtea Agent 插件

发送邮件和新闻简报。开口即可。

Mailtea 让你的 AI 助手可以在对话中发送和安排邮件、检查投递情况、撰写和设计新闻简报、管理联系人，以及搭建出版物网站。它适用于使用 Mailtea 发送邮件的新闻简报作者、创作者和团队，也适用于希望让 Agent 处理邮件、而无需编写集成代码的开发者。

你将获得什么

167 个工具，按功能分组：

工具类别	助手可以做什么
邮件（email.*）	发送、批量发送、安排、取消和重新发送邮件；发送前进行检查；跟踪投递和互动情况；读取并回复收到的邮件
新闻简报（issue.*、monetize.*）	起草、编辑、预览、测试、安排和发送新闻简报；将其发布到网站；跟进投递进度；管理赞助商优惠
模板（template.*）	创建、渲染、发布、复制和管理可复用邮件模板的版本
受众（contact.*、contact_property.*、segment.*、topic.*、suppression.*）	管理联系人及其属性；导入 CSV；创建细分群组和主题；处理屏蔽项；运行推荐里程碑
自动化（automation.*、automation_run.*、event.*、event_definition.*）	创建、验证、预览、启用和衡量多步骤自动化；发送用于启动自动化的自定义事件
网站（site.*、section.*）	编辑页面、版块、导航、页脚、主题和设计简介；管理图片；发布出版物网站
发送设置（domain.*、sender.*）	添加并验证发送和跟踪域名；管理发件人
分析（analytics.*）	查看新闻简报表现、趋势和投票结果；导出 CSV
账户（publication.*、api_key.*、webhook.*、auth.*）	列出和创建出版物；连接自定义网站域名；管理 API 密钥和 Webhook；查看已连接的用户

三种随时可用的技能

助手会根据你的请求选择相关技能。你也可以直接指定技能。

内置技能	可帮你完成的工作	试着这样说
Mailtea 邮件（mailtea-email）	发送或安排邮件、检查投递情况、起草新闻简报和管理联系人	“帮我发送第一封邮件。”
Mailtea 邮件设计（mailtea-email-design）	为真实收件箱设计欢迎邮件、新闻简报和可复用模板	“起草一封只有一个明确行动号召的欢迎邮件。先不要发送。”
Mailtea 网站设计（mailtea-site-design）	搭建或重新设计出版物网站，并将更改保存为草稿	“为我的出版物起草一个‘关于’页面。先不要发布。”

此插件不能替代 Mailtea Studio，也不能替代用于应用代码的 SDK 和 CLI。当你希望由 AI 助手代劳时，请使用此插件。

连接

使用 AI 的场景	连接方式
Claude.ai	依次进入 Settings、Connectors、Add custom connector，然后粘贴 https://api.mailtea.app/mcp
Claude Desktop	在 Discover 中安装 Mailtea，或添加与 Claude.ai 相同的自定义连接器
Claude Code	先运行 claude plugin marketplace add mailtea-app/mailtea-agent-plugin，再运行 claude plugin install mailtea@mailtea
Cursor	依次进入 Settings、Plugins、Add from repository：mailtea-app/mailtea-agent-plugin
VS Code	依次打开 Command Palette、MCP: Browse servers，然后选择 Mailtea
Codex	先运行 codex plugin marketplace add mailtea-app/mailtea-agent-plugin，再运行 codex plugin add mailtea@mailtea

更多客户端及各客户端的一行安装命令，请参阅 开始使用。

首次连接时，请在浏览器中登录 Mailtea，选择一个出版物，并设置访问级别（从只读到完全访问）。你的助手只能在该出版物内按此级别操作；你也可以随时在 Mailtea 中撤销连接。

文档 · 支持 · 隐私政策 · 服务条款

开始使用

你需要一个 Mailtea 账户。发送邮件还需要一个已验证的发送域名。托管连接无需 API 密钥、无需安装 Node.js，也无需编写代码。你可以通过浏览器登录。

客户端	安装方式
任何客户端	npx plugins add mailtea-app/mailtea-agent-plugin
Codex	codex plugin marketplace add mailtea-app/mailtea-agent-plugin，然后运行 codex plugin add mailtea@mailtea
Claude Code	claude plugin marketplace add mailtea-app/mailtea-agent-plugin，然后运行 claude plugin install mailtea@mailtea
Cursor	Settings → Plugins → Add from repository，或运行 npx plugins add mailtea-app/mailtea-agent-plugin -t cursor
Grok Bot（在 Cursor 中）	安装上述 Cursor 插件即可，无需单独操作
VS Code / GitHub Copilot	Command Palette → MCP: Browse servers，或运行 npx plugins add mailtea-app/mailtea-agent-plugin -t vscode
Kiro	MCP 设置 → 添加服务，或运行 npx plugins add mailtea-app/mailtea-agent-plugin -t kiro
Grok Build	/marketplace，添加 mailtea-app/mailtea-agent-plugin，然后安装 mailtea
Gemini CLI	gemini extensions install https://github.com/mailtea-app/mailtea-agent-plugin
OpenCode	在 opencode.json 中添加 MCP 服务 https://api.mailtea.app/mcp（类型为 remote），然后运行 opencode mcp auth mailtea
GitHub Copilot CLI	copilot mcp add mailtea https://api.mailtea.app/mcp，然后在交互式会话中连接
Windsurf	Settings → Cascade → MCP servers → 添加 https://api.mailtea.app/mcp
Claude.ai	Settings → Connectors → Add custom connector → https://api.mailtea.app/mcp
ChatGPT	Settings → Connectors → Add → https://api.mailtea.app/mcp（开发者模式）
Kiro（单击添加）
Cline	打开 MCP Servers，然后选择 Configure MCP Servers：从手动配置中添加 Cline 条目
Zed	将手动配置中的 Zed 条目添加到 settings.json
Warp	Settings，然后选择 Agents，再选择 MCP servers：粘贴手动配置中的 Warp 条目
JetBrains AI Assistant	MCP 设置：添加手动配置中的 JetBrains 条目。目前还不支持通过浏览器登录，因此需要使用个人访问令牌发送邮件。Junie 可直接通过浏览器登录
Amazon Q Developer CLI	将手动配置中的 Amazon Q 条目添加到 Agent 配置，然后在会话中运行 /mcp 登录
Devin、Perplexity、Mistral Le Chat、Manus	使用 URL https://api.mailtea.app/mcp 添加自定义 MCP 连接器

npx plugins add 是通用安装方式。plugins CLI 会读取此软件包的 plugin.json，并将其安装到检测到的 Agent 工具中：Claude Code、Cursor、Codex、Grok Build、Kimi Code、GitHub Copilot CLI 和 VS Code。使用 -t <target> 选择目标，使用 npx plugins targets 查看检测结果。

然后开启新会话，通过浏览器登录提示连接 Mailtea，选择要使用的出版物和要授予的访问权限，并粘贴：

帮我使用 Mailtea 发送第一封邮件。检查我的设置，并引导我完成所有缺失的步骤。

你的 Agent 会检查账户可用的出版物、发件人和域名验证状态，并说明缺少任何项目时接下来该怎么做。你无需了解工具名称，也无需选择技能。

需要账户？从 Mailtea 开始。 需要发送域名？域名设置。

手动配置

每个条目都指向同一个托管服务：https://api.mailtea.app/mcp。 除非上方的表格另有说明，否则客户端首次连接时，你需要通过浏览器登录，无需粘贴密钥。

Cline（cline_mcp_settings.json）：

{"mcpServers": {"mailtea": {"type": "streamableHttp", "url": "https://api.mailtea.app/mcp"}}}

Zed（settings.json）：

{"context_servers": {"mailtea": {"url": "https://api.mailtea.app/mcp"}}}

Warp（依次打开 Settings、Agents 和 MCP servers）：

{"mailtea": {"url": "https://api.mailtea.app/mcp"}}

JetBrains AI Assistant：目前无法通过浏览器登录，因此请将 Mailtea 个人访问令牌（在 Settings → API keys 中创建）作为 Authorization 标头发送。Junie 可通过浏览器登录，无需标头。

{"mcpServers": {"mailtea": {"url": "https://api.mailtea.app/mcp", "headers": {"Authorization": "Bearer mt_pat_xxx"}}}}

Amazon Q Developer CLI（Agent 配置文件），然后在会话中运行 /mcp，并打开它显示的登录链接：

{"mcpServers": {"mailtea": {"type": "http", "url": "https://api.mailtea.app/mcp"}}}

复制提示词

发送一封邮件。 将方括号中的详细信息替换为你自己的内容：

从 [my verified sender] 向 [recipient] 发送一封邮件。主题：[subject]。正文：[body]。

安排发送时间：

将这封邮件安排在 [date and time, including time zone] 发送。使用 [verified sender]，并且仅发送给 [recipient]。

检查投递情况：

检查我最近的 Mailtea 邮件，并说明任何投递失败的情况。

创建新闻通讯草稿：

为 [publication] 撰写一份关于 [topic] 的新闻通讯草稿。拟定一个清晰的主题，并加入一个行动号召。暂时不要发送。

设计你的网站：

使用 [publication] 的品牌风格和现有内容，为其撰写一个主页草稿。暂时不要发布。

发出请求后会发生什么

• 草稿就是草稿。 草稿请求不会发送邮件或发布网站。
• 收件人由你选择。 你的 Agent 会询问缺少的详细信息，并使用你提供或批准的发件人、收件人和内容。
• 邮件 ID 表示已接受，不代表已送达。 请查询投递状态以确认结果。超时后，在确认状态之前不要重复发送。
• 权限以你的设置为准。 连接只能访问你的 Mailtea 账户和你授予的权限所允许的内容。

遇到问题时

你看到的情况	处理方法
安装后看不到 Mailtea 工具	打开新会话，检查插件是否已启用，然后连接 Mailtea。
没有浏览器登录提示	从终端或 MCP 设置重新连接。请参阅下表。
没有可用的出版物	在 Mailtea 中创建一个，或使用已有出版物的访问权限重新连接。
没有发件人，或域名尚未验证	按照域名设置的说明完成 DNS 记录配置，并选择该域名下的发件人。
权限被拒绝	重新连接并选择允许执行该操作的访问权限。如果没有该选项，请联系出版物所有者。
发送超时	请 Agent 检查最近的邮件，然后再试，以避免重复发送。
想要断开连接	在 Mailtea 的 API keys / connected agents 页面撤销连接，并在客户端中停用插件。

各客户端的重新连接方式

客户端	重新连接方式
Codex	codex mcp login mailtea
Claude Code	/mcp，或 claude mcp login mailtea
Cursor	打开 MCP settings，再选择 Mailtea，然后重新连接
VS Code	MCP: Browse servers，然后选择 Mailtea
Kiro	MCP settings
Grok Build	/marketplace，或 grok mcp login

Package layout

仓库根目录就是插件根目录。 每个客户端都会加载这个目录：Agent Plugins 客户端（Cursor、VS Code、Kiro、Codex）、Claude Code、Grok Build 和 Gemini CLI。没有按客户端划分的子目录，也没有第二份技能副本。

这一设计遵循 Agent Plugins 1.0.0 §4.1：客户端从软件包中解析的路径必须位于插件根目录内，因此嵌套软件包无法通过符号链接或相对路径与根目录共享 skills/。采用嵌套结构就意味着必须复制每个技能。使用单一根目录可以保留唯一副本，而镜像的 v<version> 发布标签会读取同一根目录下的 plugin.json。

mailtea-agent-plugin/            # this package, and the plugin root
├── plugin.json                  # Agent Plugins 1.0.0 manifest (portable)
├── mcp.json                     # Agent Plugins MCP config (streamable-http)
├── .mcp.json                    # client-native MCP config (Codex, Grok Build)
├── skills/
│   ├── mailtea/SKILL.md         # send / schedule / manage email & newsletters
│   ├── mailtea-email-design/    # email-safe design (ops + HTML)
│   └── mailtea-site-design/     # publication website builder
├── assets/                      # icon and listing images
├── .codex-plugin/plugin.json    # Codex manifest + listing metadata
├── .claude-plugin/              # Claude Code manifest + repository marketplace
├── .cursor-plugin/              # Cursor manifest + repository marketplace
├── .grok-plugin/                # Grok Build manifest + repository marketplace
├── .agents/plugins/marketplace.json  # Codex repository marketplace
├── gemini-extension.json        # Gemini CLI extension manifest
├── server.json                  # MCP Registry entry (app.mailtea/mailtea)
├── GEMINI.md                    # Gemini CLI context file
├── scripts/check-manifests.mjs  # keeps every manifest in agreement
├── CHANGELOG.md
├── README.md
└── LICENSE

每个清单都以相同版本声明同一插件，使用相同的描述，指向 skills/ 和相同的 MCP 端点，且不包含凭据。node scripts/check-manifests.mjs 会强制执行这些要求；该 monorepo 会通过 pnpm check:agent-plugin 运行此检查。

Self-hosting and stdio

托管服务 https://api.mailtea.app/mcp 会通过客户端的浏览器流程登录，并且不会在此软件包中存储凭据。对于自托管 API 或本地开发，请改用 stdio 运行 MCP 服务，并让客户端注入令牌：

# Claude Code example
claude mcp add mailtea -e MAILTEA_API_TOKEN=mt_pat_xxx -- npx -y mailtea-mcp

变量	必填	用途
MAILTEA_API_TOKEN	是	PAT（mt_pat_…）或会话令牌
MAILTEA_PUBLICATION_ID	否	默认发布范围
MAILTEA_API_BASE_URL	否	默认为 Mailtea 云端；本地 API 请使用 http://localhost:7787

在 Settings → API keys 中创建个人访问令牌，或使用 POST /v1/api-keys 创建。切勿提交令牌：Agent Plugins 禁止在软件包文件中包含凭据，如果 MCP 标头中出现凭据，scripts/check-manifests.mjs 会使构建失败。

Versioning

本项目没有 npm 或 PyPI 软件包。此插件就是这个仓库，因此要固定版本，请使用发布标签。main 始终包含最新版本：

git clone --branch v0.10.0 --depth 1 https://github.com/mailtea-app/mailtea-agent-plugin.git

每个清单中的 version 都与标签一致，每次发布的说明都来自 CHANGELOG.md。语义化版本规则：补丁版本用于优化技能措辞，次要版本用于新增技能或 MCP 接口，主要版本用于移除或重命名技能或接口。

Authoring notes

请勿在 plugin.json 顶层添加仅供特定客户端使用的钩子、命令或市场元数据。请根据客户端扩展的要求，将这些内容放在反向域名形式的 extensions 键下，或放在该客户端自己的目录中。

此处的技能是 Mailtea monorepo 中规范版本的副本。请先编辑规范版本，然后运行 pnpm sync:agent-plugin-skills。

Related

• 规范：agent-plugins.org · 构建插件
• MCP 软件包：mailtea-mcp
• 仅包含技能的镜像：mailtea-agent-skills
• 文档：Agent Plugin

Privacy and support

• 隐私政策：mailtea.app/privacy-policy
• 服务条款：mailtea.app/terms-of-service
• 支持：[email protected]
• 文档：Agent Plugin

此插件不存储凭据。托管连接会通过浏览器登录，并且只能访问你授予的发布内容和权限；你可以随时在 Mailtea 中撤销访问权限。

License

MIT