连接人工智能助手（MCP）

该应用运行着一个 MCP 服务器，因此人工智能助手可以直接检查您的设置、构建和转换电子邮件布局、管理您的 HTTP 请求以及整理您的媒体库，而无需您来回复制配置。

它能做的一些实用事情：根据您的页脚文本起草市场版面设计；将版面设计翻译成您销售的所有语言；检查哪些电子邮件版面引用了即将轮换的密钥；查找所有已上传但不再被任何内容使用的图片；解释昨天邮件发送失败的原因；或者根据第三方 API 的文档构建新的 HTTP 请求。

端点

text

POST https://shopify.workflow-transactional-email.app/api/mcp

传输协议为 Streamable HTTP。身份验证使用与 REST API 相同的承载密钥 - - 详见身份验证和 API 密钥。

连接

该应用“开发者”页面上的**“MCP**”选项卡会为 Claude、Claude Desktop、Cursor、VS Code 和 Gemini CLI 生成一个已预填好您的 URL 和密钥、可直接复制的命令。请使用该命令，而非手动输入。

对于 Claude Code 而言，该命令如下所示：

bash

claude mcp add --transport http flow-transactional-email \
  https://shopify.workflow-transactional-email.app/api/mcp \
  --header "Authorization: Bearer fak_your_key_here"

对于使用 JSON 配置的编辑器，其结构如下：

~/.cursor/mcp.jsonjson

{
  "mcpServers": {
    "flow-transactional-email": {
      "url": "https://shopify.workflow-transactional-email.app/api/mcp",
      "headers": {
        "Authorization": "Bearer fak_your_key_here"
      }
    }
  }
}

可用工具

工具集反映了您的密钥级别。当只读密钥调用写入工具时，不仅会被拒绝 - - 它甚至根本不会在列表中看到该工具，因此无法说服助手尝试执行该操作。

阅读（15种工具）

电子邮件布局：list_email_templates、get_email_template、get_layout_schema、list_template_translations、list_template_versions、get_template_version。list_email_templates 支持 q、category（transactional 或 marketing）、page 以及 limit。

电子邮件发件人：list_smtp_configs、list_senders

《秘密》：list_secret_keys（仅限姓名）

HTTP 请求：list_http_requests、get_http_request

媒体：list_files（传入参数 usage: true 可查看哪些文件仍引用了该文件）

历史：list_history（按 status 筛选，包括 SKIPPED，该地址用于发送营销邮件，其所有收件人均已退订），get_history_entry，get_stats

读写（加12）

电子邮件模板：create_email_template、update_email_template、delete_email_template

语言：set_template_translation、delete_template_translation、promote_template_translation

版本：restore_template_version，restore_template_github_version

HTTP 请求：create_http_request、update_http_request、delete_http_request

媒体：delete_file

读取、写入和执行（加1）

test_http_request - 向实际目标发送一个已配置的 HTTP 请求。

借助助手设计建筑布局

请先让助手阅读 get_layout_schema：该文档描述了视觉设计格式，包括每个模块的默认设置、可使用的 Liquid 模板以及由构建器自身生成的限制。随后，create_email_template 会接受一个 name、一个 subject，以及一个 bodyDesign（视觉模式，默认）或一个 HTML body（文本模式）。布局会立即在应用中显示，且每次更改都会保存在版本历史记录中，因此助手所做的任何操作都可以撤销。

有两个字段决定了布局在电子邮件中的表现方式：

category：transactional（默认）或 marketing。营销版面会跳过已退订的收件人，并包含退订链接和页脚；详见营销邮件与退订。
marketingTexts：使用营销版面的页脚文本，而非“设置”中的商店默认文本，{ unsubscribeText, unsubscribeLinkLabel, companyDetails }，所有字段均为可选；null 表示使用“设置”中的文本。退订语句中必须包含 {{ unsubscribe_link }} 或 {{ unsubscribe_url }}。

set_template_translation 创建或用完整的翻译内容替换一种语言。对于文本布局，它还可以包含attachments（a list = 该语言自身的文件，null = 布局的文件，omitted = 不变），对于营销布局，则包含marketingTexts，即在布局文件之上添加该语言的文件。promote_template_translation会将该语言设为布局的主语言；两者位置互换，因此不会丢失任何内容。

一个不错的首次请求：

“请阅读布局方案，然后将我的‘订单已发货’布局翻译成德语和法语。所有 Liquid 标签和 URL 必须完全保持原样。”

每次写入操作都会像在应用中保存文件一样进行校验：Liquid 必须经过解析，文件必须是你自己的，且工具会返回出现错误的字段。

整理媒体库

这正是助理大显身手的时候。让它列出包含使用情况的文件列表，然后删除那些没有任何引用项的文件：

“列出我上传的文件及其使用情况，并告诉我哪些文件没有被使用。然后删除这些文件。”

delete_file 如果任何电子邮件布局或页眉/页脚预设仍引用该文件，系统将返回 409 错误并拒绝该请求，且错误信息会明确指出正在使用该文件的对象 - - 因此，即使您要求助手删除徽标，它也无法移除当前正在使用的电子邮件仍需要的徽标。

助理永远无法看到的东西

系统刻意未提供任何能够返回密钥值、SMTP 用户名或密码，以及邮箱登录令牌的工具。list_secret_keys 仅返回名称。

这就是该设计的要点：你可以让助手编写一个通过你的支付服务商进行身份验证的 HTTP 请求，该请求会正确引用 {{ secrets.stripeApiKey }}，而密钥本身则永远不会进入模型的上下文。

通过 MCP 返回的历史记录与通过 REST 返回时一样经过了屏蔽处理。同样的注意事项也适用 - - 屏蔽操作针对字段名称和值模式，而自由文本字段仍可能在通信中携带个人数据。在让助手处理大范围的历史记录之前，请务必考虑这一点。