工具参考

已连接助手可以调用的每一个工具,按服务器注册它们的方式分组。只有当你的连接持有某个工具所需的权限范围时,该工具才会被提供给助手——不存在那种始终存在却总是报错的写入类工具;如果你没有授予 contacts:write,助手根本看不到 upsert_contacts 这个工具。每个权限范围具体意味着什么,见权限范围与权限。

破坏性在下面的表格中,是 Claude 自身审核流程所要求的同一个 MCP 标注——它标记的是那些效果无法轻易撤销的工具(删除项目、覆盖模块树、移除联系人),而不是某种更模糊意义上的"危险"。每一个写入类工具仍然只接受你所预期的字段;没有一个工具会接受模型可以借以夹带任意改动的原始负载。

发现

工具	权限范围	说明
`search`	`projects:read` / `templates:read` / `contacts:read` 之一	按名称搜索项目、模板和联系人列表。返回供 `fetch` 使用的不透明 id。这是支持深度研究的客户端会自动调用的工具。
`fetch`	与 `search` 相同	将 `search` 返回的某个 id 解析为其完整内容。

邮件设计

工具	权限范围	破坏性	说明
`list_projects`	`projects:read`		每个项目的 id、名称、用途。
`get_email`	`projects:read`		项目当前的模块树和主题。
`preview_email`	`projects:read`		通过真实的邮件 HTML 渲染流水线渲染——与发送时产生的文档完全一致。附带小组件(见下文)。
`list_block_types`	`projects:read`		完整的 44 种模块目录,由实时注册表生成——始终保持最新,无需手动维护。
`list_templates`	`projects:read`		你保存的模板,或已通过审核的社区图库。
`create_project`	`projects:write`		可选择基于内置用途模板初始化。
`add_block` / `update_block` / `move_block`	`projects:write`		模块树编辑,采用与工作室内 AI 副驾编辑相同的 `canPlace`/字段校验。
`remove_block`	`projects:write`	✓	删除一个模块及其子模块。
`set_theme`	`projects:write`		品牌颜色、字体、按钮圆角半径。
`rename_project`	`projects:write`
`delete_project`	`projects:write`	✓	永久删除。
`apply_template`	`projects:write`	✓	覆盖项目的整个模块树和主题。
`save_as_template`	`templates:write`		将当前项目快照保存为一个可复用的模板。
`publish_landing_page`	`projects:write`		把邮件发布为 `/lp/<slug>` 上的公开网页，并返回其 URL。与发送一样，助手被要求先向你展示邮件并获得你的同意。
`unpublish_landing_page`	`projects:write`		撤下页面。地址仍为你保留。

受众

工具	权限范围	破坏性	说明
`list_data_sources`	`contacts:read`		每一个数据源,包括联系人列表。凭证值永远不会被返回。
`list_contact_lists`	`contacts:read`		专指联系人列表——id、名称、字段、行数。
`get_contact_list_summary`	`contacts:read`		数量、屏蔽总数、邮箱验证结果分布以及最近一次重新验证的状态——不包含任何单条联系人数据。
`find_contacts`	`contacts:read`		有边界的查询(≤25 行,游标分页)。指定 `sortBy: "engagementScore"` 时，会按分数从高到低返回列表中的热门联系人，并附带分数和本周变化。每次调用都会写入个人数据访问日志,与在仪表盘中读取联系人的效果相同。
`upsert_contacts`	`contacts:write`		新增或更新记录;强制执行你套餐的联系人上限。
`remove_contact`	`contacts:write`	✓	永久移除一条记录。
`add_suppression` / `remove_suppression`	`contacts:write`		在整个账户范围内屏蔽或解除屏蔽一个地址,效果与收件人自己点击取消订阅链接相同。

结果

