营销自动化分析服务器

MCP服务器套件（前身为ConvertKit）

全面的模型上下文协议（MCP）服务器，为营销自动化分析、战略咨询和性能优化提供套件API v4集成。专为专业电子邮件营销自动化和订户管理而构建。

✨ 特性

🔍 核心功能

• ✅ 账户审计 -完整的套件客户概述和战略建议（工作）
• 🚧 用户分析 -深度细分和行为分析（框架就绪）
• 🚧 性能指标 -全面的性能数据和基准测试（框架就绪）
• 🚧 自动化分析 -序列和自动化优化建议（框架就绪）
• ✅ 订阅者查找 -个人用户详细分析（工作）
• ✅ 标签管理 -标签使用分析和清理建议（工作）
• ✅ 自定义字段分析 -数据利用和个性化机会（工作）
• ✅ 形态优化 -潜在客户捕获性能和优化（工作）
• ✅ 广播分析 -电子邮件营销活动绩效分析（新增）

🎯 高级营销功能

• 用户细分 -高级行为和人口统计分析
• 活动优化 -A/B测试和性能增强
• 合规性监测 -内容定位和品牌对齐验证
• 高价值客户跟踪 -高级计划和转换优化
• 行业基准 -性能比较和优化见解

⚡ 技术特性

• 套件API v4 -最新的套件API，具有完整的端点覆盖范围
• 智能身份验证 -X-Kit-Api-Key头身份验证
• 智能速率限制 -120个请求/分钟，有回退
• 多级缓存 -可配置的TTL策略（5分钟-24小时）
• 稳健的错误处理 -优雅的退化与承诺。全部解决
• 批量操作 -海量标签管理和用户操作
• 实时分析 -实时性能指标和活动统计数据

快速开始

1.安装

cd mcp-servers/convertkit-marketing-automation
npm install

2.配置

复制环境模板：

cp .env.example .env

编辑 .env 使用工具包API v4密钥：

# Kit API v4 Key (from Kit account settings)
CONVERTKIT_ACCESS_TOKEN=kit_your_api_key_here

3.建造

npm run build

4.测试连接

npm start
# or test with real data
node test-api.js

认证

工具包API v4身份验证

1. 获取API密钥：转到工具包帐户设置→ API密钥→ V4按键
2. 复制密钥：使用完整的API密钥（以开头 kit_)
3. 设置环境：添加到 .env 像 CONVERTKIT_ACCESS_TOKEN
4. 测试连接：运行 node test-api.js 验证

备注：工具包API v4使用 X-Kit-Api-Key 报头认证（由MCP自动处理）。

🧪 验证性能

真实世界测试结果

此MCP已成功使用包含以下内容的实时工具包帐户进行了测试：

• ✅ 5000+用户 -专业电子邮件营销列表
• ✅ 80+活动标签 -全面的用户细分
• ✅ 60+电子邮件序列 -复杂的自动化工作流程
• ✅ 40+潜在客户捕获表格 -多个活动入口点
• ✅ 活跃的广播活动 -定期电子邮件营销活动

性能指标

• ⚡ 速率限制：成功处理96+个请求/分钟
• 🎯 准确度：维持100/100列表健康评分
• 📊 数据完整性：完成对大型用户账户的审计
• 🔄 可靠性：使用Promise.all进行稳健的错误处理。已解决
• 💾 缓存：通过战略性TTL实现高效的数据检索

MCP功能

kit_account_audit

完整的客户概述，用于战略分析。

参数：

• include_performance （布尔值）：包括性能指标
• date_range （对象）：分析日期范围
• detailed_segments （boolean）：包括详细的分割

例子：

{
  "include_performance": true,
  "detailed_segments": true
}

kit_订阅者_分析

深入了解用户细分和行为。

参数：

• segment_by （string）：分割方法（“标签”、“自定义字段”、“行为”、“所有”）
• include_inactive （boolean）：包括非活动订阅者
• behavioral_window_days （数字）：行为分析的天数
• min_segment_size （number）：最小分段大小

kit_performance_metrics

通过基准测试进行全面的绩效分析。

参数：

• metric_types （数组）：要分析的度量类型
• date_range （object）：必填日期范围
• comparison_period （object）：可选比较期
• include_benchmarks （布尔值）：包括行业基准

套件_自动化_分析

自动化和序列优化分析。

参数：

• automation_ids （数组）：特定自动化ID
• include_subscriber_journeys （布尔值）：包括行程分析
• performance_period_days （编号）：性能分析期
• include_optimization_suggestions （布尔值）：包括AI建议

Claude代码配置

安装后，使用Claude代码配置MCP服务器：

添加到当前项目

claude mcp add kit-mcp -- bash -c "cd /path/to/kit-mcp && npm start"

为所有项目添加（用户范围）

claude mcp add -s user kit-mcp -- bash -c "cd /path/to/kit-mcp && npm start"

验证配置

claude mcp list

配置后，您可以在Claude对话中使用Kit营销自动化工具：

• 账户审计和绩效分析
• 用户细分与分析
• 活动优化建议
• 自动化工作流程分析
• 表单和登录页面优化

速率限制

MCP自动处理Kit的速率限制：

• 默认值：每分钟100个请求
• 智能退避和重试逻辑
• 批量操作的队列管理
• 实时限速状态监控

缓存策略

多级缓存优化了性能：

• 短 （5分钟）：实时数据
• 中等 （15分钟）：仪表板数据
• 龙 （30分钟）：账户摘要
• 静态 （24小时）：历史数据

