CRM联系人自动化服务

通过Next.js前端、OpenAI代理和MCP服务器实现与GoHighLevel CRM的集成,自动收集用户信息并创建联系人。

  • by coder-mahmud
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 coder-mahmud/ai-mcp-ghl

使用说明

MCP服务器+OpenAI代理+Next.js+GoHighLevel(GHL)集成

该项目是一个MVP,展示了以下之间的端到端流程:

  • Next.js前端
  • OpenAI代理(代理生成器)
  • 自定义MCP服务器
  • GoHighLevel(GHL)CRM

该系统从前端收集用户详细信息(姓名和电子邮件), 通过OpenAI代理处理它们,MCP服务器自动处理 创建一个 新GHL联系人.

概述

架构流程

  1. 用户在Next.js前端与聊天机器人交互。
  2. OpenAI代理会询问用户的姓名和电子邮件。
  3. 收集后,代理调用自定义MCP服务器工具。
  4. MCP服务器接收数据并触发GHL API。
  5. GoHighLevel CRM中创建了一个新联系人。
  6. 代理向用户确认操作。

🧩 技术栈

组件技术


前端Next.js(应用路由器) AI代理OpenAI代理生成器 后端协议MCP(模型上下文协议) CRM高级别API 部署本地/云

MCP服务器职责

MCP服务器公开了一个 工具 发送给接受以下内容的OpenAI代理:

{
  "name": "User Name",
  "email": "user@example.com"
}

然后:

  • 验证参数\
  • 调用GoHighLevel API\
  • 向代理返回成功/失败响应

⚙️ 安装说明

1.克隆存储库

git clone https://github.com/coder-mahmud/ai-mcp-ghl

2.安装依赖项(MCP服务器)

npm install

3.环境变量

创建一个 .env 文件:

GHL_API_KEY=your_ghl_api_key
GHL_LOCATION_ID=your_location_id

4.启动MCP服务器

npm start

🤖 将MCP服务器连接到OpenAI代理

Agent Builder内部:

  • 添加MCP服务器URL
  • 链接“add_contact”工具
  • 地图参数:
    • 名字
    • 电子邮件

🖥️ 前端(Next.js)

要运行:

npm install
npm run dev

📬 GoHighLevel集成

MCP服务器使用:

POST https://rest.gohighlevel.com/v1/contacts/
Authorization: Bearer GHL_API_KEY

有效载荷示例:

{
  "firstName": "Mahmud",
  "email": "mahmud@example.com",
  "locationId": "XXXX"
}

🧪 特点

  • ✔ 收集姓名和电子邮件\
  • ✔ AI代理触发MCP工具调用\
  • ✔ MCP服务器创建GHL联系人\
  • ✔ 全面运作MVP

🛠️ 未来的增强功能

  • 管道自动化\
  • 预约预约\
  • 多领域联系人创建\
  • 错误处理改进\
  • 日志仪表板

📄 许可证

MIT许可证。

✨ 鸣谢

由开发 马哈茂德(mahmud.linked@gmail.com)
AI代理 OpenAI代理生成器
CRM由 GoHighLevel