Smartlead MCP Server

Smartlead MCP 服务

这是一个用于 Smartlead 营销活动管理集成的模型上下文协议（MCP）服务。它提供用于创建和管理营销活动、更新营销活动设置以及管理营销活动序列的工具。

功能

• 创建新的营销活动
• 更新营销活动排期设置
• 更新营销活动常规设置
• 获取营销活动详情
• 使用筛选选项列出所有营销活动
• 管理营销活动电子邮件序列（保存、获取、更新、删除）
• 管理营销活动中的电子邮件账户（添加、更新、删除）
• 管理营销活动中的潜在客户（添加、更新、删除）

安装

1. 克隆仓库
2. 安装依赖项：

npm install

3. 根据 .env.example 创建 .env 文件，并添加 Smartlead API 密钥：

SMARTLEAD_API_KEY=your_api_key_here

4. 构建项目：

npm run build

用法

独立使用

直接启动服务：

npm start

与 Claude 集成

若要将此 MCP 服务与 Claude 配合使用，需要将其添加到 MCP 设置文件中：

1. 对于 Claude VSCode 扩展，将其添加到 c:\Users\<username>\AppData\Roaming\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json
2. 对于 Claude 桌面应用，在 Windows 上将其添加到 %APPDATA%\Claude\claude_desktop_config.json

配置示例：

