fluentcrm-mcp-server

🚀 FluentCRM MCP Server

FluentCRM的MCP服务器 - 直接从Cursor管理您的整个营销自动化！

🚀 快速开始

本MCP服务器允许您直接在Cursor中与Claude对话时，管理FluentCRM的各项功能。以下是使用前的准备和操作步骤。

✨ 主要特性

MCP协议支持

MCP（模型上下文协议）是Anthropic推出的新标准，允许AI模型（包括Cursor中的Claude）连接到外部系统。

丰富管理功能

• 管理标签：创建、删除标签，并将标签分配给联系人。
• 编辑列表：创建列表，添加或移除联系人。
• 创建活动：向用户细分群体发送电子邮件。
• 自动化管理：管理漏斗（自动化流程）。
• Webhook配置：为FluentCRM配置Webhook。
• 报告统计：获取统计数据和指标。
• 智能链接管理：当API可用时，管理智能链接。

📦 安装指南

步骤1：克隆仓库或复制文件

cd /path/to/your/fluentcrm-mcp-server

步骤2：安装依赖

npm install

步骤3：构建TypeScript

npm run build

你应该看到如下输出：

✅ dist/fluentcrm-mcp-server.js (compiled)

步骤4：测试连接

export FLUENTCRM_API_USERNAME="your_username"
export FLUENTCRM_API_PASSWORD="your_password"
npm start

你应该看到如下输出：

🚀 FluentCRM MCP Server running on stdio
📡 API URL: https://your-domain.com/wp-json/fluent-crm/v2
👤 Username: your_username

按 CTRL+C 停止。

🔧 配置说明

1. 从FluentCRM获取API凭证

详细步骤如下：

1. 登录WordPress：https://your-domain.com/wp-admin
2. 进入：FluentCRM → 设置 → 管理器
3. 点击 添加新管理器
4. 输入：
   • 名称：MCP Server（或其他名称）
   • 角色：订阅者（足够）
   • 权限：勾选所有FluentCRM权限
5. 点击 保存管理器
6. 进入：FluentCRM → 设置 → Rest API
7. 点击 创建新密钥
8. 选择你刚刚创建的管理器
9. 点击 确认
10. 复制：
    • 用户名（API_USERNAME）
    • 应用密码（API_PASSWORD）

2. 设置环境变量

选项A：编辑 .env 文件

# .env
FLUENTCRM_API_USERNAME=your_api_username
FLUENTCRM_API_PASSWORD=your_api_password
FLUENTCRM_API_URL=https://your-domain.com/wp-json/fluent-crm/v2

选项B：从终端导出

export FLUENTCRM_API_USERNAME="your_api_username"
export FLUENTCRM_API_PASSWORD="your_api_password"

3. Cursor配置（MCP）

1. 打开Cursor
2. 按下 Cmd+Shift+P（macOS）或 Ctrl+Shift+P（Windows/Linux）
3. 搜索：“MCP设置” 或 “首选项：打开MCP设置”
4. 编辑配置文件：

{
  "mcpServers": {
    "fluentcrm": {
      "command": "node",
      "args": [
        "/path/to/your/fluentcrm-mcp-server/dist/fluentcrm-mcp-server.js"
      ],
      "env": {
        "FLUENTCRM_API_USERNAME": "your_api_username",
        "FLUENTCRM_API_PASSWORD": "your_api_password",
        "FLUENTCRM_API_URL": "https://your-domain.com/wp-json/fluent-crm/v2"
      }
    }
  }
}

5. 保存并重启Cursor

💻 使用示例

基础用法

配置完成后，在Cursor中打开聊天窗口并开始提问！

Show me all tags in FluentCRM

Claude将自动使用MCP服务器并返回标签列表。

高级用法

示例1：显示所有标签

在Cursor中输入：

Show me all tags in FluentCRM

Claude将返回：

✅ Fetching tags from FluentCRM...

Found the following tags:
1. registered (ID: 1)
2. webinar-jit (ID: 2)
3. progress-75 (ID: 3)
4. participated (ID: 4)
... and 47 more

示例2：创建新标签

在Cursor中输入：

Create tag "hot-lead" with description "People who watched 75%+ and are interested"

Claude将自动执行以下操作：

1. 使用 fluentcrm_create_tag 工具
2. 返回确认信息

示例3：将标签分配给联系人

在Cursor中输入：

Assign tag "progress-75" to contact with email "jan@example.com"