工具	权限范围	破坏性	说明
`get_campaign_results`	`analytics:read`		打开量/点击量/响应/收入、A/B 变体对比、点击热力图。仅提供汇总数据——绝不提供按收件人的原始事件。附带小组件。
`get_form_responses`	`analytics:read`		按问题的汇总统计;自由文本答案是数量受限、并标记为不可信内容的样本。
`list_orders`	`analytics:read`		商品模块结账产生的订单。
`list_campaign_sends`	`analytics:read`		过去的批量发送记录,按最新排序在前。
`list_schedules`	`analytics:read`		项目上配置的定时发送计划。
`mark_order_fulfilled`	`commerce:write`		将一个实物订单标记为已发货,并给买家发送邮件通知。
`create_schedule`	`campaigns:send`		配置一个新的定时发送计划。
`set_schedule_enabled`	`campaigns:send`	✓	被标记为破坏性操作,因为停用一个正在运行的定时发送计划会悄无声息地停止未来的发送。

发送

工具	权限范围	破坏性	说明
`send_test_email`	`campaigns:read`		向你指定的一个地址发送一份带 `[Test]` 前缀的副本——不会触及你的真实受众,也不需要 `campaigns:send`。
`prepare_send`	`campaigns:send`		按标注属于只读——解析受众并渲染预览,不会发送任何内容。返回一个 `confirmationToken`，以及因地址无效或未获同意而将被跳过的联系人数量。附带小组件(发送确认卡片)。
`confirm_send`	`campaigns:send`	✓	需要 `prepare_send` 返回的确切 `confirmationToken`,原样不变,并且在 10 分钟以内使用。原因见安全性。

域名邮箱与工单

工具	权限范围	说明
`list_mailbox_threads` / `get_mailbox_thread`	`mailbox:read`	你已验证域名收到的邮件。邮件正文会被标记为不可信的、由收件人撰写的内容。
`reply_to_mailbox_thread`	`mailbox:write`	从原始邮件到达的确切域名邮箱地址发出回复,并正确归入同一对话线。
`list_tickets` / `get_ticket`	`mailbox:read`	支持工单对话。采用相同的不可信内容标记方式。
`reply_to_ticket`	`mailbox:write`	添加一条所有者消息,并给收件人发送一个返回链接。

旅程与细分

工具	权限范围	破坏性	说明
`list_journeys`	`journeys:read`		每个旅程的 ID、名称、开启/关闭状态、触发器类型和步骤数。
`get_journey`	`journeys:read`		旅程的完整流程（带有你的邮件、列表和细分名称），以及会阻止它运行的问题。对于已关闭且可运行的旅程，还会返回 `enableToken`。
`list_segments`	`journeys:read`		已保存的细分，及其联系人列表和规则。
`create_segment`	`journeys:write`		在一个联系人列表上保存细分。受套餐的细分数量上限约束。
`build_journey`	`journeys:write`		根据自然语言请求，使用旅程构建器的 AI 副驾驶新建旅程，或编辑已关闭的旅程。消耗一次 AI 副驾驶轮次。结果始终保存为关闭状态，已开启的旅程绝不会被修改。
`set_journey_enabled`	`journeys:write`（开启时另需 `campaigns:send`）	✓	开启旅程需要 `get_journey` 返回的 `enableToken`，原样传入，10 分钟内有效，且期间不能有任何编辑。与 `prepare_send`/`confirm_send` 的两步思路相同。暂停则两者都不需要。

账户

工具	权限范围	说明
`get_plan_usage`	无——始终可用	套餐、配额,以及本月用量。只读,且不像项目/联系人/域名邮箱那样属于敏感账户数据,因此无论你授予了哪些权限范围,都可以使用。

小组件

在支持 MCP Apps 的主机上(Claude——Gemini 没有小组件层,始终只会得到纯文本/JSON 结果),有三个工具会附带一个互动小组件:preview_email(桌面端/移动端实时邮件预览)、get_campaign_results(结果仪表盘),以及 prepare_send(发送确认卡片,它自己的确认发送按钮才是真正调用 confirm_send 的地方)。