mailinapp
Documentation menu

MCP 服务器

MailInApp 提供一个 MCP 服务器,让外部 AI 客户端——Claude Desktop、Claude Code,或任何其他兼容 MCP 的工具——可以直接构建和编辑你账户中的邮件项目,方式与工作室内的AI 副驾完全相同。无论哪种方式,底层都是同一套工具核心:MCP 客户端和工作室面板只是通向同一组编辑操作的两个不同入口。

本页介绍的是开发者路径:你自己的后端或 CLI 工具,使用你自己铸造的 API 密钥进行认证——与发送 API使用的是同一种凭据。

端点与认证

https://mailinapp.com/api/mcp

使用与发送 API相同的 Authorization: Bearer <apiKey> 请求头进行认证——从仪表盘的开发者页面铸造或复用一个密钥。在这一路径下没有单独需要管理的 MCP 专属凭据;一个密钥本身就代表"这个账户自己的后端",因此在这里享有相同级别的信任,下文列出的每一个工具都可以使用,不受任何范围限制。

该端点是无状态的:每个请求都是一次自包含的 MCP 调用,因此消息之间没有任何需要保持存活的状态,除了你 MCP 客户端本身的常规配置流程外,也没有单独的连接/断开步骤。

连接 Claude Code

claude mcp add --transport http mailinapp https://mailinapp.com/api/mcp \
  --header "Authorization: Bearer mia_live_..."

Claude Desktop 和其他支持远程 HTTP 服务器的 MCP 客户端使用相同的 URL 和请求头——具体粘贴到哪里,请参阅你所用客户端自己的文档。

工具

一个 API 密钥受到完整账户所有者级别的信任,因此它能看到所有可用的工具——项目设计、联系人与屏蔽列表、营销活动结果与订单、发送(包括真实的营销活动发送,而不仅仅是测试)、域名邮箱与工单回复,以及套餐用量。

树编辑类工具(add_block/update_block/remove_block/move_block/set_theme 等)都需要一个前置的 projectId(来自 list_projects/create_project)——MCP 客户端没有打开的工作室标签页可供推断。每一种有效的模块类型、它所接受的父级,以及它的字段列表,都通过 list_block_types 描述给模型,作为工具集的一部分——因此它始终与工作室当前提供的模块类型保持同步;你不需要告诉它有哪些模块可用。

编辑如何生效

每一次会产生修改的工具调用,都是直接写入项目的一次原子操作——这里没有像工作室内面板那样的"应用"步骤,因为也没有一个打开的画布可供应用。如果你在 MCP 客户端编辑项目的同时,恰好在工作室中打开着同一个项目,你下一次自动保存时会看到常规的**"已在别处更改"**冲突提示,与团队成员编辑过它时完全相同——重新加载即可获取 MCP 所做的更改,或选择保存为副本以保留你自己正在进行的编辑。

每一次 MCP 编辑同样会被记录进该项目的 AI 副驾聊天线程中(标记为来自 MCP,而非工作室面板),因此它会出现在工作室内 AI 副驾面板所显示的同一份历史记录中。

速率限制与套餐可用性

  • 每个 API 密钥:每分钟 60 次请求,与账户下的其他密钥互不影响。
  • 每个账户:每一次工具调用都会消耗同一个月度计数器(plan.connectorCallsMonthly,与工作室内 AI 副驾自己的对话轮次配额是分开的,因为一次 MCP 调用从不会在 MailInApp 自己这一侧调用 AI 模型)。所有套餐(包括免费版)都有真实的配额可用——具体数字见定价,或调用 get_plan_usage 读取账户当月的用量。
  • 通过该路径发送真实的营销活动,计量方式与 confirm_send 相同,采用同样的确认流程和发送量上限。