postmark-automation

Rube MCP による Postmark の自動化

Rube MCP 経由で Composio の Postmark ツールキットを使用し、Postmark のトランザクションメール操作を自動化します。

ツールキットのドキュメント: composio.dev/toolkits/postmark

前提条件

• Rube MCP が接続されている必要があります（RUBE_SEARCH_TOOLS が利用可能）
• postmark ツールキットを使用した RUBE_MANAGE_CONNECTIONS 経由の Postmark 接続が有効である必要があります
• 現在のツールスキーマを取得するため、必ず最初に RUBE_SEARCH_TOOLS を呼び出してください

セットアップ

Rube MCP の取得: クライアント設定で https://rube.app/mcp を MCP サーバーとして追加します。API キーは不要です。エンドポイントを追加するだけで利用できます。

1. RUBE_SEARCH_TOOLS が応答することを確認し、Rube MCP が利用可能であることを確かめます
2. ツールキット postmark を指定して RUBE_MANAGE_CONNECTIONS を呼び出します
3. 接続が ACTIVE でない場合は、返された認証リンクに従って Postmark の認証を完了します
4. ワークフローを実行する前に、接続ステータスが ACTIVE であることを確認します

主なワークフロー

1. テンプレートを使用した一括メール送信

使用する場面: ユーザーが複数の宛先にテンプレートメールを一度の呼び出しで送信したい場合

ツールの順序:

1. POSTMARK_LIST_TEMPLATES - 利用可能なテンプレートとその ID を確認します［前提条件］
2. POSTMARK_VALIDATE_TEMPLATE - 送信前にモデルデータを使ってテンプレートを検証します［任意］
3. POSTMARK_SEND_BATCH_WITH_TEMPLATES - テンプレートを使用して一括メールを送信します［必須］

主なパラメーター:

• TemplateId または TemplateAlias: 使用するテンプレートの識別子
• Messages: From、To、TemplateModel を含むメッセージオブジェクトの配列
• TemplateModel: テンプレート変数に対応するキーと値のペア

注意点:

• 1 回の一括呼び出しで送信できるメッセージは最大 500 件です
• TemplateId と TemplateAlias のどちらか一方が必須です。両方は指定できません
• TemplateModel のキーはテンプレート変数名と完全に一致している必要があります（大文字と小文字を区別します）
• 送信者アドレスは、検証済みの Sender Signature、または検証済みドメインのものである必要があります

2. メールテンプレートの管理

使用する場面: ユーザーがメールテンプレートを作成、編集、または確認したい場合

ツールの順序:

1. POSTMARK_LIST_TEMPLATES - ID と名前を含むすべてのテンプレートを一覧表示します［必須］
2. POSTMARK_GET_TEMPLATE - HTML／テキスト本文を含むテンプレートの詳細を取得します［任意］
3. POSTMARK_EDIT_TEMPLATE - テンプレートの内容または設定を更新します［任意］
4. POSTMARK_VALIDATE_TEMPLATE - サンプルデータを使ってテンプレートのレンダリングをテストします［任意］

主なパラメーター:

• TemplateId: GET／EDIT 操作用の数値テンプレート ID
• Name: テンプレートの表示名
• Subject: メールの件名（テンプレート変数をサポート）
• HtmlBody: テンプレートの HTML コンテンツ
• TextBody: プレーンテキストの代替コンテンツ
• TemplateType: 'Standard' または 'Layout'

注意点:

• テンプレート ID は文字列ではなく、整数の数値です
• テンプレートを編集すると内容全体が置き換わります。維持したいフィールドはすべて含めてください
• Layout テンプレートは Standard テンプレートをラップします。レイアウトを変更すると、リンクされているすべてのテンプレートに影響します
• 不足している変数を早期に検出できるよう、送信前に検証してください

3. 配信統計の監視

使用する場面: ユーザーがメール配信の健全性、開封率／クリック率、または送信状況の概要を確認したい場合

ツールの順序:

1. POSTMARK_GET_DELIVERY_STATS - 種類別のバウンス数を取得します［必須］
2. POSTMARK_GET_OUTBOUND_OVERVIEW - 送信、開封、クリック、バウンスの概要を取得します［必須］
3. POSTMARK_GET_TRACKED_EMAIL_COUNTS - 時系列の追跡対象メール数を取得します［任意］

主なパラメーター:

• fromdate: 統計の絞り込み開始日（YYYY-MM-DD）
• todate: 統計の絞り込み終了日（YYYY-MM-DD）
• tag: メッセージタグで統計を絞り込みます
• messagestreamid: メッセージストリームで絞り込みます（例: 'outbound'、'broadcast'）

注意点:

• 日付パラメーターは時刻を含まない YYYY-MM-DD 形式です
• 統計は集計されます。個々のメッセージの追跡には別途 API 呼び出しが必要です
• messagestreamid が指定されていない場合、デフォルトですべてのストリームが対象になります

4. バウンスと苦情を管理する

使用するタイミング：ユーザーがバウンスしたメールやスパムの苦情を確認したい場合

