Temway

---

Temway 是一款用于制作邮件和布局的可视化构建器。此 MCP 服务可将你的 Temway 工作区开放给任何兼容 MCP 的 AI 客户端：模型读取你的品牌令牌，起草促销邮件、简报或欢迎邮件，预览并发布，甚至发送测试邮件——所有操作都通过自然语言完成。无需编写代码，无需拖放，也无需复制粘贴 HTML。

这是一个托管的远程 MCP 服务。你只需让客户端连接到带 API 密钥的 URL（Web 客户端可使用 OAuth）——无需在本地安装、构建或运行任何内容。此服务使用 MCP Streamable HTTP 传输方式。

🔒 **这里没有源代码？没错。**这是 Temway MCP 服务的公开入门仓库。该服务由 Temway 运营，运行于 https://mcp.temway.com/mcp。此仓库包含客户端配置、工具参考和连接辅助工具。请在 Issues 中报告问题或申请工具。

工作原理

Your AI client (Claude / ChatGPT / Cursor / Desktop)
  └─ MCP over HTTPS  →  https://mcp.temway.com/mcp
                         Authorization: Bearer tmw_live_…   ← API key
                         (or OAuth token for web connectors)
                              └─ Temway public API  →  your workspace

模型会针对每个请求进行身份验证，然后通过符合品牌规范的模板、区块修改、布局图稿、实时预览和发布来操作你的工作区。

快速入门

1. 获取 API 密钥

团队管理员可在 Temway 控制面板中生成 API 密钥。该密钥：

• 以 tmw_live_… 开头
• 绑定到一个工作区
• 包含用于控制哪些工具可以成功执行的作用域（emails:read、emails:write、layouts:read、layouts:write）

请妥善保管——密钥只会显示一次。

2. 将客户端连接到服务

每个客户端的端点和可直接粘贴的配置都在 examples/ 中。简要步骤如下：

# Claude Code
claude mcp add --transport http temway https://mcp.temway.com/mcp \
  --header "Authorization: Bearer tmw_live_xxxxxxxxxxxxxxxx"

就这么简单。工作区会根据密钥自动确定。

3. 向助手提出需求

“为我们的夏季促销创建一封促销邮件，优惠 25%，使用品牌配色，添加一个醒目的 CTA 按钮，预览后再发布。”

模型会为你依次执行 get_branding → create_email → apply_template → update_block → preview_email_web → publish_email。

配置客户端

Temway 服务使用 Streamable HTTP 传输方式。请选择你的客户端：

客户端	配置	文件
Claude Code	claude mcp add --transport http …	examples/claude-code.md
Claude Desktop	mcpServers JSON	examples/claude-desktop.json
claude.ai（Web）	OAuth 连接器 URL	examples/claude-ai-web.md
ChatGPT	OAuth 连接器 URL	examples/chatgpt.md
Cursor	MCP 设置	examples/cursor.md
任何 MCP 客户端	Streamable HTTP URL	examples/generic.json

身份验证

两种凭据类型——都指向同一个工作区上下文：

• tmw_live_… API 密钥——适用于桌面客户端和编程客户端（Claude Code、Claude Desktop、Cursor、脚本）。通过 Authorization: Bearer tmw_live_… 发送。工作区由密钥确定。密钥与作用域绑定。
• OAuth 2.1——适用于拒绝静态密钥的托管式 Web 连接器（claude.ai、ChatGPT）。无需粘贴请求头——用户登录并在授权界面选择工作区；连接器会获得自己的短期令牌（PKCE / S256）。只需输入 URL https://mcp.temway.com/mcp。

工具

该服务通过五个类别提供 58 个工具。读取需要 *:read 作用域；修改需要 *:write。

发现与上下文 — 品牌标记、架构、目录

工具	功能
get_branding	获取工作区品牌标记（颜色、字体、徽标、社交账号、页脚）。
list_block_types / get_block_schema	电子邮件区块目录 + 各区块可编辑字段。
list_layout_element_types / get_element_schema	布局元素目录 + 字段。
get_universal_schema	全局电子邮件样式字段。
list_templates	精选电子邮件入门模板。
list_fonts	可用字体（电子邮件使用适合网页的字体；布局另支持 Google 字体和自定义字体）。
list_concepts / get_concept	思维模型概念文档（创作前阅读）。
list_layout_templates	精选布局插画入门模板。
list_shape_presets / list_style_presets	装饰性 SVG 库 + 样式键。

电子邮件 — 创作、修改、预览、发布、发送