{
  "mcpServers": {
    "smartlead": {
      "command": "node",
      "args": ["E:/mcp-servers/smartlead/dist/index.js"],
      "env": {
        "SMARTLEAD_API_KEY": "your_api_key_here"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

将 your_api_key_here 替换为你的 Smartlead API 密钥。

配置

可以使用环境变量配置此服务：

• SMARTLEAD_API_KEY（必需）：你的 Smartlead API 密钥
• SMARTLEAD_API_URL（可选）：自定义 API URL（默认为 https://server.smartlead.ai/api/v1）
• SMARTLEAD_RETRY_MAX_ATTEMPTS：API 调用的最大重试次数（默认值：3）
• SMARTLEAD_RETRY_INITIAL_DELAY：重试的初始延迟时间，单位为毫秒（默认值：1000）
• SMARTLEAD_RETRY_MAX_DELAY：重试的最大延迟时间，单位为毫秒（默认值：10000）
• SMARTLEAD_RETRY_BACKOFF_FACTOR：重试延迟的退避系数（默认值：2）

可用工具

smartlead_create_campaign

在 Smartlead 中创建新的营销活动。

参数：

• name（必需）：营销活动名称
• client_id（可选）：营销活动的客户端 ID

smartlead_update_campaign_schedule

更新营销活动的排期设置。

参数：

• campaign_id（必需）：要更新的营销活动 ID
• timezone：营销活动的时区（例如，“America/Los_Angeles”）
• days_of_the_week：发送电子邮件的星期几（1-7，其中 1 表示星期一）
• start_hour：开始小时，采用 24 小时制（例如，“09:00”）
• end_hour：结束小时，采用 24 小时制（例如，“17:00”）
• min_time_btw_emails：电子邮件之间的最短间隔时间，单位为分钟
• max_new_leads_per_day：每天新增潜在客户的最大数量
• schedule_start_time：排期开始时间，采用 ISO 格式

smartlead_update_campaign_settings

更新营销活动的常规设置。

参数：

• campaign_id（必需）：要更新的营销活动 ID
• name：营销活动的新名称
• status：营销活动状态（active、paused、completed）
• settings：其他营销活动设置

smartlead_get_campaign

根据 ID 获取指定营销活动的详情。

参数：

• campaign_id（必需）：要获取的营销活动 ID

smartlead_list_campaigns

列出所有营销活动，可选择应用筛选条件。

参数：

• status：按状态筛选营销活动（active、paused、completed、all）
• limit：返回的营销活动数量上限
• offset：分页偏移量

smartlead_save_campaign_sequence

为营销活动保存包含 A/B 测试变体的邮件序列。

参数：

• campaign_id（必填）：营销活动的 ID
• sequences（必填）：邮件序列项数组，每项包含：
  • id：序列的 ID（仅用于更新；创建时省略）
  • seq_number（必填）：序列编号（在序列中的顺序）
  • seq_delay_details（必填）：延迟设置，包含：
    • delay_in_days（必填）：发送此邮件前的等待天数
  • variant_distribution_type：变体分配类型（MANUAL_EQUAL、MANUAL_PERCENTAGE、AI_EQUAL）
  • lead_distribution_percentage：用于筛选获胜变体的线索池样本百分比
  • winning_metric_property：用于确定获胜变体的指标（OPEN_RATE、CLICK_RATE、REPLY_RATE、POSITIVE_REPLY_RATE）
  • seq_variants：邮件变体数组，每项包含：
    • subject（必填）：邮件主题行
    • email_body（必填）：邮件正文内容（HTML）
    • variant_label（必填）：变体标签（例如，“A”、“B”、“C”）
    • id：变体的 ID（仅用于更新；创建时省略）
    • variant_distribution_percentage：接收此变体的线索百分比
  • subject：邮件主题行（用于简单的后续邮件；留空则在同一邮件线程中发送）
  • email_body：简单后续邮件的正文内容（HTML）

smartlead_get_campaign_sequence

获取营销活动的邮件序列。

参数：

• campaign_id（必填）：营销活动的 ID

smartlead_update_campaign_sequence

更新营销活动序列中的特定邮件。

参数：

• campaign_id（必填）：营销活动的 ID
• sequence_id（必填）：要更新的序列邮件的 ID
• subject：更新后的邮件主题行
• body：更新后的邮件正文内容
• wait_days：发送此邮件前更新后的等待天数

smartlead_delete_campaign_sequence

删除营销活动序列中的特定邮件。

参数：

• campaign_id（必填）：营销活动的 ID
• sequence_id（必填）：要删除的序列邮件的 ID

smartlead_add_email_account_to_campaign

向营销活动添加邮件账户。

参数：

• campaign_id（必填）：营销活动的 ID
• email_account_id（必填）：要添加的邮件账户的 ID

smartlead_update_email_account_in_campaign

更新营销活动中的邮件账户。

参数：

• campaign_id（必填）：营销活动的 ID
• email_account_id（必填）：要更新的邮件账户的 ID
• settings：此营销活动中邮件账户的设置

smartlead_delete_email_account_from_campaign

从营销活动中移除邮件账户。

参数：

• campaign_id（必填）：营销活动的 ID
• email_account_id（必填）：要移除的邮件账户的 ID

smartlead_add_lead_to_campaign

向营销活动添加线索（一次最多 100 条）。

参数：

• campaign_id（必填）：营销活动的 ID
• lead_list（必填）：线索信息对象数组（最多 100 条），每项包含：
  • email（必填）：线索的电子邮件地址
  • first_name：线索的名字
  • last_name：线索的姓氏
  • company_name：线索所在公司的名称
  • phone_number：线索的电话号码
  • website：线索的网站
  • location：线索的位置
  • custom_fields：线索的自定义字段（最多 20 个字段）
  • linkedin_profile：线索的 LinkedIn 个人资料 URL
  • company_url：公司 URL
• settings：添加线索的设置：
  • ignore_global_block_list：如果为 true，上传的线索将绕过全局阻止列表
  • ignore_unsubscribe_list：如果为 true，线索将绕过与已取消订阅线索的比对
  • ignore_community_bounce_list：如果为 true，上传的线索将绕过整个用户群中退信的线索筛选
  • ignore_duplicate_leads_in_other_campaign：如果为 true，线索将不会绕过与其他营销活动的比对

smartlead_update_lead_in_campaign

更新营销活动中的潜在客户。

参数：

• campaign_id（必填）：营销活动的 ID
• lead_id（必填）：要更新的潜在客户 ID
• lead（必填）：更新后的潜在客户信息，包括：
  • email：潜在客户的电子邮件地址
  • first_name：潜在客户的名字
  • last_name：潜在客户的姓氏
  • company：潜在客户的公司
  • custom_variables：潜在客户的自定义变量

smartlead_delete_lead_from_campaign

从营销活动中移除潜在客户。

参数：

• campaign_id（必填）：营销活动的 ID
• lead_id（必填）：要移除的潜在客户 ID

许可证

MIT