Skip to content

Commit 414e661

Browse files
Enhance MCP setup guide with Node.js installation recommendation and reordered steps
- Add comprehensive Node.js/nvm installation instructions in prerequisites - Reorder documentation steps: token generation now comes before mcp-remote installation - Maintain existing documentation style and coherent flow Relates to APP-1 Co-Authored-By: mika@elementary-data.com <mika.kerman@gmail.com>
1 parent 6e76e0a commit 414e661

1 file changed

Lines changed: 22 additions & 13 deletions

File tree

docs/cloud/mcp/setup-guide.mdx

Lines changed: 22 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -13,22 +13,20 @@ It covers prerequisites, installation of the `mcp-remote` helper, authentication
1313
| **Node.js 18 LTS or newer** | `mcp-remote` (and many editors) run on Node. Verify wit `node --version`. |
1414
| **npm / npx** | `npx` fetches `mcp-remote` on demand. Bundled with Node. |
1515

16-
> Tip: If you use `nvm`, run `nvm install --lts` and `nvm use --lts`.
16+
> **Recommended:** If you don't have Node.js installed, we recommend using `nvm` (Node Version Manager) for easy installation and management:
17+
> ```bash
18+
> # Install nvm (if not already installed)
19+
> curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
20+
> # Restart your terminal or run: source ~/.bashrc
21+
>
22+
> # Install and use the latest LTS version
23+
> nvm install --lts
24+
> nvm use --lts
25+
> ```
1726
1827
---
1928
20-
## 1 – Install `mcp-remote` (optional)
21-
You don’t have to install anything globally—our configs use npx to fetch the latest version automatically. If you do prefer a global install, use:
22-
```bash
23-
# Optional: global install
24-
npm install -g mcp-remote@latest
25-
```
26-
27-
> **Important:** `mcp-remote` expects the **server URL as the first argument** (flags come **after** the URL). It does **not** implement `--help`; running `mcp-remote --help` will error because `--help` is treated as a URL.
28-
29-
---
30-
31-
## 2 – Generate a personal access token
29+
## 1 – Generate a personal access token
3230
You can now generate tokens directly from the Elementary UI: go to [User → Personal Tokens](https://app.elementary-data.com/settings/tokens).
3331
3432
Quick steps:
@@ -40,6 +38,17 @@ Quick steps:
4038
Tokens are **user‑scoped bearer tokens** and inherit your workspace permissions. Treat them like passwords — do not share or commit them. Keep them secret, rotate regularly, and revoke immediately if compromised.
4139
4240
41+
---
42+
43+
## 2 – Install `mcp-remote` (optional)
44+
You don't have to install anything globally—our configs use npx to fetch the latest version automatically. If you do prefer a global install, use:
45+
```bash
46+
# Optional: global install
47+
npm install -g mcp-remote@latest
48+
```
49+
50+
> **Important:** `mcp-remote` expects the **server URL as the first argument** (flags come **after** the URL). It does **not** implement `--help`; running `mcp-remote --help` will error because `--help` is treated as a URL.
51+
4352
---
4453
4554
## 3 – Configure your client

0 commit comments

Comments
 (0)