工具	功能
list_emails / get_email	浏览和阅读已发布/草稿电子邮件。
create_email / update_email / delete_email / duplicate_email	CRUD。
create_email_from_layout	根据已发布的布局创建电子邮件。
set_content / validate_content	替换全部内容 / 保存前验证。
add_block / update_block / remove_block / move_block	增量编辑区块。
set_universal	合并全局电子邮件样式。
apply_template	应用符合品牌风格的入门模板。
preview_email_web	快速网页目标预览（迭代时首选）。
preview_email_html	收件箱目标 MJML HTML（速度较慢；用于验证客户端渲染效果）。
publish_email	渲染并存储；将电子邮件标记为已发布。
test_send_email	向某个地址发送一次性测试副本。

布局 — 自由形式的像素级精准画布

工具	功能
list_layouts / get_layout	浏览和阅读布局。
create_layout / update_layout / delete_layout / duplicate_layout	CRUD。
set_layout_content	替换整个布局描述符。
add_layout_element / update_layout_element / remove_layout_element	编辑元素（绝对定位）。
add_custom_shape / add_shape_preset	自定义 SVG 或精选装饰形状。
apply_layout_template	应用布局入门模板（hero-banner、promo-card、…）。
fit_canvas_to_content	收紧画布边界，使其贴合可见元素。
publish_layout	生成快照，以便嵌入电子邮件。

注意： 布局嵌入电子邮件时会栅格化为单张 PNG（文本不可选中）。可读、可点击的内容应使用电子邮件区块创作。

并发锁 — 防止共享资源上的修改相互覆盖

acquire_* / get_*_lock_status / refresh_*_lock / release_*_lock / force_release_*_lock，适用于 email 和 layout 两种资源。

区块/元素修改不是原子操作 — 切勿并行对同一资源执行两项修改。在共享资源上先获取编辑锁。

搜索与获取

工具	功能
search	按名称/主题/标签搜索工作区中的电子邮件/布局。
fetch	按 ID 获取搜索结果的完整内容。

典型创作流程

get_branding
→ create_email { name: "Spring sale" }
→ apply_template { template: "promo" }        # brand-aware starter
→ update_block / add_block                    # tweak copy, CTA, colors
→ preview_email_web                           # fast preview (preferred)
→ publish_email                               # renders + marks published
→ test_send_email { to: "[email protected]" }    # optional real send

环境变量

托管端点完全由我们管理——**大多数用户无需接触环境变量。**只有在自托管或运行 stdio 传输时才需要用到它们。

Var	用途	必填？
TEMWAY_API_URL	Temway API 基础 URL。	仅自托管时需要。
TEMWAY_API_KEY	tmw_live_… 密钥（stdio 传输）。	仅 stdio 需要。
TEMWAY_WORKSPACE_ID	Workspace ID（stdio 传输；HTTP 根据密钥推导）。	仅 stdio 需要。
LOG_LEVEL	pino 日志级别（默认值为 info）。	否

连通性检查

在配置客户端之前，请确认你的网络可以访问该端点：

node scripts/healthcheck.mjs
# → OK 200 OK (926ms)
# → ✓ Temway MCP endpoint is reachable.

（发布后可运行 npx temway-mcp-healthcheck，或运行 npm run healthcheck。）

自托管

此仓库不包含服务端源代码。如果你需要自行运行服务端（本地部署、隔离网络、自定义身份验证），请联系 [email protected] 或提交议题。

常见问题

这是开源的吗？

服务端由 Temway 运营（目前源代码为私有）。此仓库是公开的集成入口：客户端配置、工具参考和辅助工具，采用 MIT 许可证发布，你可以自由复制配置。

我需要安装 Node / npm / 其他东西吗？

不需要。托管的远程传输方式让客户端通过 URL 使用 HTTPS 连接——无需在本地运行任何东西。可选的 healthcheck.mjs 需要 Node ≥ 18.17。

我应该使用哪个客户端？

本地/CLI 工作：Claude Code 或 Cursor。无需安装，直接在浏览器中使用：通过 OAuth 连接器使用 claude.ai 或 ChatGPT。所有配置都在 examples/ 中。

如何保护我的邮件，避免模型访问？

凭据按密钥限定权限范围（*:read / *:write）。读取操作不会修改数据；每项修改操作都需明确执行。为安全浏览，请将权限范围缩小为只读密钥。

支持

• 📧 [email protected]
• 🐛 GitHub Issues
• 🌐 temway.com

许可证

MIT © Temway