项目简介

SmartLead MCP 服务器是专为冷邮件营销自动化设计的 Model Context Protocol (MCP) 服务器，它将 SmartLead 平台强大的营销功能（如活动管理、线索追踪、邮件送达率优化、数据分析等）封装为标准化的 MCP 工具，允许 LLM 客户端（如 Claude Desktop, Cursor, Windsurf, Continue.dev）通过 JSON-RPC 协议进行无缝调用和交互。借助此服务器，您可以利用 AI 智能地管理和优化您的冷邮件营销活动。

主要功能点

活动管理: 创建、更新、暂停、启动或删除冷邮件营销活动，管理活动日程和详细设置。
线索管理: 添加、更新、暂停、恢复或删除营销活动中的线索，并支持批量导入和管理全局黑名单。
邮件账户管理: 管理邮件发送账户，包括配置、暖身设置、连接测试和健康度监控。
智能送达优化: 执行手动或自动化邮件送达测试、垃圾邮件测试，获取送达报告和详细诊断（如 DKIM, SPF, rDNS）。
数据分析与报告: 获取全面的营销活动统计数据、线索表现、邮件账户健康度、团队绩效等，支持按日期范围和多种维度进行分析。
Webhook 集成: 配置和管理活动Webhook，实现与外部系统的实时事件通知，并支持失败事件重试。
客户端与智能发件人管理: （根据配置可选）管理SmartLead子客户端和API密钥，以及智能发件人（Smart Senders）的域名、邮箱生成和订单管理。

安装步骤

Node.js 环境: 确保您的机器上已安装 Node.js (推荐 LTS 版本)。
安装 MCP 服务器: 打开您的终端或命令行工具，运行以下命令进行安装和启动：
```
npx smartlead-mcp-server
```
此命令会下载并运行最新版本的 SmartLead MCP 服务器。
配置 API 密钥: 服务器启动时会要求您配置 SmartLead API 密钥。您可以将 API 密钥设置为环境变量 'SMARTLEAD_API_KEY'，或者在项目根目录创建 '.env' 文件，内容如下：
```
SMARTLEAD_API_KEY=your_actual_smartlead_api_key_here
```
请替换 'your_actual_smartlead_api_key_here' 为您在 SmartLead 账户中获取的实际 API 密钥。

启用高级/管理工具 (可选): 默认情况下，服务器仅加载核心工具。若需启用更多高级或管理功能，请设置以下环境变量：

# 启用智能送达、全局分析、Webhook 工具
export SMARTLEAD_ADVANCED_TOOLS=true
# 启用客户端管理、智能发件人工具
export SMARTLEAD_ADMIN_TOOLS=true

或者在 '.env' 文件中添加相应配置。

服务器配置 (面向 MCP 客户端)

以下是一个 JSON 格式的 MCP 客户端配置示例，用于连接 SmartLead MCP 服务器。MCP 客户端（如 Cursor, Claude Desktop）需要这些信息来启动和连接服务器进程。

{
  "name": "SmartLead MCP 服务器",
  "description": "通过 Model Context Protocol 访问 SmartLead 冷邮件营销功能。",
  "command": "npx",
  "args": ["smartlead-mcp-server"],
  "env": {
    "SMARTLEAD_API_KEY": "your_actual_smartlead_api_key_here",
    "SMARTLEAD_ADVANCED_TOOLS": "true",
    "SMARTLEAD_ADMIN_TOOLS": "true"
  },
  "protocols": ["stdio"]
}

'name': 显示在 MCP 客户端中的服务器名称。
'description': 服务器的简要描述。
'command': 启动服务器的命令，这里是 'npx'。
'args': 传递给命令的参数，这里是 'smartlead-mcp-server'。
'env': 重要的环境变量配置，必须包含您的 'SMARTLEAD_API_KEY'。可以按需添加 'SMARTLEAD_ADVANCED_TOOLS' 和 'SMARTLEAD_ADMIN_TOOLS' 来启用更多功能。
'protocols': 服务器支持的通信协议，当前为 'stdio'。

基本使用方法

一旦 MCP 服务器成功启动并连接到您的 MCP 客户端，您可以通过客户端的自然语言界面或工具调用功能来使用 SmartLead 的各项能力：

查询营销活动: 您可以询问“列出我所有状态为‘活跃’的营销活动”，MCP 客户端将调用 'smartlead_list_campaigns' 工具并返回结果。
创建新活动: 您可以指示“创建一个名为‘冬季促销’的新营销活动”，MCP 客户端将调用 'smartlead_create_campaign' 工具。
追踪线索: 您可以要求“查找邮件地址为 [email protected] 的线索信息”，MCP 客户端将使用 'smartlead_fetch_lead_by_email' 工具。
获取分析报告: 您可以请求“获取‘假日特惠’营销活动在过去 30 天的整体统计数据”，MCP 客户端将调用 'smartlead_get_campaign_statistics_by_date_range' 或其他相关分析工具。

通过与 MCP 客户端的智能交互，您可以无需直接编写代码，即可利用 SmartLead 的强大功能来管理您的冷邮件营销策略。

关键词

项目简介

主要功能点

安装步骤

服务器配置 (面向 MCP 客户端)

基本使用方法

信息