連接 AI 助理（MCP）

此應用程式會運行一個 MCP 伺服器，因此 AI 助理能直接檢查您的設定、建立並轉換電子郵件版面配置、管理您的 HTTP 請求，以及整理您的媒體庫，讓您無需反覆複製設定檔。

它能做的一些實用功能：根據您的頁尾文字草擬行銷版面配置、將版面配置翻譯成您銷售的所有語言、檢查哪些電子郵件版面配置引用了即將輪替的「秘密」、找出所有已上傳但不再被使用的圖片、解釋昨日寄送失敗的原因，或是根據第三方 API 的文件建立新的 HTTP 請求。

終點

text

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

傳輸協定為 Streamable HTTP。驗證方式與 REST API 相同，皆使用承載者金鑰（bearer key） - - 詳見驗證與 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

《Secrets》：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 = 佈局的檔案，省略 = 不變更），而對於行銷佈局，則可在佈局的檔案之上包含該語言的marketingTexts。使用promote_template_translation可將某種語言設為佈局的主語言；兩者會互換位置，因此不會遺失任何內容。

一個不錯的首次請求：

「請閱讀版面配置架構，然後將我的『訂單已出貨』版面翻譯成德語和法語。所有 Liquid 標籤和 URL 都必須完全維持原樣。」

每次寫入都會像在應用程式中儲存資料那樣進行檢查：Liquid 必須能解析，檔案必須是您自己的，而工具會回報哪個欄位出現錯誤。

整理媒體庫

這正是助理大顯身手之處。請它列出您的檔案清單並標註使用情況，然後刪除那些沒有任何參考的檔案：

「請列出我上傳的檔案及其使用情況，並告訴我哪些檔案目前沒有被使用。然後刪除那些檔案。」

delete_file 如果任何電子郵件版面配置或頁首／頁尾預設仍引用該檔案，系統將以 409 錯誤碼拒絕此請求，且拒絕訊息會明確指出哪些內容正在使用該檔案 - - 因此，即使您要求助理移除，它也無法刪除現役電子郵件仍需使用的標誌。

助理永遠無法看見的事

系統刻意未提供任何會回傳機密值、SMTP 使用者名稱或密碼，或是信箱登入憑證的工具。list_secret_keys 僅回傳名稱。

這正是此設計的重點：您可以請一位助理撰寫一個 HTTP 請求，該請求會透過您的支付服務商進行身份驗證，且會正確地引用 {{ secrets.stripeApiKey }}，而該金鑰本身則完全不會進入模型的上下文中。

透過 MCP 傳回的歷史紀錄，其遮罩方式與透過 REST 傳回時完全相同。同樣的注意事項也適用於此 - - 遮罩功能僅針對欄位名稱和值模式生效，而自由文字欄位仍可能在對話中攜帶個人資料。在讓助理處理大範圍的歷史紀錄之前，請先仔細考慮這一點。