Mailtani

Mailtani MCP Server

Claude、Cursor、または MCP 互換の AI エージェントから、メールマーケティングを直接管理できます。

Mailtani MCP サーバーは、連絡先、リスト、セグメント、キャンペーン、メール、タグ、カスタムフィールド、イベントトラッキングをネイティブな AI ツールとして公開します。これにより、エージェントはチャットから離れることなく、キャンペーンの送信、連絡先の登録、イベントの追跡を行えます。

---

できること

カテゴリ	ツール
連絡先	一覧表示、作成（またはアップサート）、更新、削除
リスト	すべて一覧表示、作成、連絡先の追加、連絡先の削除
セグメント	すべて一覧表示、条件を指定して作成、一致する連絡先の取得
キャンペーン	一覧表示、ブロードキャスト／シーケンス／フローの作成（下書きとして）、ブロードキャスト／シーケンス／フローの直接編集、有効化、アーカイブ
メール	送信済みメールの一覧表示、単発のトランザクションメール（リッチテキストまたはプレーンテキスト）の送信
受信トレイ	会話スレッドの一覧表示、スレッドの全履歴の閲覧、スレッドへの返信
タグ	すべて一覧表示、作成、削除
カスタムフィールド	すべて一覧表示、作成
イベント	カスタムイベントの追跡（フローをトリガー）

使用できるプロンプトの例

"Create a broadcast campaign called 'Q3 Newsletter' targeting my 'Leads' list."

"Create a contact for [email protected], tag him as VIP, and send him the onboarding email."

"Track a purchase_completed event for [email protected] with plan=pro."

"Show me all contacts added in the last 7 days."

"Set up a 3-step welcome sequence for new signups with delays of 0, 3, and 7 days."

"Create a flow that sends an email whenever a contact is added to my project."

---

認証

MCP サーバーは、Mailtani REST API と同じ API キーシステムを使用します。

すべてのリクエストに次の2つのヘッダーが必要です。

ヘッダー	値
Authorization	Bearer mk_YOUR_API_KEY
X-Project-Id	プロジェクト ID（Settings → API にあります）

Mailtani アカウント内の Settings → API Keys で API キーを生成してください。

---

セットアップ

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json（Mac）または %APPDATA%\Claude\claude_desktop_config.json（Windows）を編集します。

{
  "mcpServers": {
    "mailtani": {
      "type": "http",
      "url": "https://mailtani.com/mcp",
      "headers": {
        "Authorization": "Bearer mk_YOUR_API_KEY",
        "X-Project-Id": "YOUR_PROJECT_ID"
      }
    }
  }
}

Claude Desktop を再起動します。サーバーが接続されると、確認用のハンマーアイコンが表示されます。

Claude Code

ターミナルで実行します。

claude mcp add --transport http mailtani https://mailtani.com/mcp \
  --header "Authorization: Bearer mk_YOUR_API_KEY" \
  --header "X-Project-Id: YOUR_PROJECT_ID"

Cursor

Cursor の MCP 設定に追加します（Cursor → Settings → MCP）。

{
  "mailtani": {
    "type": "http",
    "url": "https://mailtani.com/mcp",
    "headers": {
      "Authorization": "Bearer mk_YOUR_API_KEY",
      "X-Project-Id": "YOUR_PROJECT_ID"
    }
  }
}

Codex

~/.codex/config.json に追加します。

{
  "mcpServers": {
    "mailtani": {
      "type": "http",
      "url": "https://mailtani.com/mcp",
      "headers": {
        "Authorization": "Bearer mk_YOUR_API_KEY",
        "X-Project-Id": "YOUR_PROJECT_ID"
      }
    }
  }
}

MCP 互換クライアント

Endpoint:  POST https://mailtani.com/mcp
Protocol:  MCP over HTTP (JSON-RPC 2.0)
Auth:      Authorization: Bearer mk_...
Scope:     X-Project-Id: <id>
Rate limit: 30 requests / minute

---

ツールリファレンス

連絡先

ツール	説明
list-contacts	検索、リスト／タグ／ステータスによる絞り込み、ページネーションを指定して連絡先を一覧表示します
create-contact	メールアドレスで連絡先を作成またはアップサートします。オプションでリストやタグを割り当てられます
update-contact	連絡先 ID を指定して、連絡先のフィールド、リスト、タグを更新します
delete-contact	ID を指定して連絡先を完全に削除します
get-contact-history	メールアドレスで連絡先の送信／返信履歴全体を取得します。すべてのスレッドにわたる送信と返信が、時系列順に統合されます

