使用说明

GoHighLevel MCP服务器（兼容克劳德代码的分叉）

这是一个定制的部署原始GoHighLevel MCP服务器，专门适用于Claude Code和ChatGPT集成，具有完整的GoHighLevel API覆盖范围。

🛠 该fork使用完整的GoHighLevel API集成（253个工具）取代了原始的mock工具，并包括用于Render的生产就绪部署配置。

📋 特性

🎯 完成GoHighLevel集成

253工具：API全面覆盖所有GHL模块
实时：用于实时通信的服务器发送事件（SSE）
已验证：基于API密钥的安全身份验证
生产就绪：部署在具有自动缩放功能的Render上

🧩 MCP协议支持

符合标准：MCP协议2024-11-05
JSON-RPC 2.0：标准请求/响应格式
工具发现：自动工具列表和自检
错误处理：全面的错误报告

🔧 可用工具类别

🎯 联系人管理（31工具）

BASIC：创建、搜索、获取、更新、删除联系人
标签：添加/删除联系人标签，批量标签操作
任务：获取、创建、更新、删除联系人任务
后记：获取、创建、更新、删除联系人备注
高级：追加销售、重复检查、业务关联
批量：批量标记更新、业务分配
追随者：添加/删除联系人关注者
运动：向活动添加联系人/从活动中删除联系人
工作流：在工作流中添加/删除联系人
任命：获取联系预约

💬 消息和对话（20个工具）

BASIC：send_sms，send_email-向联系人发送消息
对话：搜索、获取、创建、更新、删除对话
信息：获取个人消息、电子邮件、上传附件
状态：更新邮件传递状态，监视最近的活动
手册：添加入站消息，手动添加出站呼叫
记录：获取通话录音、转录、下载转录
调度：取消预定的消息和电子邮件
实时聊天：键入实时对话的指示器

📝 博客管理（7工具）

create_blog_post、update_blog_posts、get_blog_post
get_blog_sites、get_blog_authors、get_blog_categories
check_url_slug-验证url段的可用性

💰 机会管理（10个工具）

搜索：search_oppounities-按管道、阶段、状态、联系人搜索
输油管道：get_pipelines-获取所有销售渠道和阶段
增删改查：创建、获取、更新、删除商机
状态：update_opportunity_status-快速状态更新（赢/输）
更新插入：upstart_opportunity-基于联系人智能创建/更新
追随者：添加/删除商机通知的关注者

🗓 日历和约会（14个工具）

get_calendar_groups、get_calendars、create_calendars
获取日历、更新日历、删除日历
get_calendar_events，get_free_slots
创建应用程序、获取应用程序、更新应用程序、删除应用程序
create_block_slot，update_block_slots

📧 电子邮件营销（5个工具）

get_email_campigns、create_email_template、get_email_templates
更新电子邮件模板，删除电子邮件模板

🏢 位置管理（18工具）

search_location、get_location、create_location、update_location、delete_location
get_location_tag、create_location_tag、update_loction_tag、delete_location_tags
search_location_tasks、自定义字段管理、模板、时区

📱 社交媒体发帖（16个工具）

帖子：搜索、创建、获取、更新、删除社交帖子
批量：批量删除一次最多50个帖子
账户：获取已连接的帐户，删除连接
CSV文件：通过CSV上传批量帖子，管理导入状态
组织：内容组织的类别和标记
认证：启动OAuth流，获取平台帐户
平台：谷歌、脸书、Instagram、领英、推特、TikTok

💳 支付管理（15个工具）

积分：创建/列出白标支付集成
订单：list_orders，get_order_by_id-管理客户订单
实现：创建/列出订单履行情况并跟踪
交易：列出/获取付款交易和历史记录
订阅费：列出/获取定期付款订阅
优惠券：创建、更新、删除、列出促销优惠券
自定义提供者：集成自定义支付网关

🧾 发票和账单（12个工具）

模板：创建、列出、获取、更新、删除发票模板
时间表：创建、列出、获取定期发票自动化
发票：创建、列出、获取、向客户发送发票
估计：创建、列出、发送估算、转换为发票
公用事业：自动生成发票/估价单编号

还有更多类别，包括：

📁 媒体管理 -文件上传、组织
🏗️ 自定义对象 -灵活的数据结构
✅ 电子邮件验证 -交付能力检查
📊 调查和工作流程 -自动化工具

🚀 快速开始

部署您自己的实例

部署以渲染

分叉此存储库
创建新的渲染Web服务
配置部署设置：
- 生成命令: npm install && npm run build
- 启动命令: node server.js

设置环境变量：

GHL_API_KEY=your_gohighlevel_api_key
GHL_BASE_URL=https://services.leadconnectorhq.com
GHL_LOCATION_ID=your_location_id
GHL_API_VERSION=2021-07-28

