GoHighLevel MCP服务器

适用于Claude桌面的GoHighLevel MCP服务器

全面 模型上下文协议（MCP） 连接的服务器 克劳德桌面版 直接到你的 GoHighLevel CRM 账户该服务器弥补了Claude Desktop基于stdio的MCP传输和GoHighLevel的HTTP API之间的差距，为您提供 80+强大的工具 管理联系人、对话、日历、机会、支付、社交媒体、博客等，所有这些都可以通过克劳德的自然语言完成。

包括可选 WindsorAI 跨平台分析和报告的集成。

为什么存在

GoHighLevel提供了一个 官方基于HTTP的MCP服务器但是 Claude Desktop仅支持基于stdio的MCP服务器GoHighLevel的路线图提到了即将到来的 npx Claude Desktop的软件包，但尚未提供。

该项目通过提供 本地stdio MCP服务器 直接与GoHighLevel API v2通信，使所有CRM功能今天都可以从Claude Desktop访问。

对于那些也想要 跨平台分析 （将GoHighLevel数据与谷歌广告、元广告、GA4和325+其他来源相结合），可选 WindsorAI 包括连接器。

特性

总计：80+工具 可通过Claude Desktop中的自然语言访问。

快速开始

先决条件

• Node.js 18岁或以后
• 克劳德桌面版 （最新版本）
• GoHighLevel 具有API访问权限的帐户
• A. 私有集成令牌 来自GoHighLevel

第一步：获取GoHighLevel私有集成令牌

1. 登录您的GoHighLevel帐户。
2. 导航至 设置>私有集成.
3. 点击 “创建新集成”.
4. 命名它（例如，“Claude MCP服务器”）。
5. 选择所需的范围（请参阅 所需范围 在......下面
6. 点击 保存 和 复制生成的令牌 立即（您将无法再次看到它）。
7. 还要注意你的 位置ID 从 设置>公司.

步骤2：配置Claude桌面

打开您的Claude Desktop配置文件：

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• 视窗: %APPDATA%\Claude\claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

添加以下配置：

{
  "mcpServers": {
    "ghl-mcp": {
      "command": "npx",
      "args": ["-y", "ghl-mcp-server"],
      "env": {
        "GHL_API_KEY": "pit-xxxxxxxxxxxxxxxxxxxxxxxx",
        "GHL_LOCATION_ID": "your-location-id-here"
      }
    }
  }
}

步骤3：重新启动克劳德桌面

重新启动克劳德桌面。您应该在MCP工具列表（锤子图标）中看到GoHighLevel工具。

第四步：开始使用

问克劳德这样的问题：

• “显示我标记为VIP的所有联系人”
• “创建一个新联系人：约翰·史密斯，john@example.com，电话555-0123“
• “我这周有什么约会？”
• “搜索价值超过5000美元的开放机会”
• “向联系人ID abc123发送短信，说'您的预约已确认'”
• “创建一篇关于我们新产品发布的博客文章”
• “显示我的销售渠道概述”

替代安装（本地克隆）

如果您更喜欢从源代码运行：

git clone https://github.com/HighLevelScaling/ghl-mcp-server.git
cd ghl-mcp-server
npm install
npm run build

然后配置Claude Desktop以使用本地版本：

{
  "mcpServers": {
    "ghl-mcp": {
      "command": "node",
      "args": ["/path/to/ghl-mcp-server/dist/index.js"],
      "env": {
        "GHL_API_KEY": "pit-xxxxxxxxxxxxxxxxxxxxxxxx",
        "GHL_LOCATION_ID": "your-location-id-here"
      }
    }
  }
}

WindsorAI集成（可选）

WindsorAI 提供了一个无代码连接器，可将GoHighLevel数据与325多个营销和分析源同步。配置后，它将为您的Claude Desktop添加强大的跨平台分析工具。

设置

1. 注册地址： 温莎.ai （30天免费试用）。
2. 将GoHighLevel连接为WindsorAI仪表板中的数据源。
3. 从设置中获取WindsorAI API密钥。
4. 添加 WINDSOR_API_KEY 到您的Claude Desktop配置：

{
  "mcpServers": {
    "ghl-mcp": {
      "command": "npx",
      "args": ["-y", "ghl-mcp-server"],
      "env": {
        "GHL_API_KEY": "pit-xxxxxxxxxxxxxxxxxxxxxxxx",
        "GHL_LOCATION_ID": "your-location-id-here",
        "WINDSOR_API_KEY": "your-windsor-api-key"
      }
    }
  }
}

WindsorAI添加了什么

配置WindsorAI后，您可以问Claude：

• “分析我过去90天的销售渠道绩效”
• “将我的谷歌广告支出与GoHighLevel已完成的交易进行比较”
• “哪些活动产生了最合格的潜在客户？”
• “显示上个月的联系人参与度见解”

WindsorAI提供 16个指标 和 199个维度 来自GoHighLevel的信息，包括联系人数据、机会值、管道阶段、订单、发票、对话等。

所需范围

创建私有集成令牌时，启用这些作用域以实现完整功能：

提示： 您可以从较少的作用域开始，稍后通过在GoHighLevel设置中编辑您的私有集成来添加更多的作用域。

环境变量

建筑

┌──────────────────┐     stdio      ┌──────────────────┐     HTTPS      ┌──────────────────┐
│                  │ ◄────────────► │                  │ ◄────────────► │                  │
│  Claude Desktop  │   MCP JSON     │  ghl-mcp-server  │   REST API     │  GoHighLevel     │
│                  │   over stdio   │  (this project)  │   v2           │  API             │
└──────────────────┘                └──────────────────┘                └──────────────────┘
                                           │
                                           │ HTTPS (optional)
                                           ▼
                                    ┌──────────────────┐
                                    │  WindsorAI       │
                                    │  Analytics API   │
                                    └──────────────────┘

服务器作为 本地stdio进程 Claude Desktop通过stdin/stdout生成JSON-RPC并与之通信。所有GoHighLevel API调用都是使用您的私有集成令牌在服务器端进行的。

工具参考

联系工具

对话工具

日历工具

机会工具

支付工具

社交媒体和博客工具

位置和电子邮件工具

工作流和操作工具

WindsorAI分析工具

故障排除

“需要GHL_API_KEY环境变量”

确保您已设置 GHL_API_KEY 在您的Claude Desktop配置中 env 部分。

“GHL API错误401：未经授权”

您的私有集成令牌可能已过期或无效。转到GoHighLevel设置>私人集成并轮换您的令牌。

“GHL API错误403:禁止”

您的令牌缺少必需的作用域。编辑您的私有集成并添加必要的范围。

工具未出现在Claude Desktop中

1. 请确保在更新配置后重新启动了Claude Desktop。
2. 检查一下 npx 在您的系统PATH中可用。
3. 在Claude Desktop开发人员控制台中查找错误。

速率限制

GoHighLevel强制执行API费率限制。如果遇到429个错误，请稍候，然后重试。服务器未实现自动重试逻辑。

安全最佳实践

• 旋转您的令牌 每90天一次（GoHighLevel提供7天的重叠窗口）。
• 使用最小范围 --只启用您实际需要的权限。
• 永远不要分享你的代币 公开或将其提交给版本控制。
• 使用环境变量 --永远不要在版本控制的配置文件中硬编码令牌。

贡献

欢迎投稿！请在GitHub上打开问题或拉取请求。

许可证

MIT许可证。看 许可证 了解详情。

链接

• GoHighLevel API文档
• GoHighLevel官方MCP服务器
• WindsorAI GoHighLevel连接器
• 模型上下文协议规范
• 克劳德桌面版