Temway

---

Temway は、メールやレイアウトを作成するビジュアルビルダーです。この MCP サーバーを使うと、MCP 対応の AI クライアントから Temway ワークスペースを利用できます。モデルはブランドトークンを読み込み、プロモーションメール／ニュースレター／ウェルカムメールを作成して、プレビュー、公開、さらにはテスト送信まで、すべて自然言語で行います。コードも、ドラッグ＆ドロップも、HTML のコピー＆ペーストも不要です。

これはホスト型のリモート MCP サーバーです。API キー（Web クライアントの場合は OAuth）を使ってクライアントを URL に接続するだけで、ローカルでのインストール、ビルド、実行は一切不要です。サーバーは MCP のストリーミング可能な 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 キーを取得する

API キーは、Temway ダッシュボードでチーム管理者が発行します。このキーは次の特徴があります。

• tmw_live_… で始まります
• 1 つのワークスペースに紐付けられます
• 成功するツールを制御するスコープ（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 サーバーはストリーミング可能な 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 クライアント	ストリーミング可能な HTTP URL	examples/generic.json

認証

2 種類の認証情報があり、どちらも同じワークスペースコンテキストに紐付けられます。

• tmw_live_… API キー — デスクトップおよびプログラムから利用するクライアント（Claude Code、 Claude Desktop、Cursor、スクリプト）向けです。Authorization: Bearer tmw_live_… として送信します。 ワークスペースはキーから特定されます。スコープに紐付けられています。
• OAuth 2.1 — 静的キーを受け付けないホスト型ウェブコネクター（claude.ai、ChatGPT）向けです。 貼り付けるヘッダーはありません。ユーザーはサインインして、同意画面でワークスペースを選択します。コネクターには専用の短期トークン（PKCE / S256）が発行されます。URL https://mcp.temway.com/mcp を入力するだけです。

ツール

サーバーは5つのグループにわたって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	指定したアドレスにテストメールを1通送信します。

レイアウト — 自由形式のピクセル単位で正確なアートワークキャンバス

ツール	機能
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 の両方のリソースで使用できます。

ブロック／要素の変更はアトミックではありません。同じリソースに対して、2つの操作を並列で実行しないでください。共有リソースを編集する場合は、先に編集ロックを取得してください。

検索と取得

ツール	機能
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 トランスポートを実行する場合にのみ関係します。

変数	用途	必須？
TEMWAY_API_URL	Temway API のベース URL。	セルフホストする場合のみ。
TEMWAY_API_KEY	tmw_live_… キー（stdio トランスポート）。	stdio のみ。
TEMWAY_WORKSPACE_ID	ワークスペース 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] に連絡するか、イシューを作成してください。

FAQ

これはオープンソースですか？

サーバーは 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