Temway

io.github.temway由 GitHub 账号 temway 发布v1.0.0更新于 Nov 2, 2026

Visual email & layout builder that turns AI assistants into a Temway authoring studio.

已验证Streamable HTTP可网页运行效率与工作流媒体与设计

概览

AI 生成的概览

托管式 Temway MCP 服务器，让 AI 助手在 Temway 工作区中起草、编辑、预览、发布并发送测试邮件与版式。

可以做什么
  • 读取工作区上下文：品牌令牌、区块与元素结构、模板、字体、样式与形状预设、概念文档
  • 撰写邮件：创建、更新、复制、删除邮件，套用品牌化模板，编辑区块，设置全局样式，校验内容
  • 预览与发布邮件：快速网页预览、MJML HTML 预览、发布，以及发送一次性测试副本
  • 制作版式：创建和编辑自由版式，使用绝对定位元素、自定义 SVG 形状、起始模板、画布贴合与发布
  • 查找与锁定：按名称搜索工作区中的邮件和版式、按 id 获取完整内容，并对共享资源获取或释放编辑锁
适用场景
适合希望助手在已有 Temway 工作区内产出营销或事务性邮件与视觉版式，而不必手写 HTML 或使用拖拽编辑器的场景。最适合已使用 Temway、想用自然语言撰写、迭代和发布的团队。
运行要求
远程 Streamable HTTP 端点，本地无需安装任何东西。认证使用以 tmw_live_ 开头的 Temway API 密钥，通过 Authorization Bearer 请求头发送，由团队管理员在 Temway 后台生成，绑定单一工作区并带有读写权限范围。claude.ai、ChatGPT 等托管网页连接器改用 OAuth 2.1。需要能访问 Temway 端点的网络。
安装前请注意
Authorization 中的 API 密钥只显示一次且可访问工作区，须妥善保管；仅浏览时可缩小为只读权限。助手可创建、更新、删除、发布邮件与版式，并可发送测试邮件，测试发送会真实投递到指定地址。区块与元素修改不是原子操作，同一资源上的并行编辑可能互相覆盖。版式嵌入邮件时会栅格化为 PNG，文字不可选中。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Temway，将其添加到工作区。
  2. 连接 Authorization token 凭据。它们会被私密存储，绝不会在公开页面上展示。
  3. 为需要使用其工具的对话启用该服务。

Web executable，通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体，或 SourceWeft 对话中。智能体会读取该服务器的安装指南，先向你展示发布者、端点和登录方式，经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.github.temway%2Fmcp-server/install.md，并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前，先告诉我它的发布者、端点和登录方式，等我确认。不要把 API 密钥写进命令或我会提交的文件；问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "temway": {
      "type": "http",
      "url": "https://mcp.temway.com/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_TOKEN>"
      }
    }
  }
}

README

Temway MCP Server

Let your AI assistant design beautiful emails & layouts — in your Temway workspace.

A Model Context Protocol server that turns Claude, ChatGPT, Cursor and friends into a visual email & layout authoring studio.

[MCP] [License: MIT] [Status]

Getting Started · Clients · Tools · Temway

Temway is a visual builder for emails and layouts. This MCP server exposes your Temway workspace to any MCP-compatible AI client: the model reads your brand tokens, drafts a promo / newsletter / welcome email, previews it, publishes it, and even sends a test — all through natural language. No code, no drag-and-drop, no copy-pasting HTML.

It is a hosted remote MCP server. You point your client at a URL with an API key (or OAuth for web clients) — there is nothing to install, build, or run locally. The server speaks the MCP Streamable HTTP transport.

🔒 No source here? Correct. This is the public onboarding repo for the Temway MCP server. The server is operated by Temway and runs at https://mcp.temway.com/mcp. This repo holds client configuration, tool reference, and connectivity helpers. Report issues / request tools in Issues.

How it works

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

The model authenticates per-request, then drives your workspace through brand-aware templates, block mutations, layout artwork, live previews, and publishing.

Getting started

1. Get an API key

API keys are minted by a team admin in the Temway dashboard. The key:

  • starts with tmw_live_…
  • is bound to one workspace
  • carries scopes (emails:read, emails:write, layouts:read, layouts:write) that gate which tools succeed

Store it securely — it's shown once.

2. Point your client at the server

The endpoint and a ready-to-paste config for each client are in examples/. The short version:

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

That's it. The workspace is derived from the key.

3. Ask your assistant

"Create a promo email for our summer sale, 25% off, brand colors, a big CTA button, preview it, then publish it."

The model will get_branding → create_email → apply_template → update_block → preview_email_web → publish_email for you.

Configure your client

The Temway server speaks the Streamable HTTP transport. Pick your client:

ClientConfigFile
Claude Codeclaude mcp add --transport http …examples/claude-code.md
Claude DesktopmcpServers JSONexamples/claude-desktop.json
claude.ai (web)OAuth connector URLexamples/claude-ai-web.md
ChatGPTOAuth connector URLexamples/chatgpt.md
CursorMCP settingsexamples/cursor.md
Any MCP clientStreamable HTTP URLexamples/generic.json