ツールの実行順序：

1. POSTMARK_GET_BOUNCES - 詳細情報付きでバウンスしたメッセージを一覧表示します［必須］
2. POSTMARK_GET_SPAM_COMPLAINTS - スパムの苦情記録を一覧表示します［任意］
3. POSTMARK_GET_DELIVERY_STATS - バウンスの概要件数を取得します［任意］

主なパラメーター：

• count：ページごとに返すレコード数
• offset：結果のページネーションオフセット
• type：バウンスの種類によるフィルター（例：'HardBounce'、'SoftBounce'、'SpamNotification'）
• fromdate/todate：日付範囲フィルター
• emailFilter：受信者のメールアドレスでフィルター

注意点：

• バウンスの種類には、HardBounce、SoftBounce、SpamNotification、SpamComplaint、Transient などがあります
• ハードバウンスは恒久的な配信失敗を示します。このようなアドレスは削除してください
• スパムの苦情は送信者の評価に影響するため、定期的に確認してください
• ページネーションにはページトークンではなく、count と offset を使用します

5. サーバー設定を構成する

使用するタイミング：ユーザーが Postmark サーバーの設定を確認または変更したい場合

ツールの実行順序：

1. POSTMARK_GET_SERVER - 現在のサーバー設定を取得します［必須］
2. POSTMARK_EDIT_SERVER - サーバー設定を更新します［任意］

主なパラメーター：

• Name：サーバーの表示名
• SmtpApiActivated：SMTP API アクセスを有効化／無効化します
• BounceHookUrl：バウンス通知用の Webhook URL
• InboundHookUrl：受信メール処理用の Webhook URL
• TrackOpens：開封トラッキングを有効化／無効化します
• TrackLinks：リンクトラッキングのモード（'None'、'HtmlAndText'、'HtmlOnly'、'TextOnly'）

注意点：

• サーバーの編集は、そのサーバー経由で送信されるすべてのメッセージに影響します
• Webhook URL は、公開アクセス可能な HTTPS エンドポイントである必要があります
• SmtpApiActivated を変更すると、SMTP リレーへのアクセスに即座に影響します
• トラッキング設定は今後のメッセージにのみ適用され、過去のメッセージには遡及適用されません

よくあるパターン

テンプレート変数の解決

1. Call POSTMARK_GET_TEMPLATE with TemplateId
2. Inspect HtmlBody/TextBody for {{variable}} placeholders
3. Build TemplateModel dict with matching keys
4. Call POSTMARK_VALIDATE_TEMPLATE to verify rendering

ページネーション

• ページごとの結果数を count に設定します（エンドポイントによって異なります）
• 取得済みの結果をスキップするには offset を使用します
• 結果が返される件数が count 未満になるまで、各ページで offset を count ずつ増やします
• レコード総数がレスポンスのメタデータに含まれる場合があります

既知の注意点

認証：

• Postmark はアカウントレベルではなく、サーバーレベルの API トークンを使用します
• サーバーごとに独自のトークンがあるため、正しいサーバーコンテキストであることを確認してください
• 送信者アドレスは、確認済みの送信者署名、または確認済みドメインのものである必要があります

レート制限：

• 一括送信は、1 回の呼び出しにつき最大 500 件に制限されています
• API のレート制限はエンドポイントによって異なります。429 レスポンスに対してバックオフを実装してください

レスポンスの解析：

• レスポンスデータは data または data.data の下にネストされている場合があります
• フォールバックパターンを用いて、堅牢に解析してください
• テンプレート ID は常に数値の整数です

クイックリファレンス

タスク	ツールスラッグ	主なパラメーター
テンプレートを使用してメールを一括送信	POSTMARK_SEND_BATCH_WITH_TEMPLATES	Messages, TemplateId/TemplateAlias
テンプレートを一覧表示	POSTMARK_LIST_TEMPLATES	Count, Offset, TemplateType
テンプレートの詳細を取得	POSTMARK_GET_TEMPLATE	TemplateId
テンプレートを編集	POSTMARK_EDIT_TEMPLATE	TemplateId, Name, Subject, HtmlBody
テンプレートを検証	POSTMARK_VALIDATE_TEMPLATE	TemplateId, TemplateModel
配信統計	POSTMARK_GET_DELIVERY_STATS	(なし、または日付フィルター)
送信メールの概要	POSTMARK_GET_OUTBOUND_OVERVIEW	fromdate, todate, tag
バウンスを取得	POSTMARK_GET_BOUNCES	count, offset, type, emailFilter
スパムの苦情を取得	POSTMARK_GET_SPAM_COMPLAINTS	count, offset, fromdate, todate
トラッキング対象メールの件数	POSTMARK_GET_TRACKED_EMAIL_COUNTS	fromdate, todate, tag
サーバー設定を取得	POSTMARK_GET_SERVER	(なし)
サーバー設定を編集	POSTMARK_EDIT_SERVER	Name, TrackOpens, TrackLinks

---

Composio 提供