ActiveCampaign MCP Server

mcp-activecampaign

面向 ActiveCampaign API 的生产级 MCP 服务——提供 33 个工具，用于联系人、交易、自动化、标签、销售管道、营销活动、自定义字段、账户和 Webhook。

首个面向 ActiveCampaign 逾 185,000 名客户的 MCP 服务。

功能

• 联系人 — 列出、获取、创建、更新、删除和搜索联系人
• 交易 — 全面的 CRM 交易管理，支持销售管道和阶段
• 标签 — 创建标签并管理联系人与标签之间的关联
• 列表 — 查看邮件列表和订阅者数量
• 自动化 — 列出自动化流程并将联系人添加到工作流
• 销售管道和阶段 — 查看交易销售管道及其阶段
• 自定义字段 — 列出字段，并获取/设置每位联系人的字段值
• 营销活动 — 查看电子邮件营销活动详情和效果指标
• 账户 — 管理 B2B 公司记录
• Webhook — 创建、列出和删除 Webhook 订阅
• 速率限制 — 内置每秒 5 个请求的限流机制（ActiveCampaign 的限制）
• 自动重试 — 收到 429 响应时自动重试

快速开始

安装

pip install mcp-activecampaign

配置

在 ActiveCampaign 账户的 Settings > Developer 中获取 API URL 和密钥。

Claude Desktop

添加到 ~/Library/Application Support/Claude/claude_desktop_config.json：

{
  "mcpServers": {
    "activecampaign": {
      "command": "mcp-activecampaign",
      "env": {
        "ACTIVECAMPAIGN_URL": "https://youraccountname.api-us1.com",
        "ACTIVECAMPAIGN_API_KEY": "your-api-key"
      }
    }
  }
}

环境变量

export ACTIVECAMPAIGN_URL="https://youraccountname.api-us1.com"
export ACTIVECAMPAIGN_API_KEY="your-api-key"
mcp-activecampaign

工具（33 个）

类别	工具	备注
账户	ping	连接测试
联系人	list_contacts、get_contact、create_contact、update_contact、delete_contact、search_contacts	完整的 CRUD 和搜索功能
交易	list_deals、get_deal、create_deal、update_deal、delete_deal	完整的 CRUD，支持销售管道/阶段筛选
标签	list_tags、create_tag、add_tag_to_contact、remove_tag_from_contact	联系人标签管理
列表	list_lists、get_list	邮件列表
自动化	list_automations、get_automation、add_contact_to_automation	读取和添加联系人（API 限制：无法创建自动化流程）
销售管道	list_pipelines、list_stages	交易销售管道结构
自定义字段	list_custom_fields、get_field_values、set_field_value	联系人自定义数据
营销活动	list_campaigns、get_campaign	只读（API 限制）
账户	list_accounts、get_account	B2B 公司记录
Webhook	list_webhooks、create_webhook、delete_webhook	事件订阅

API 说明

• 身份验证：通过 Api-Token 标头使用 API 密钥（无需 OAuth）
• 速率限制：每个账户每秒 5 个请求（自动处理）
• 分页：基于偏移量——所有列表工具均支持 limit 和 offset 参数
• 自动化：通过 API 只能读取——可以列出自动化流程并添加联系人，但无法创建或编辑工作流
• 营销活动：通过 API 基本上只能读取——可查看详情和指标

开发

git clone https://github.com/AlexlaGuardia/mcp-activecampaign.git
cd mcp-activecampaign
pip install -e ".[dev]"
pytest

许可证

MIT