🔧 整合

克劳德代码MCP集成

方法1:HTTP传输（推荐）

使用Claude Code CLI添加服务器：

claude mcp add --transport http leadconnector https://<your-deployment-url>/sse

替换 <your-deployment-url> 使用您的渲染服务URL（例如。，https://ghl-mcp-xxxx.onrender.com).

验证连接：

claude mcp list

方法2：手动配置

添加到您的 claude_desktop_config.json:

{
  "mcpServers": {
    "leadconnector": {
      "command": "npx",
      "args": ["@modelcontextprotocol/server-fetch", "https://<your-deployment-url>/sse"]
    }
  }
}

方法3：直接HTTP API

对于没有MCP的直接集成：

curl -X POST https://<your-deployment-url>/sse \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc": "2.0", "id": "1", "method": "tools/list", "params": {}}'

直接HTTP API

健康检查

curl https://<your-deployment-url>/health

列出可用工具

curl -X POST https://<your-deployment-url>/sse \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": "1",
    "method": "tools/list",
    "params": {}
  }'

创建联系人示例

curl -X POST https://<your-deployment-url>/sse \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": "2",
    "method": "tools/call",
    "params": {
      "name": "create_contact",
      "arguments": {
        "firstName": "John",
        "lastName": "Doe",
        "email": "john.doe@example.com",
        "phone": "+1234567890"
      }
    }
  }'

🛠 发展

本地设置

# Clone repository
git clone https://github.com/TerrysPOV/ghl-mcp.git
cd ghl-mcp

# Install dependencies
npm install

# Set environment variables
cp .env.example .env
# Edit .env with your GHL credentials

# Build TypeScript
npm run build

# Start server
npm start

环境变量

GHL_API_KEY=pit-xxxxxxxxxxxxxxxxxxxxxxxxx  # Your GHL API key
GHL_BASE_URL=https://services.leadconnectorhq.com
GHL_LOCATION_ID=xxxxxxxxxxxxxxxxxxxxxx     # Your location ID
GHL_API_VERSION=2021-07-28                  # API version
PORT=10000                                  # Server port (optional)

项目结构

ghl-mcp/
├── src/
│   ├── clients/
│   │   └── ghl-api-client.ts      # Main GHL API client
│   ├── tools/                     # Individual tool modules
│   │   ├── contact-tools.ts       # Contact management
│   │   ├── conversation-tools.ts  # Messaging
│   │   ├── calendar-tools.ts      # Appointments
│   │   └── ...                    # 19 total tool modules
│   └── types/
│       └── ghl-types.ts           # TypeScript definitions
├── dist/                          # Compiled JavaScript
├── api/
│   └── index.js                   # HTTP request handler
├── server.js                      # Main server entry point
├── render.yaml                    # Render deployment config
└── package.json

📚 API文档

JSON-RPC方法

方法	说明
`initialize`	初始化MCP连接
`tools/list`	获取所有可用工具
`tools/call`	执行特定工具
`ping`	健康检查

工具类别

所有253个工具都按逻辑分类。每个工具都遵循相同的模式：

{
  "name": "tool_name",
  "description": "What the tool does",
  "inputSchema": {
    "type": "object",
    "properties": { ... },
    "required": [ ... ]
  }
}

🔐 安全

API密钥验证：使用GHL API密钥进行身份验证的所有请求
环境变量：安全存储敏感数据
CORS已启用：支持跨来源请求
错误处理：全面的错误报告，不泄露秘密
速率限制：遵守GHL API费率限制

🚦 状态与监控

健康端点: /health -服务器状态和工具计数
日志记录：全面的请求/响应日志记录
错误跟踪：详细的错误报告
演出：针对并发请求进行了优化

🤝 贡献

分叉存储库
创建要素分支： git checkout -b feature-name
进行更改
构建和测试： npm run build && npm test
承诺： git commit -m 'Add feature'
推： git push origin feature-name
创建拉取请求

📄 许可证

MIT许可证-请参阅许可证文件以获取详细信息。

🙏 归因

该项目基于 mastanley13/Go高级MCP原始结构和MCP实现的所有功劳都归原作者所有。

这款叉子经过改进，可用于生产：特里·约戴肯

✅ 修复了GHL API兼容性的版本头问题
✅ 增加了完整的工具覆盖范围（253个工具与原始模拟工具相比）
✅ 使用TypeScript构建管道进行渲染部署优化
✅ 生产就绪错误处理和记录
✅ 全面的文档和部署指南

📞 支持

问题: GitHub问题
文档：此README和内联代码注释
原始项目: mastanley13/Go高级MCP