Skip to content

Enhance MCP setup guide with Node.js installation recommendation and reordered steps #1989

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
MikaKerman merged 4 commits into from
Aug 19, 2025
Merged

Enhance MCP setup guide with Node.js installation recommendation and reordered steps #1989

Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
414e661
Enhance MCP setup guide with Node.js installation recommendation and …
devin-ai-integration[bot] Aug 19, 2025
b519068
Fix CI failure by removing problematic types-pkg-resources dependency
devin-ai-integration[bot] Aug 19, 2025
a3aed25
Fix comma in mcp-remote installation note
devin-ai-integration[bot] Aug 19, 2025
de26c7d
Revert dev-requirements.txt changes
devin-ai-integration[bot] Aug 19, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
35 changes: 22 additions & 13 deletions docs/cloud/mcp/setup-guide.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -13,22 +13,20 @@ It covers prerequisites, installation of the `mcp-remote` helper, authentication
| **Node.js 18 LTS or newer** | `mcp-remote` (and many editors) run on Node. Verify wit `node --version`. |
| **npm / npx** | `npx` fetches `mcp-remote` on demand. Bundled with Node. |

> Tip: If you use `nvm`, run `nvm install --lts` and `nvm use --lts`.
> **Recommended:** If you don't have Node.js installed, we recommend using `nvm` (Node Version Manager) for easy installation and management:
> ```bash
> # Install nvm (if not already installed)
> curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
> # Restart your terminal or run: source ~/.bashrc
>
> # Install and use the latest LTS version
> nvm install --lts
> nvm use --lts
> ```

---

## 1 – Install `mcp-remote` (optional)
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:
```bash
# Optional: global install
npm install -g mcp-remote@latest
```

> **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.

---

## 2 – Generate a personal access token
## 1 – Generate a personal access token
You can now generate tokens directly from the Elementary UI: go to [User → Personal Tokens](https://app.elementary-data.com/settings/tokens).

Quick steps:
Expand All @@ -40,6 +38,17 @@ Quick steps:
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.


---

## 2 – Install `mcp-remote` (optional)
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:
```bash
# Optional: global install
npm install -g mcp-remote@latest
```

> **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.

---

## 3 – Configure your client
Expand Down
Loading