内容
# Smartlead MCP Server
这是一个用于Smartlead活动管理集成的模型上下文协议(Model Context Protocol,MCP)服务器。它提供了创建和管理活动、更新活动设置以及管理活动序列的工具。
## 特性
- 创建新活动
- 更新活动日程设置
- 更新活动一般设置
- 获取活动详情
- 列出所有活动并提供过滤选项
- 管理活动电子邮件序列(保存、获取、更新、删除)
- 管理活动中的电子邮件账户(添加、更新、删除)
- 管理活动中的潜在客户(添加、更新、删除)
## 安装
1. 克隆代码库
2. 安装依赖:
```bash
npm install
```
3. 根据`.env.example`创建一个`.env`文件,并添加你的Smartlead API密钥:
```
SMARTLEAD_API_KEY=your_api_key_here
```
4. 构建项目:
```bash
npm run build
```
## 使用
### 独立使用
要直接启动服务器:
```bash
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`
示例配置:
```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
连接信息
猜你喜欢
cc-switch
跨平台的Claude Code、Codex和Gemini CLI一体化助手。
claude-flow
Claude-Flow v2.7.0 是一个企业级AI编排平台。
awesome-claude-skills
一份精心整理的 Claude Skills、资源和工具列表,用于定制 Claude AI 工作流程
liki
Liki — 专业命理 Skill:天文历算引擎排盘,断语附经典出处,结论可验证。八字 · 紫微 · 六爻 · 奇门 · 黄历择日 · 风水 · 起名...
dna-memory
本地优先的 AI Agent 统一记忆层:Codex、Claude Code、Hermes 共用一套 Markdown 记忆|Local-first...
awesome-ai-reverse-engineering
Open-source AI reverse engineering tools for coding agents: Ghidra MCP, IDA...