Mailtani

Mailtani MCP 服务

直接通过 Claude、Cursor 或任何兼容 MCP 的 AI Agent 管理电子邮件营销。

Mailtani MCP 服务将您的联系人、列表、细分、营销活动、电子邮件、标签、自定义字段和事件跟踪作为原生 AI 工具提供，让您的 Agent 无需离开聊天界面即可发送营销活动、将联系人加入序列并跟踪事件。

---

您可以执行的操作

类别	工具
联系人	列出、创建（或更新插入）、更新、删除
列表	列出所有列表、创建、添加联系人、移除联系人
细分	列出所有细分、创建并设置条件、获取匹配的联系人
营销活动	列出、创建广播/序列/流程（作为草稿）、就地编辑广播/序列/流程、启用、归档
电子邮件	列出已发送的电子邮件、发送一次性事务性电子邮件（富文本或纯文本）
收件箱	列出对话串、读取对话串的完整历史记录、在对话串中回复
标签	列出所有标签、创建、删除
自定义字段	列出所有自定义字段、创建
事件	跟踪自定义事件（触发流程）

可使用的提示词示例

"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 密钥系统。

每个请求都需要两个请求头：

请求头	值
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	从列表中移除单个联系人

细分

工具	描述
list-segments	列出所有细分及其联系人数量
create-segment	创建细分并设置筛选条件（最多 50 个）
get-segment-contacts	分页获取符合某个细分条件的联系人

营销活动

营销活动始终以草稿形式创建。打开 Mailtani 应用以审核并启用它们。

工具	描述
list-campaigns	按类型或状态筛选并列出营销活动
create-campaign	以草稿形式创建新的营销活动（广播、序列或流程）
create-broadcast	创建一次性群发邮件草稿并将受众加入其中。需要 send_all 或至少一个 list_ids/segment_ids/tag_ids
create-sequence	创建包含多个步骤的滴灌式序列草稿，为每一步设置延迟时间并将受众加入其中。需要 send_all 或至少一个 list_ids/segment_ids/tag_ids
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	将单个联系人加入营销活动
activate-campaign	启用草稿或已暂停的营销活动，使其可以发送
bulk-update-campaign-status	一次归档或启用最多 100 个营销活动

邮件

工具	描述
list-emails	列出已发送的邮件，可按联系人筛选
send-email	向任意地址发送一次性事务性邮件（富文本或纯文本）
update-email	编辑尚未发送的一次性邮件，并可选择发送或安排发送时间

收件箱

工具	描述
list-threads	列出收件箱中的对话线程，可按联系人、未读状态、类别、地址或日期筛选
get-thread	按顺序读取一个线程的完整消息历史记录——包括发出的邮件、营销活动步骤和收到的回复
reply-to-thread	在现有线程中回复，自动保持线程关联并使用正确的地址发送

标签

工具	描述
list-tags	列出所有标签及其联系人数量
create-tag	创建新标签
delete-tag	按 ID 删除标签

自定义字段

工具	描述
list-custom-fields	列出所有自定义字段
create-custom-field	创建自定义字段（按名称实现幂等）

事件

工具	描述
track-event	为联系人跟踪自定义事件；保存属性并触发流程

---

安全

• 所有操作都通过 X-Project-Id 限定在你的项目范围内——任何工具都无法读取或修改其他项目的数据
• API 密钥在静态存储时使用 SHA-256 哈希；绝不存储明文
• 速率限制为每分钟 30 个请求
• 每日邮件发送限额根据你的套餐执行

---

链接

• Mailtani
• REST API 文档
• MCP 服务文档
• 获取 API 密钥