ActiveCampaign API服务器

生产级的ActiveCampaign API服务器,提供33种工具用于联系人、交易、自动化、标签、管道、营销活动、自定义字段、账户和Webhooks的管理。

  • by AlexlaGuardia
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 AlexlaGuardia/MCP-Activecampaign

使用说明

mcp活动

用于ActiveCampaignneneneba API的生产级MCP服务器- 33工具 用于联系人、交易、自动化、标签、管道、活动、自定义字段、帐户和webhooks。

ActiveCampaign 185000多名客户的第一台MCP服务器。

特性

  • 联系人 --列出、获取、创建、更新、删除和搜索联系人
  • 交易 --全面的CRM交易管理,提供渠道和阶段支持
  • 标签 --创建标签并管理联系人标签关联
  • 列表 --查看邮件列表和订阅者数量
  • 自动化 --列出自动化并将联系人添加到工作流中
  • 管道和阶段 --查看交易管道及其阶段
  • 自定义字段 --列出字段,获取/设置每个联系人的值
  • 活动 --查看电子邮件活动详细信息和绩效指标
  • 账户 --管理B2B公司记录
  • 网络钩子 --创建、列出和删除webhook订阅
  • 速率限制 --内置5个req/s油门(ActiveCampaign的限制)
  • 自动重试 --对429个响应自动重试

快速开始

安装

pip install mcp-activecampaign

配置

从获取API URL和密钥 设置>开发人员 在您的ActiveCampaign帐户中。

克劳德桌面

添加 ~/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公司记录
网络钩子 list_webhooks, create_webhook, delete_webhook 活动订阅

API注释

  • 认证:API密钥通过 Api-Token header(不需要OAuth)
  • 速率限制:每个帐户每秒5个请求(自动处理)
  • 分页:基于偏移量--支持所有列表工具 limit 和 offset 参数
  • 自动化:通过API只读-您可以列出和注册联系人,但不能创建或编辑工作流
  • 活动:主要通过API只读-查看详细信息和指标

发展

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

许可证

麻省理工学院