@elitedcs/ghl-mcp 3.58.0 → 3.59.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +36 -0
- package/README.md +20 -7
- package/dist/index.js +564 -154
- package/package.json +3 -2
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,41 @@
|
|
|
1
1
|
# Changelog
|
|
2
2
|
|
|
3
|
+
## 3.59.0 — One-command install: `npx -y @elitedcs/ghl-mcp cli install`
|
|
4
|
+
|
|
5
|
+
The old install step said "Edit Config, paste this block." Edit Config opens a
|
|
6
|
+
folder, not a text box — and the block was a complete config object, so anyone
|
|
7
|
+
who already had other MCP servers and followed the instruction literally wiped
|
|
8
|
+
them. A real buyer hit exactly that this week.
|
|
9
|
+
|
|
10
|
+
This release replaces the hand-edit with one command:
|
|
11
|
+
|
|
12
|
+
npx -y @elitedcs/ghl-mcp cli install
|
|
13
|
+
|
|
14
|
+
It finds Claude Desktop's settings file (including the Microsoft Store build's
|
|
15
|
+
relocated path on Windows), adds GHL Command **alongside** whatever servers are
|
|
16
|
+
already there, and saves a verified backup before touching anything. If the
|
|
17
|
+
file has a formatting problem — often caused by our own old instructions — it
|
|
18
|
+
repairs what it can and preserves the original in the backup. If the file can't
|
|
19
|
+
be read at all, it writes a fresh working config and keeps the original so
|
|
20
|
+
nothing is ever lost.
|
|
21
|
+
|
|
22
|
+
Safety properties, all tested (33 new tests):
|
|
23
|
+
|
|
24
|
+
- **Never writes without a verified backup** of an existing file, and aborts if
|
|
25
|
+
the backup can't be confirmed byte-for-byte.
|
|
26
|
+
- **Never fights Claude for the file**: writes are atomic, lock errors retry
|
|
27
|
+
briefly then stop with plain instructions, and if anything else modifies the
|
|
28
|
+
file mid-run it stops rather than overwrite the newer change.
|
|
29
|
+
- **Never guesses between multiple config files** — it stops and asks.
|
|
30
|
+
- **Never touches** symlinked configs pointing somewhere unexpected, UTF-16
|
|
31
|
+
files, or files whose content it can read but not safely restructure.
|
|
32
|
+
- `--dry-run` previews every decision without writing; `--print-only` emits the
|
|
33
|
+
merged JSON for locked-down machines.
|
|
34
|
+
|
|
35
|
+
Also in this release: the license-failure message now points at ghlcommand.com
|
|
36
|
+
(and mentions the free tier) instead of a retired page, and `setup_ghl_mcp`'s
|
|
37
|
+
description finally includes a URL for people who reach it without a license.
|
|
38
|
+
|
|
3
39
|
## 3.58.0 — Anonymous install stats, so we can find out where installs get stuck
|
|
4
40
|
|
|
5
41
|
Most people who install GHL Command never get it working, and until now there
|
package/README.md
CHANGED
|
@@ -89,7 +89,24 @@ This MCP (Model Context Protocol) server connects Claude directly to GoHighLevel
|
|
|
89
89
|
|
|
90
90
|
### 2. Install in Claude Desktop App
|
|
91
91
|
|
|
92
|
-
|
|
92
|
+
One command in any terminal (Terminal on Mac, PowerShell on Windows):
|
|
93
|
+
|
|
94
|
+
```
|
|
95
|
+
npx -y @elitedcs/ghl-mcp cli install
|
|
96
|
+
```
|
|
97
|
+
|
|
98
|
+
It finds Claude Desktop's settings file, adds GHL Command **alongside any MCP servers you already have** (nothing gets overwritten), and saves a backup first. If the file has a formatting problem, it repairs it. Then **quit Claude completely** — Cmd+Q on Mac; on Windows right-click the Claude icon by the clock and choose Quit — and reopen.
|
|
99
|
+
|
|
100
|
+
> **Claude Code (terminal) instead?** One command:
|
|
101
|
+
> ```
|
|
102
|
+
> claude mcp add --scope user -t stdio ghl -- npx -y @elitedcs/ghl-mcp@latest
|
|
103
|
+
> ```
|
|
104
|
+
> Then restart Claude Code.
|
|
105
|
+
|
|
106
|
+
<details>
|
|
107
|
+
<summary>Prefer to edit the config by hand?</summary>
|
|
108
|
+
|
|
109
|
+
Open Claude Desktop → **Settings...** → **Developer** → **Edit Config**. That opens a **folder**, not a text box — open `claude_desktop_config.json` from it in a text editor. If the file is empty, paste this whole block:
|
|
93
110
|
|
|
94
111
|
```json
|
|
95
112
|
{
|
|
@@ -102,13 +119,9 @@ Open Claude Desktop. Click **Claude** menu (top-left) → **Settings...** → **
|
|
|
102
119
|
}
|
|
103
120
|
```
|
|
104
121
|
|
|
105
|
-
|
|
122
|
+
If it already has other tools in it, do **not** paste over them — add only the `"ghl": { ... }` entry inside your existing `"mcpServers"` object. Save, then fully quit and reopen Claude. (Unsure? Run `npx -y @elitedcs/ghl-mcp cli install --dry-run` to preview exactly what would change, or `--print-only` to get the merged file printed for you.)
|
|
106
123
|
|
|
107
|
-
>
|
|
108
|
-
> ```
|
|
109
|
-
> claude mcp add --scope user -t stdio ghl -- npx -y @elitedcs/ghl-mcp@latest
|
|
110
|
-
> ```
|
|
111
|
-
> Then restart Claude Code.
|
|
124
|
+
</details>
|
|
112
125
|
|
|
113
126
|
### 3. Activate
|
|
114
127
|
|