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. 聯繫支持人員。