リスト

ツール	説明
list-lists	連絡先数とともに、すべての連絡先リストを一覧表示します
create-list	新しい連絡先リストを作成します
add-contact-to-list	一度に最大500件の連絡先をリストに追加します
remove-contact-from-list	1件の連絡先をリストから削除します

セグメント

ツール	説明
list-segments	連絡先数とともに、すべてのセグメントを一覧表示します
create-segment	フィルター条件を指定してセグメントを作成します（最大50件）
get-segment-contacts	セグメントに一致する連絡先をページネーション付きで取得します

キャンペーン

キャンペーンは常に下書きとして作成されます。Mailtani アプリを開いて確認し、有効化してください。

ツール	説明
list-campaigns	タイプまたはステータスで絞り込んでキャンペーンを一覧表示します
create-campaign	新しいキャンペーン（ブロードキャスト、シーケンス、フロー）を下書きとして作成します
create-broadcast	1 回限りの一斉メール送信の下書きを作成し、対象者を登録します。send_all、または list_ids／segment_ids／tag_ids のいずれか 1 つ以上が必要です
create-sequence	ステップごとの遅延を設定した複数ステップのドリップシーケンスの下書きを作成し、対象者を登録します。send_all、または list_ids／segment_ids／tag_ids のいずれか 1 つ以上が必要です
create-flow	シンプルなフローの下書き（単一のトリガーから送信）を作成します。トリガー：contact_added、contact_updated、contact_added_to_list、event_received、form_submitted
create-advanced-flow	分岐、待機、キャンペーン開始／停止ノードを含むフローの下書きを作成します。連絡先のプロパティに基づく分岐や、別のキャンペーンの停止が必要な場合は、create-flow の代わりにこちらを使用してください
update-campaign	既存のブロードキャストまたはシーケンスを再作成せずに、その場で編集します（スケジュール、名前、送信元メールアドレス、コンテンツ）。連絡先（リスト／セグメント／タグ／send_all）の登録も行います。対象者なしで作成されたキャンペーンは、この方法で対象者を登録しないと有効化できません
update-flow	既存のフローを再作成せずに、その場で編集します（ノード、エッジ、設定、ステータス）
inspect-email-body	キャンペーンに保存する前にメール本文を確認します。Markdown がそのまま表示される箇所、対応していないタグ、リンク切れ、未解決の差し込み変数を検出します
simulate-flow	特定の連絡先についてフローをたどり、何も送信せずに実際に進む経路を報告します
enroll-contact	1 人の連絡先をキャンペーンに登録します
activate-campaign	下書きまたは一時停止中のキャンペーンを有効化し、送信可能な状態にします
bulk-update-campaign-status	最大 100 件のキャンペーンを一括でアーカイブまたは有効化します

メール

ツール	説明
list-emails	送信済みメールを一覧表示します。連絡先で絞り込むこともできます
send-email	任意のアドレスに単発のトランザクションメールを送信します（リッチテキストまたはプレーンテキスト）
update-email	未送信の単発メールを編集し、必要に応じて送信または予約できます

受信トレイ

ツール	説明
list-threads	受信トレイの会話スレッドを一覧表示します。連絡先、未読、カテゴリ、アドレス、日付で絞り込めます
get-thread	1 つのスレッドの全メッセージ履歴を順番に読み取ります。送信メール、キャンペーンのステップ、受信した返信が含まれます
reply-to-thread	既存のスレッドに返信します。スレッドへの返信として、適切なアドレスから自動的に送信されます

タグ

ツール	説明
list-tags	すべてのタグを連絡先数とともに一覧表示します
create-tag	新しいタグを作成します
delete-tag	ID を指定してタグを削除します

カスタムフィールド

ツール	説明
list-custom-fields	すべてのカスタムフィールドを一覧表示します
create-custom-field	カスタムフィールドを作成します（名前を基準に冪等です）

イベント

ツール	説明
track-event	連絡先のカスタムイベントを記録します。プロパティを保存し、フローを起動します

---

セキュリティ

• すべての操作は X-Project-Id によってプロジェクトの範囲内に限定されます。別のプロジェクトのデータを読み取ったり変更したりできるツールはありません
• API キーは保存時に SHA-256 でハッシュ化され、平文で保存されることはありません
• 1 分あたり 30 リクエストにレート制限されています
• 1 日あたりのメール送信上限は、ご利用のプランに応じて適用されます

---

リンク

• Mailtani
• REST API ドキュメント
• MCP サーバーのドキュメント
• API キーを取得