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