FluentCRM MCP

🚀 FluentCRM MCP服务器

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

______________________________________________________________________

📋 目录

• 什么是MCP服务器？
• 需求
• 安装
• 配置
• 用法
• 可用工具
• 例子
• 故障排除

______________________________________________________________________

什么是MCP服务器？

主控程序 （模型上下文协议）是Anthropic的一项新标准，允许AI模型（包括Cursor中的Claude）连接到外部系统。

此MCP服务器允许您：

✅ 管理标签 -创建、删除、分配联系人\ ✅ 编辑列表 -创建列表，添加/删除联系人\ ✅ 创建活动 -向用户群发送电子邮件\ ✅ 自动化 -管理漏斗（自动化）\ ✅ 网络钩子 -将webhooks配置为FluentCRM\ ✅ 报告 -获取统计数据和指标\ ✅ 智能链接 -管理智能链接（当API可用时）

一切都直接来自Cursor，与Claude对话！

______________________________________________________________________

需求

• ✅ Node.js 18+
• ✅ npm或纱线
• ✅ 访问FluentRM API（您的WordPress域）
• ✅ 支持MCP的光标
• ✅ FluentRM中的API密钥（在设置中生成→ 其余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.从FluentRM获取API证书

一步一步地：

1. 登录WordPress： https://your-domain.com/wp-admin

1. 首选 FluentCRM→ 设置→ 经理

1. 点击 添加新经理

1. 输入：

- 姓名： MCP Server （或者别的什么） - 角色： Subscriber （足够） - 权限：检查所有FluentCRM权限

1. 点击 保存管理器

1. 首选 FluentCRM→ 设置→ REST API

1. 点击 创建新密钥

1. 选择您刚刚创建的经理

1. 点击 确认

1. 副本：

- 用户名 （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.光标配置（MCP）

1. 打开的游标
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"
      }
    }
  }
}

1. 保存并重新启动游标

______________________________________________________________________

用法

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

简单问题：

Show me all tags in FluentCRM

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

______________________________________________________________________

可用工具

👤 联系人（订阅者）

• 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 -创建自动化

🔗 网络钩子

• fluentcrm_list_webhooks -获取webhooks
• fluentcrm_create_webhook -创建webhook

📊 报告

• fluentcrm_dashboard_stats -仪表板统计信息
• fluentcrm_custom_fields -自定义字段

______________________________________________________________________

例子

示例1：显示所有标签

在光标中：

Show me all tags in FluentCRM

克劳德将返回：

✅ 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：创建新标签

在光标中：

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

克劳德自动：

1. 用途 fluentcrm_create_tag 工具
2. 返回确认

示例3：为联系人分配标签

在光标中：

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

克劳德：

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

示例4：创建列表

在光标中：

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

Claude创建列表

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

在光标中：

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

______________________________________________________________________

故障排除

❌ 错误：“授权失败”

原因：API用户名或密码错误

解决方案：

1. 转到FluentCRM→ 设置→ REST API
2. 检查API密钥是否处于活动状态
3. 再次复制凭据
4. 更新 .env 文件

❌ 错误：“连接被拒绝”

原因：FluentRM API不可用

解决方案：

1. 检查您的WordPress域名是否可访问
2. 发出砰的声响： ping your-domain.com
3. 检查WordPress是否正在运行

❌ MCP服务器无法启动

原因：缺少依赖项

解决方案：

npm install
npm run build

❌ 光标看不到MCP服务器

原因：文件路径错误或缺少API凭据

解决方案：

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

______________________________________________________________________

api参考

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

______________________________________________________________________

安全

⚠️ 重要：

• ❌ 永不 提交 .env 拥有git的真实凭据
• ❌ 永不 公开共享API密钥
• ✅ 使用环境变量而不是硬编码
• ✅ 定期旋转API键

______________________________________________________________________

更新

要更新MCP服务器，请执行以下操作：

cd fluentcrm-mcp-server
git pull  # or download latest version manually
npm install
npm run build

重新启动游标。

______________________________________________________________________

支持

如果您遇到问题：

1. 检查 故障排除 章节
2. 检查FluentCRM日志：FluentCRM→ Logs
3. 检查游标日志： ~/.cursor/logs.txt
4. 联系支持

______________________________________________________________________

许可证

麻省理工学院

______________________________________________________________________

作者

爱的兔子\ 🌐 www.netfly.pl

日期: 2025-01-20\ 版本: 1.0.0

______________________________________________________________________

由...制作❤️ 作者：米奥斯·扎扬克