内容
# FluentCRM MCP 服务器
一款模型上下文协议(MCP)服务器,为 AI 助手提供 FluentCRM 电子邮件营销 API 的完全访问权限 — **48 种工具**,用于联系人管理、活动操作、完全自动化控制和 CRM 工作流程,通过自然语言。
最初由 [Milosz Zajac](https://netfly.pl) 创建,现由 [Flowtitude](https://flowtitude.com) 分叉和扩展,增加了自动化序列、智能链接、Webhook 管理、多站点支持等功能。
## 功能
- **联系人** — CRUD、按电子邮件查找、标签/列表附加-分离
- **活动** — 创建、暂停、恢复、删除电子邮件活动
- **电子邮件模板** — 列出和创建模板
- **自动化** — 完整的漏斗管理:读取序列(步骤)、创建/编辑/删除/克隆漏斗、列出可用触发器、保存自动化步骤、管理步骤中的电子邮件、查看漏斗订阅者和报告
- **Webhook** — 列出和创建 Webhook
- **智能链接** — CRUD、短代码生成、验证
- **报告** — 仪表盘统计数据、自定义字段
- **多站点** — 从单个服务器管理多个 WordPress 站点
## 可用工具(48 种)
### 联系人(6 种)
| 工具 | 描述 |
|------|-------------|
| `fluentcrm_list_contacts` | 列出所有联系人,支持分页和搜索 |
| `fluentcrm_get_contact` | 按 ID 获取联系人详细信息 |
| `fluentcrm_find_contact_by_email` | 按电子邮件地址查找联系人 |
| `fluentcrm_create_contact` | 创建新联系人(默认为订阅状态) |
| `fluentcrm_update_contact` | 更新联系人数据 |
| `fluentcrm_delete_contact` | 删除联系人 |
### 标签(5 种)
| 工具 | 描述 |
|------|-------------|
| `fluentcrm_list_tags` | 列出所有标签 |
| `fluentcrm_create_tag` | 创建新标签 |
| `fluentcrm_delete_tag` | 删除标签 |
| `fluentcrm_attach_tag_to_contact` | 将标签附加到联系人 |
| `fluentcrm_detach_tag_from_contact` | 从联系人分离标签 |
### 列表(5 种)
| 工具 | 描述 |
|------|-------------|
| `fluentcrm_list_lists` | 列出所有联系人列表 |
| `fluentcrm_create_list` | 创建新列表 |
| `fluentcrm_delete_list` | 删除列表 |
| `fluentcrm_attach_contact_to_list` | 将联系人添加到列表 |
| `fluentcrm_detach_contact_from_list` | 从列表中删除联系人 |
### 活动(5 种)
| 工具 | 描述 |
|------|-------------|
| `fluentcrm_list_campaigns` | 列出电子邮件活动 |
| `fluentcrm_create_campaign` | 创建新电子邮件活动 |
| `fluentcrm_pause_campaign` | 暂停活动活动 |
| `fluentcrm_resume_campaign` | 恢复暂停的活动 |
| `fluentcrm_delete_campaign` | 删除活动 |
### 电子邮件模板(2 种)
| 工具 | 描述 |
|------|-------------|
| `fluentcrm_list_email_templates` | 列出电子邮件模板 |
| `fluentcrm_create_email_template` | 创建新电子邮件模板 |
### 自动化(14 种)- 新增于 v1.2.0
| 工具 | 描述 |
|------|-------------|
| `fluentcrm_list_automations` | 列出所有自动化漏斗 |
| `fluentcrm_get_automation` | 获取完整的自动化详细信息,包括序列(步骤)、可用块和块字段 |
| `fluentcrm_create_automation` | 创建新自动化漏斗 |
| `fluentcrm_update_automation` | 更新自动化状态(草稿/已发布) |
| `fluentcrm_delete_automation` | 删除自动化漏斗 |
| `fluentcrm_clone_automation` | 复制漏斗及其所有序列 |
| `fluentcrm_list_triggers` | 列出所有可用的自动化触发器类型 |
| `fluentcrm_change_trigger` | 更改现有自动化的触发器 |
| `fluentcrm_save_automation_sequences` | 保存自动化所有序列(步骤)(全状态替换) |
| `fluentcrm_save_email_action` | 保存/更新发送自定义电子邮件步骤的电子邮件 |
| `fluentcrm_list_funnel_subscribers` | 列出注册到漏斗的联系人(按活动/完成/取消过滤) |
| `fluentcrm_update_funnel_subscriber_status` | 完成或取消联系人在漏斗中的运行 |
| `fluentcrm_get_automation_report` | 获取漏斗性能报告 |
| `fluentcrm_get_contact_automations` | 列出特定联系人注册的所有漏斗 |
### Webhook(2 种)
| 工具 | 描述 |
|------|-------------|
| `fluentcrm_list_webhooks` | 列出 Webhook |
| `fluentcrm_create_webhook` | 创建新 Webhook |
### 智能链接(5 种)
| 工具 | 描述 |
|------|-------------|
| `fluentcrm_list_smart_links` | 列出智能链接 |
| `fluentcrm_get_smart_link` | 获取智能链接详细信息 |
| `fluentcrm_create_smart_link` | 创建新智能链接 |
| `fluentcrm_update_smart_link` | 更新智能链接 |
| `fluentcrm_delete_smart_link` | 删除智能链接 |
### 智能链接助手(2 种)
| 工具 | 描述 |
|------|-------------|
| `fluentcrm_generate_smart_link_shortcode` | 生成智能链接短代码 |
| `fluentcrm_validate_smart_link_data` | 验证智能链接数据创建前 |
### 报告(2 种)
| 工具 | 描述 |
|------|-------------|
| `fluentcrm_dashboard_stats` | 获取仪表盘统计数据 |
| `fluentcrm_custom_fields` | 列出自定义字段 |
## 要求
- Node.js 18+
- 安装并激活 FluentCRM 的 WordPress 站点
- WordPress 应用程序密码
## 快速设置
### 1. 克隆并构建
```bash
git clone https://github.com/sabiertas/fluentcrm-mcp-server.git
cd fluentcrm-mcp-server
npm install
npm run build
```
### 2. 在 Claude Code 中配置
添加到 `~/.claude.json`:
```json
{
"mcpServers": {
"fluentcrm": {
"command": "node",
"args": ["/path/to/fluentcrm-mcp-server/dist/fluentcrm-mcp-server.js"],
"env": {
"FLUENTCRM_API_URL": "https://your-domain.com/wp-json/fluent-crm/v2",
"FLUENTCRM_API_USERNAME": "your-wp-username",
"FLUENTCRM_API_PASSWORD": "your-application-password"
}
}
}
}
```
### 多站点配置
要管理多个 WordPress 站点,请使用 `FLUENTCRM_SITES`:
```json
{
"mcpServers": {
"fluentcrm": {
"command": "node",
"args": ["/path/to/fluentcrm-mcp-server/dist/fluentcrm-mcp-server.js"],
"env": {
"FLUENTCRM_SITES": "{\"site1\":{\"url\":\"https://site1.com/wp-json/fluent-crm/v2\",\"username\":\"user1\",\"password\":\"xxxx xxxx xxxx xxxx\"},\"site2\":{\"url\":\"https://site2.com/wp-json/fluent-crm/v2\",\"username\":\"user2\",\"password\":\"yyyy yyyy yyyy yyyy\"}}"
}
}
}
}
```
然后在任何工具中传递 `site: "site1"` 或 `site: "site2"`。如果省略,则默认为第一个站点。
### 3. 在 Cursor / 其他 MCP 客户端中配置
相同的配置模式 - 请参阅客户端的 MCP 文档。
## 身份验证
使用 WordPress 应用程序密码(基本身份验证)。在以下位置创建:
`WordPress 管理后台 > 用户 > 个人资料 > 应用程序密码`
## 贡献
欢迎提交 PR。请先打开问题讨论更改。
## 许可证
MIT
MCP 配置
以下是此 MCP Server 的配置信息,可直接复制到 Cursor 或其他 MCP 客户端中使用。
mcp.json
连接信息
猜你喜欢
cc-switch
跨平台的Claude Code、Codex和Gemini CLI一体化助手。
claude-flow
Claude-Flow v2.7.0 是一个企业级AI编排平台。
awesome-claude-skills
一份精心整理的 Claude Skills、资源和工具列表,用于定制 Claude AI 工作流程
Appwrite
像数百人的团队一样构建
Anthropic-Cybersecurity-Skills
734+ 适用于 AI Agent 的结构化网络安全技能 · 已映射到 MITRE ATT&CK · agentskills.io 开放标准 · 适用于...
semantic-kernel
使用Semantic Kernel的编排框架构建和部署智能AI代理。