Skip to content

Commit b8a1b65

Browse files
authored
Merge pull request #1981 from elementary-data/mcp-setup-guide-2
Revise MCP setup guide: streamline security reminders, update section…
2 parents 7c4eb5f + 59d9dad commit b8a1b65

1 file changed

Lines changed: 8 additions & 31 deletions

File tree

docs/cloud/mcp/setup-guide.mdx

Lines changed: 8 additions & 31 deletions
Original file line numberDiff line numberDiff line change
@@ -37,32 +37,15 @@ These tokens inherit **your** workspace permissions:
3737
* Rotate regularly.
3838
* Revoke immediately if compromised.
3939

40-
---
41-
42-
## 3 - Validate the connection
43-
This confirms you can reach the Elementary MCP server.
44-
> Note: Replace `<AUTH_TOKEN>` with your actual token.
45-
46-
```bash
47-
npx -y mcp-remote@latest https://prod.api.elementary-data.com/mcp/ \
48-
--header "Authorization: Bearer <AUTH_TOKEN>" \
49-
--health --debug
50-
```
40+
### Security reminders
41+
* Tokens confer **all** your Elementary permissions.
42+
* Keep them secret and scoped; rotate when in doubt.
43+
* Revoke compromised tokens immediately.
5144

52-
Optional deeper check (list tools/resources):
53-
```bash
54-
npx -y mcp-remote@latest mcp-remote-client https://prod.api.elementary-data.com/mcp/ \
55-
--header "Authorization: Bearer <AUTH_TOKEN>" \
56-
--list-tools --debug
57-
```
5845

59-
**Troubleshooting**
60-
| Symptom | Remedy |
61-
|---------|--------|
62-
| `node: command not found` | Install Node ≥ 18 and ensure it’s on `PATH`. |
63-
| `401 Unauthorized` | Token expired or pasted incorrectly → regenerate. |
46+
---
6447

65-
## 4 – Configure your client
48+
## 3 – Configure your client
6649
Most MCP‑compatible clients read a JSON config that defines mcpServers. Use one of the following patterns.
6750
```jsonc
6851
{
@@ -88,22 +71,16 @@ It makes `npx` skip the interactive “install this package?” prompt.
8871

8972
### Client‑specific steps
9073

91-
#### 4.1 Cursor IDE
74+
#### 3.1 Cursor IDE
9275
1. **Settings → Model Context Protocol → Add Custom Server**
9376
or edit `~/.cursor/mcp.json` (global) / `<project>/.cursor/mcp.json` (workspace).
9477
2. Paste the JSON above.
9578
3. Save – Cursor auto‑restarts its MCP agent.
9679

97-
#### 4.2 Claude Desktop
80+
#### 3.2 Claude Desktop
9881
1. In the menu bar choose **Claude → Settings -> Developer**.
9982
2. Under **Local MCP Servers**, click **Edit**.
10083
3. Paste the JSON block
10184
4. Restart Claude
10285

103-
---
104-
105-
### Security reminders
106-
* Tokens confer **all** your Elementary permissions.
107-
* Keep them secret and scoped; rotate when in doubt.
108-
* Revoke compromised tokens immediately.
10986

0 commit comments

Comments
 (0)