You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/Netdata AI/MCP/MCP.mdx
+30Lines changed: 30 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -92,6 +92,36 @@ For more details, see [API Tokens](/docs/netdata-cloud/authentication-&-authoriz
92
92
93
93
### Connection Configuration
94
94
95
+
#### Claude Code (One-Line Setup)
96
+
97
+
If you're using [Claude Code](https://www.anthropic.com/claude-code), you can register the Netdata Cloud MCP server from any session with a single command — no JSON editing required:
98
+
99
+
```bash
100
+
claude mcp add --transport http --scope user netdata-cloud \
Replace `YOUR_NETDATA_CLOUD_API_TOKEN` with a token that has `scope:mcp` — see [Creating an API Token](#creating-an-api-token) above, or go directly to **User Settings → API Tokens** in [Netdata Cloud](https://app.netdata.cloud).
106
+
107
+
**Scope flags:**
108
+
109
+
-`--scope user` — available in all your projects on this machine (recommended for personal use)
110
+
-`--scope local` — this project only, private to you (default when `--scope` is omitted)
111
+
-`--scope project` — this project, checked into `.mcp.json` and shared with your team (do **not** use with a raw token; reference an environment variable instead)
112
+
113
+
**Useful companion commands:**
114
+
115
+
```bash
116
+
claude mcp list # show all configured servers and their connection status
117
+
claude mcp get netdata-cloud # show the configuration for this server
118
+
claude mcp remove netdata-cloud -s user # remove the server (match the scope you added with)
119
+
```
120
+
121
+
Restart the Claude Code session after adding the server so the new tools load.
122
+
123
+
For more Claude Code options — including connecting to a local Netdata Agent or Parent — see the [Claude Code guide](/docs/netdata-ai/mcp/mcp-clients/claude-code).
124
+
95
125
#### Generic MCP Client (HTTP Transport)
96
126
97
127
For any MCP client that supports Streamable HTTP transport:
0 commit comments