mailinapp
Documentation menu

AI 连接器

将 Claude 或 Gemini 连接到你的 MailInApp 账户,在聊天中设计、发送并查看互动邮件的结果——"帮我搭建一封新品发布邮件"、"上周的调研问卷谁回答了?"、"把周二的通讯简报发送给活跃订阅者列表"。助手通过与工作室内 AI 副驾相同的工具调用核心来编辑你的真实项目并读取你的真实数据;连接器只是通向这套核心的第二个入口,由某个 AI 平台代表你持有,而不是工作室自身的侧边面板。

一个 URL,随处可用

https://mailinapp.com/api/mcp

每个平台都连接到这个完全相同的 URL——它是一个通过 Streamable HTTP 提供服务的远程 MCP 服务器。粘贴之前无需任何配置:客户端一连接,服务器就会立即告知应如何进行身份验证(OAuth 2.1,并征得你的明确同意),其余部分由平台自行处理。各平台具体步骤见 Claude 与 Gemini。

连接时会发生什么

  1. 你将上面的 URL 粘贴到 Claude 或 Gemini 自己的连接器设置中。
  2. 该平台会在你的浏览器中打开 MailInApp 的授权确认页面,并以你的身份登录。
  3. 如果你属于多个公司(你自己的账户,加上你作为活跃成员所在的任何团队),你需要选择这次连接将代表哪一个账户操作——一个连接始终只作用于一个账户。
  4. 你需要选择要授予哪些权限("权限范围")——参见权限范围与权限。所有只读权限都已默认勾选;发送邮件的权限则没有。
  5. 完成批准后,助手就可以代表该账户调用 MailInApp 的工具了。

在你完成这一流程之前,不会共享任何内容——连接并不会交出密码或 API 密钥,而是给平台一个有权限范围限制、可随时撤销的令牌。

它能做什么

  • 设计——读取和编辑项目的模块树与主题、浏览包含 44 种模块的目录、应用已保存的模板或社区模板、渲染实时预览。
  • 读取结果——营销活动的打开量/点击量/响应/收入、表单问题汇总统计、订单、发送历史、定时发送计划、套餐用量。
  • 管理受众——列出联系人列表、查找或新增/更新联系人、管理屏蔽名单。
  • 回复——域名邮箱对话与支持工单,两者都会被标记为不可信的收件人撰写内容(见安全性)。
  • 发送——两步式的 prepare_send → confirm_send 流程,在任何邮件真正发出之前,始终会先展示收件人数量与渲染后的预览。完整工具列表见工具参考,发送具体是如何被把控的见安全性。

它有意做不到的事

没有任何工具会涉及 Stripe/账单(拒付退款仍然只能在仪表盘中处理)、生成 API 密钥、轮换 Webhook 密钥、更改 SMTP/支付/域名设置,或管理团队邀请——这与 editor 团队成员在其他地方已经被排除在外的范围完全相同。campaigns:send 永远不会被默认授予,即使被授予了,发送依然需要经过上面的两步确认。

套餐可用性

连接器在所有套餐(包括 Free)中均可使用——读取你的项目与结果,以及构建新项目,都不会产生你尚未预算过的费用。真正计量的是每个日历月的工具调用次数(Free 为 200 次,随套餐提升而增加),以及另外单独计量的、连接器每月可以发送邮件的收件人数量(Free 为 0——发送邮件至少需要 Starter 套餐)。具体数字见定价,月度累计用量见仪表盘中的连接。

管理连接

仪表盘中的连接(/dashboard/connections)会列出你已批准的每一个助手——客户端名称、已授予的权限范围、上一次调用的时间——并提供一键撤销。撤销会立即生效:该助手持有的所有令牌都会在下一次调用时失效,无需等待过期。