GHL MCP集成
通过MCP（模型上下文协议）实现GoHighLevel CRM集成 克劳德代码 和 开爪.
┌──────────────┐ MCP/HTTP ┌─────────────────────┐
│ Claude Code │───────────────→│ GHL MCP Endpoint │
│ (.mcp.json) │ │ leadconnectorhq │
└──────────────┘ └─────────────────────┘
↑
┌──────────────┐ MCP/HTTP │
│ OpenClaw │───────────────→│
│ (Claw agent) │ │
└──────────────┘快速开始
1.克隆和配置
git clone https://github.com/AffordableCareAI/ghl-mcp-integration.git
cd ghl-mcp-integration
cp .env.example .env
# Edit .env with your GHL PIT tokens and Location IDs2.克劳德代码（桌面）
这 .mcp.json 自动检测。通过以下方式进行验证：
/mcp后备方案 （如果env-var替换不起作用-- #6204):
claude mcp add --transport http ghl-main \
--header "Authorization: Bearer $GHL_PIT_MAIN" \
--header "locationId: $GHL_LOCATION_MAIN" \
https://services.leadconnectorhq.com/mcp/3.CLI管理器
# Add a location (interactive)
node cli/ghl-manager.js add
# Test connection
node cli/ghl-manager.js test main
# Generate configs for all locations
node cli/ghl-manager.js generate-config4.OpenClaw（VPS部署）
# Copy skill files to VPS
scp -r openclaw-skill/ root@142.93.73.208:/root/.openclaw/skills/ghl/
scp -r shared/ root@142.93.73.208:/root/.openclaw/skills/ghl/shared/
# Set env vars on VPS
ssh root@142.93.73.208
echo 'GHL_PIT_MAIN=pit_xxx' >> /root/.openclaw/.env
echo 'GHL_LOCATION_MAIN=xxx' >> /root/.openclaw/.env
# Install monitoring crons
node /root/.openclaw/skills/ghl/cron_schedule.js --install
# Copy training docs
cp shared/GHL_CONTEXT.md /root/.openclaw/workspace/training/
cp openclaw-skill/SKILL.md /root/.openclaw/workspace/training/建筑
组件
| 组件 | 目的 |
|---|---|
shared/ghl-mcp-client.js | 零dep MCP HTTP流式客户端 |
shared/ghl-utils.js | 速率限制、缓存、重试、日志记录 |
shared/GHL_CONTEXT.md | AI代理的域上下文 |
openclaw-skill/ | OpenClaw的监控、操作和cron |
cli/ghl-manager.js | 多位置凭证管理器 |
cli/encryption.js | AES-256-GCM凭证加密 |
MCP协议详细信息
- 运输： HTTP流式传输（使用JSON-RPC 2.0的POST）
- 端点：
https://services.leadconnectorhq.com/mcp/ - 认证： `Authorization: Bearer
+ locationId: `
- 协议版本：
2025-06-18 - 会议： 服务器可能会返回
Mcp-Session-Id头球
速率限制
- 每个位置每10秒100个请求
- 每个位置每天有200000个请求
- 每次MCP呼叫=1 GHL AI积分
可用工具（36）
联络： 获取联系人、获取联系人、更新联系人、添加标签、删除标签、获取所有任务 对话： 搜索对话、获取消息、发送新消息 机会： 搜索机会、更新机会、获取渠道 日历： 获取日历事件，获取约会笔记 付款： 列出交易、列出订单、获取订单
监控
监控系统运行自动检查：
| 检查 | 计划 | 阈值 |
|---|---|---|
| 错过的跟进 | 每30分钟一次 | 逾期任务 |
| 陈旧的线索 | 工作日上午10点+下午3点 | 48小时无活动 |
| 晨间摘要 | 每日上午8点 | 所有检查 |
| 周报 | 周一上午9点 | 全面回顾 |
# Manual run
node openclaw-skill/ghl_monitor.js
# Dry run (no API calls)
node openclaw-skill/ghl_monitor.js --dry-run
# View cron schedule
node openclaw-skill/cron_schedule.js测试
# Run all tests (zero dependencies, uses node:test)
npm test
# Individual test suites
npm run test:client
npm run test:monitor
npm run test:actions安全
- PIT令牌存储为env变量（克劳德代码）或AES-256-GCM加密（CLI）
- PBKDF2密钥推导（100K迭代，SHA-512）
- 从未向git承诺过任何代币
.env和*.enc在.gitignoreENV:VAR_NAMEOpenClaw配置中用于环境变量解析的前缀
文件结构
ghl-mcp-integration/
├── .mcp.json # Claude Code MCP config
├── .env.example # Token template
├── package.json # Zero deps, node:test
├── shared/
│ ├── ghl-mcp-client.js # MCP HTTP client
│ ├── ghl-utils.js # Rate limiting, caching, retries
│ └── GHL_CONTEXT.md # Insurance/GHL domain context
├── openclaw-skill/
│ ├── SKILL.md # Agent skill definition
│ ├── ghl_actions.js # Action functions
│ ├── ghl_monitor.js # Monitoring checks
│ ├── cron_schedule.js # Cron job registration
│ └── config.example.json # Multi-location config template
├── cli/
│ ├── ghl-manager.js # CLI location manager
│ └── encryption.js # AES-256-GCM encryption
└── tests/
├── helpers/mock-fetch.js # Fetch mock
├── mcp-client.test.js
├── monitor.test.js
└── actions.test.js