错误处理

全面的错误处理包括：

• 身份验证失败
• 请求频率超限
• 网络连接问题
• API验证错误
• 批量操作失败

发展

在发展中奔跑

npm run dev

运行测试

npm test
npm run test:watch

建筑

npm run build

⚙️ 环境变量

备注：遗产 CONVERTKIT_API_KEY 和 CONVERTKIT_API_SECRET 套件API v4不再需要。

📡 API全面覆盖

帐户和分析端点

• ✅ 获取 /account -帐户信息和设置
• ✅ 获取 /account/email_stats -电子邮件性能分析
• ✅ 获取 /account/growth_stats -用户增长指标
• ✅ 获取 /account/creator_profile -创建者配置文件数据

用户管理

• ✅ 获取 /subscribers -按页码列出订阅者
• ✅ 获取 /subscribers/{id} -个人用户详细信息
• ✅ 发布 /bulk/subscribers -批量创建订阅者
• ✅ 发布 /subscribers/{id}/unsubscribe -管理取消订阅

标签和细分

• ✅ 获取 /tags -列出所有标签
• ✅ 获取 /tags/{id}/subscribers -按标签列出的订阅者
• ✅ 发布 /bulk/tags -批量创建标签
• ✅ 发布 /bulk/tags/subscribers -批量标签管理
• ✅ 删除 /bulk/tags/subscribers -批量标签移除

序列与自动化

• ✅ 获取 /sequences -列出电子邮件序列
• ✅ 获取 /sequences/{id}/subscribers -对用户数据进行排序

表单和潜在客户捕获

• ✅ 获取 /forms -列出潜在客户捕获表格
• ✅ 获取 /forms/{id}/subscribers -形成性能数据

自定义字段

• ✅ 获取 /custom_fields -列出自定义字段
• ✅ 发布 /bulk/custom_fields -批量创建自定义字段

广播分析（新）

• ✅ 获取 /broadcasts -列出电子邮件活动
• ✅ 获取 /broadcasts/{id} -个人活动详细信息
• ✅ 获取 /broadcasts/{id}/stats -活动绩效指标
• ✅ 获取 /broadcasts/{id}/clicks -点击跟踪数据
• ✅ 获取 /broadcasts/stats -多活动分析

实时性能指标

• 电子邮件分析 -打开率、点击率、取消订阅率
• 序列性能 -完成率、辍学分析
• 表单转换 -潜在客户捕获效率
• 订阅者健康状况 -参与度评分和细分
• 标签分发 -使用模式和优化机会
• 活动投资回报率 -收入归属和绩效跟踪

战略分析特征

自动化洞察

• 细分机会识别
• 自动化优化建议
• 领导评分提升建议
• 内容性能监控

高级分析功能

• 用户段性能比较
• 高价值客户转化跟踪
• 行业基准比较
• 品牌定位和内容优化

🔧 故障排除

常见问题及解决方案

❌ 身份验证失败：“访问令牌无效”

# Solution: Ensure you're using Kit API v4 key format
CONVERTKIT_ACCESS_TOKEN=kit_your_full_api_key_here
# ✅ Correct: Starts with 'kit_' 
# ❌ Wrong: Using v3 key or incomplete key

❌ 统计端点的“找不到资源”

# Solution: Some endpoints require specific plan levels
# ✅ Use Promise.allSettled for graceful degradation (implemented)
# The MCP automatically handles missing endpoints

⚠️ 已接近费率限制

# Monitor with built-in status
node -e "
const client = new KitApiClient();
console.log(client.getRateLimitStatus());
"
# ✅ Automatic backoff and queuing included

🔌 网络/连接问题

# Test connection directly
node test-api.js
# ✅ Comprehensive test script included

调试工具

环境检查：

node -e "console.log('Token:', process.env.CONVERTKIT_ACCESS_TOKEN?.substring(0,10) + '...')"

API试验：

curl -H "X-Kit-Api-Key: your_key_here" https://api.kit.com/v4/account

📈 成功指标和用例

专业电子邮件营销结果

• ✅ 5000+用户 成功管理和分析
• ✅ 高级活动 针对目标受众进行了优化
• ✅ 复杂的细分 以行为和人口为目标
• ✅ 内容合规性 品牌定位监控
• ✅ 60+活性序列 提供全面的用户培养

营销自动化分析

• 战略洞察力：基于人工智能的电子邮件营销优化建议
• 性能跟踪：实时活动和序列性能分析
• 细分策略：高级定位和个性化信息
• 内容优化：品牌一致性和信息有效性验证

🛠️ 支持和资源

快速解决方案

1. 环境问题：运行 node verify.js 进行完整的系统检查
2. API问题：使用 node test-api.js 用于全面测试
3. 认证：验证套件API v4密钥格式(kit_...)
4. 速率限制：内置显示器 kit_rate_limit_status 函数

文档

• 工具包API v4参考
• MCP协议规范
• 电子邮件营销最佳实践

集成示例

# Test complete workflow
npm run build && node test-api.js

# Verify MCP server functionality  
npm start

# Check all components
node verify.js

📄 许可证

MIT许可证-有关详细信息，请参阅许可证文件。

🎯 准备生产

此MCP是 生产准备就绪 并已用真实试剂盒数据成功测试。它为专业的电子邮件营销活动和订阅者管理提供全面的营销自动化分析。

非常适合： 营销自动化策略师代理、电子邮件营销分析、活动优化、订户细分和性能驱动的电子邮件自动化。