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 分