Authentication

Two credential types — both resolve onto the same workspace context:

  • tmw_live_… API keys — for desktop & programmatic clients (Claude Code, Claude Desktop, Cursor, scripts). Sent as Authorization: Bearer tmw_live_…. The workspace is derived from the key. Scope-bound.
  • OAuth 2.1 — for hosted web connectors (claude.ai, ChatGPT) that reject static keys. No header to paste — the user signs in and picks a workspace on the consent screen; the connector receives its own short-lived token (PKCE / S256). Just enter the URL https://mcp.temway.com/mcp.

Tools

The server exposes 58 tools across five groups. Reads need a *:read scope; mutations need *:write.

Discovery & context — brand tokens, schemas, catalogs
ToolWhat it does
get_brandingFetch workspace brand tokens (colors, fonts, logo, socials, footer).
list_block_types / get_block_schemaEmail block catalog + per-block editable fields.
list_layout_element_types / get_element_schemaLayout element catalog + fields.
get_universal_schemaGlobal email style fields.
list_templatesCurated email starter templates.
list_fontsUsable fonts (web-safe for emails; + Google/custom for layouts).
list_concepts / get_conceptMental-model concept docs (read before authoring).
list_layout_templatesCurated layout artwork starters.
list_shape_presets / list_style_presetsDecorative SVG library + style keys.
Emails — author, mutate, preview, publish, send
ToolWhat it does
list_emails / get_emailBrowse & read published/draft emails.
create_email / update_email / delete_email / duplicate_emailCRUD.
create_email_from_layoutSeed an email from a published layout.
set_content / validate_contentReplace whole content / validate before saving.
add_block / update_block / remove_block / move_blockIncremental block edits.
set_universalMerge global email styles.
apply_templateApply a brand-aware starter template.
preview_email_webFast web-target preview (preferred while iterating).
preview_email_htmlInbox-target MJML HTML (slower; verifies client rendering).
publish_emailRender + store; marks the email published.
test_send_emailSend a one-off test copy to an address.
Layouts — free-form pixel-perfect artwork canvas
ToolWhat it does
list_layouts / get_layoutBrowse & read layouts.
create_layout / update_layout / delete_layout / duplicate_layoutCRUD.
set_layout_contentReplace the whole layout descriptor.
add_layout_element / update_layout_element / remove_layout_elementElement edits (absolute positioning).
add_custom_shape / add_shape_presetBespoke SVG or curated decorative shapes.
apply_layout_templateApply a layout starter (hero-banner, promo-card, …).
fit_canvas_to_contentTighten canvas bounds to visible elements.
publish_layoutSnapshot for embedding in emails.

Note: layouts rasterize to a single PNG when embedded in an email (text not selectable). Author readable/clickable content as email blocks instead.

Concurrency locks — prevent clobbering on shared resources

acquire_* / get_*_lock_status / refresh_*_lock / release_*_lock / force_release_*_lock for both email and layout resources.

Block/element mutations are not atomic — never fire two on the same resource in parallel. Acquire the edit-lock first on shared resources.

Search & fetch
ToolWhat it does
searchSearch the workspace for emails/layouts by name/subject/tags.
fetchFetch the full content of a search result by id.

A typical authoring flow

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

Environment variables

The hosted endpoint is fully managed — most users never touch env vars. They only matter if you self-host or run the stdio transport.

VarPurposeRequired?
TEMWAY_API_URLTemway API base URL.Only when self-hosting.
TEMWAY_API_KEYtmw_live_… key (stdio transport).stdio only.
TEMWAY_WORKSPACE_IDWorkspace id (stdio transport; HTTP derives from key).stdio only.
LOG_LEVELpino log level (default info).no

Connectivity check

Verify the endpoint is reachable from your network before wiring up a client:

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

(npx temway-mcp-healthcheck once published, or npm run healthcheck.)

Self-hosting

This repo does not contain server source. If you need to run the server yourself (on-prem, air-gapped, custom auth), contact [email protected] or open an issue.

FAQ

Is this open source?

The server is operated by Temway (source currently private). This repo is the public integration surface: client configs, tool reference, and helpers, published under the MIT license so you can copy configs freely.

Do I need to install Node / npm / anything?

No. The hosted remote transport means your client connects over HTTPS by URL — nothing runs locally. The optional healthcheck.mjs needs Node ≥ 18.17.

Which client should I use?

For local/CLI work: Claude Code or Cursor. For no-install browser use: claude.ai or ChatGPT with the OAuth connector. All configs are in examples/.

How are my emails protected from the model?

Credentials are scope-bound per key (*:read / *:write). Reads never mutate; every mutation is explicit. Narrow scopes to a read-only key for safe browsing.

Support

License

MIT © Temway

来源：README.md，提交 02d359e

工具

0
SourceWeft 尚未读取此服务器的工具。

版本历史

1
  1. v1.0.0最新Sep 16, 2026

评分

已满足适用检查项的 85%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具必需15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分