Claude将执行以下操作：

1. 通过电子邮件查找联系人
2. 分配标签
3. 返回确认信息

示例4：创建列表

在Cursor中输入：

Create new list "Hot-leads" with description "Participants who watched 75%+ of webinar"

Claude将创建该列表

示例5：将联系人添加到列表

在Cursor中输入：

Add all contacts with tag "progress-75" to list "Hot-leads"

📚 详细文档

可用工具

👤 联系人（订阅者）

• fluentcrm_list_contacts - 获取联系人列表
• fluentcrm_get_contact - 获取联系人详情
• fluentcrm_find_contact_by_email - 通过电子邮件搜索
• fluentcrm_create_contact - 创建新联系人
• fluentcrm_update_contact - 更新联系人信息
• fluentcrm_delete_contact - 删除联系人

🏷️ 标签

• fluentcrm_list_tags - 获取所有标签
• fluentcrm_create_tag - 创建新标签
• fluentcrm_delete_tag - 删除标签
• fluentcrm_attach_tag_to_contact - 将标签分配给联系人
• fluentcrm_detach_tag_from_contact - 从联系人移除标签

📋 列表

• fluentcrm_list_lists - 获取所有列表
• fluentcrm_create_list - 创建新列表
• fluentcrm_delete_list - 删除列表
• fluentcrm_attach_contact_to_list - 将联系人添加到列表
• fluentcrm_detach_contact_from_list - 从列表移除联系人

📧 活动

• fluentcrm_list_campaigns - 获取活动列表
• fluentcrm_create_campaign - 创建活动
• fluentcrm_pause_campaign - 暂停活动
• fluentcrm_resume_campaign - 恢复活动
• fluentcrm_delete_campaign - 删除活动

📨 电子邮件模板

• fluentcrm_list_email_templates - 获取模板列表
• fluentcrm_create_email_template - 创建模板

🤖 自动化

• fluentcrm_list_automations - 获取自动化（漏斗）列表
• fluentcrm_create_automation - 创建自动化

🔗 Webhook

• fluentcrm_list_webhooks - 获取Webhook列表
• fluentcrm_create_webhook - 创建Webhook

📊 报告

• fluentcrm_dashboard_stats - 仪表盘统计数据
• fluentcrm_custom_fields - 自定义字段

API参考

FluentCRM API文档：https://rest-api.fluentcrm.com/#introduction

🔧 技术细节

系统要求

• ✅ Node.js 18+
• ✅ npm 或 yarn
• ✅ 访问FluentCRM API（你的WordPress域名）
• ✅ 支持MCP的Cursor
• ✅ 来自FluentCRM的API密钥（在设置 → Rest API中生成）

📄 许可证

本项目采用MIT许可证。

作者信息

Miłosz Zając
🌐 www.netfly.pl

日期：2025-01-20
版本：1.0.0

Made with ❤️ by Miłosz Zając

问题排查

❌ 错误：“Authorization failed”

原因：API用户名或密码错误。 解决方案：

1. 进入FluentCRM → 设置 → Rest API
2. 检查API密钥是否激活
3. 再次复制凭证
4. 更新 .env 文件

❌ 错误：“Connection refused”

原因：FluentCRM API不可用。 解决方案：

1. 检查你的WordPress域名是否可访问
2. 执行 ping your-domain.com
3. 检查WordPress是否正在运行

❌ MCP服务器无法启动

原因：缺少依赖项。 解决方案：

npm install
npm run build

❌ Cursor无法识别MCP服务器

原因：文件路径错误或缺少API凭证。 解决方案：

1. 检查MCP配置中的路径（~/.cursor/settings.json）
2. 检查文件 dist/fluentcrm-mcp-server.js 是否存在
3. 重启Cursor
4. 检查日志：cat ~/.cursor/logs.txt

安全提示

⚠️ 重要提示

• 切勿将包含真实凭证的 .env 文件提交到git。
• 切勿公开共享API密钥。
• 建议使用环境变量，而不是硬编码。
• 定期轮换API密钥。

支持与更新

更新MCP服务器

cd fluentcrm-mcp-server
git pull  # 或手动下载最新版本
npm install
npm run build

重启Cursor。

遇到问题

1. 查看问题排查部分。
2. 查看FluentCRM日志：FluentCRM → 日志。
3. 查看Cursor日志：~/.cursor/logs.txt。
4. 联系支持人员。