工具参考

已连接助手可以调用的每一个工具,按服务器注册它们的方式分组。只有当你的连接持有某个工具所需的权限范围时,该工具才会被提供给助手——不存在那种始终存在却总是报错的写入类工具;如果你没有授予 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 | | 将当前项目快照保存为一个可复用的模板。 |

受众

| 工具 | 权限范围 | 破坏性 | 说明 | | --- | --- | :-: | --- | | list_data_sources | contacts:read | | 每一个数据源,包括联系人列表。凭证值永远不会被返回。 | | list_contact_lists | contacts:read | | 专指联系人列表——id、名称、字段、行数。 | | get_contact_list_summary | contacts:read | | 数量与屏蔽总数——不包含任何单条联系人数据。 | | find_contacts | contacts:read | | 有边界的查询(≤25 行,游标分页)。每次调用都会写入个人数据访问日志,与在仪表盘中读取联系人的效果相同。 | | 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 | 添加一条所有者消息,并给收件人发送一个返回链接。 |

账户

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

小组件

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