企业官网建设流程全解析

如何在 AI 客户端中接入 Netdata Cloud 的 MCP Server？

【免费下载链接】netdataThe fastest path to AI-powered full stack observability, even for lean teams.项目地址: https://gitcode.com/GitHub_Trending/ne/netdata

如果你的 Claude Code、Cursor、Claude Desktop 等 AI 客户端需要查询你基础设施的监控数据（指标、告警、节点信息、日志），Netdata 提供了云托管的 MCP Server 端点https://app.netdata.cloud/api/v1/mcp。通过这一个端点，AI 客户端可以直接访问你 Netdata Cloud 空间中所有节点的可观测性数据——不需要在本地部署任何桥接程序，也不需要改动防火墙。

接入前需要满足三个前提条件（见 Netdata Cloud MCP 文档）：

1. 一个处于Paid plan的 Netdata Cloud 账号；
2. 一个带有scope:mcp权限的 API token；
3. 你的节点已 claim 到 Netdata Cloud——Cloud MCP Server 只能访问连接到你 Netdata Cloud 空间的节点。

创建带 scope:mcp 的 API Token

token 的创建方式（参见 API Tokens 文档）：

1. 登录 Netdata Cloud；
2. 点击左下角的头像；
3. 选择User Settings；
4. 进入API Tokens区域；
5. 创建新 token 并勾选scope:mcp；
6. 复制并妥善保存 token——之后无法再次查看。

scope:mcp是专门为 MCP 客户端（Claude Desktop、Cursor 等）接入 Netdata Cloud MCP 设计的权限，对应访问的是 MCP server 端点。API token 不会过期，但应像密码一样管理，因为它持续授予对你 Netdata 资源的访问权。

端点与认证方式

Cloud MCP 端点固定为：

https://app.netdata.cloud/api/v1/mcp

传输协议是 Streamable HTTP（无状态，可放在负载均衡器和 CDN 之后）。所有请求都要求 Bearer token 形式的认证：

Authorization: Bearer YOUR_NETDATA_CLOUD_API_TOKEN

其中YOUR_NETDATA_CLOUD_API_TOKEN是上面创建的scope:mcptoken，下文所有配置块中都以此占位，替换方式相同。

接入前可以先用 curl 验证端点连通性和 token 有效性：

curl -H "Authorization: Bearer YOUR_TOKEN" https://app.netdata.cloud/api/v1/mcp

注意 token 必须放在Authorization头中，不能作为 query 参数传递；端点本身走 HTTPS，客户端侧不需要--allow-http之类的标志。

在支持 HTTP 传输的客户端中接入

如果你的客户端支持 Streamable HTTP，直接按客户端要求的格式填入端点和请求头即可。通用格式（适用于大多数支持 HTTP transport 的 MCP 客户端）：

{ "mcpServers": { "netdata-cloud": { "type": "http", "url": "https://app.netdata.cloud/api/v1/mcp", "headers": { "Authorization": "Bearer YOUR_NETDATA_CLOUD_API_TOKEN" } } } }

以下是文档中给出具体配置的客户端，任选一个即可。

Claude Code：单条命令注册

在任意 Claude Code 会话中执行（--scope user表示本机所有项目可用，文档推荐个人使用场景）：

claude mcp add --transport http --scope user netdata-cloud \ https://app.netdata.cloud/api/v1/mcp \ --header "Authorization: Bearer YOUR_NETDATA_CLOUD_API_TOKEN"

scope 的含义（来自 Claude Code 指南）：

• --scope user：本机所有项目可用，适合个人使用；
• --scope local：仅当前项目、仅自己可见，省略--scope时的默认值；
• --scope project：写入.mcp.json并与团队共享——不要在其中直接写原始 token，应改为引用环境变量。

添加后需要重启 Claude Code 会话让新工具加载。常用配套命令：

claude mcp list # 列出所有已配置 server 及连接状态 claude mcp get netdata-cloud # 查看该 server 的配置 claude mcp remove netdata-cloud -s user # 移除 server（scope 要与添加时一致）

Cursor

Cursor 原生支持 Streamable HTTP。将下面的配置加入工作区根目录的.cursor/mcp.json（参见 Cursor 指南）：

{ "mcpServers": { "netdata-cloud": { "type": "streamable-http", "url": "https://app.netdata.cloud/api/v1/mcp", "headers": { "Authorization": "Bearer YOUR_NETDATA_CLOUD_API_TOKEN" } } } }

保存后重启 Cursor 或执行 "Reload Window"，新 server 会出现在Settings → MCP中。文档还提到 Cursor 支持配置插值（如${env:NETDATA_MCP_API_KEY}），可以用它避免在配置文件里写明文 token。

VS Code（Continue 扩展）

Continue 扩展使用 YAML 描述 MCP server。将以下内容写入.continue/mcpServers/netdata-cloud.yaml（参见 VS Code 指南）：

name: Netdata Cloud version: 0.0.1 schema: v1 mcpServers: - name: netdata-cloud type: streamable-http url: https://app.netdata.cloud/api/v1/mcp requestOptions: headers: Authorization: Bearer YOUR_NETDATA_CLOUD_API_TOKEN

注意：VS Code 的 Cline 扩展只支持 stdio 和 SSE，而 Cloud MCP 端点是 Streamable HTTP，因此 Cline 必须走下一节的mcp-remote桥接。

Gemini CLI

支持用命令行注册（参见 Gemini CLI 指南）：

gemini mcp add --transport http netdata-cloud https://app.netdata.cloud/api/v1/mcp \ --header "Authorization: Bearer YOUR_NETDATA_CLOUD_API_TOKEN"

或者写入~/.gemini/settings.json：

{ "mcpServers": { "netdata-cloud": { "httpUrl": "https://app.netdata.cloud/api/v1/mcp", "headers": { "Authorization": "Bearer YOUR_NETDATA_CLOUD_API_TOKEN" }, "timeout": 30000 } } }

只支持 stdio 的客户端：用 mcp-remote 桥接

Claude Desktop、JetBrains AI Assistant、Cline 这类只以 stdio 启动 MCP server 的客户端，需要用npx mcp-remote@latest把远端 Streamable HTTP 会话包装成 stdio。以 Claude Desktop 为例（参见 Claude Desktop 指南），在claude_desktop_config.json中添加：

{ "mcpServers": { "netdata-cloud": { "command": "npx", "args": [ "mcp-remote@latest", "https://app.netdata.cloud/api/v1/mcp", "--header", "Authorization: Bearer YOUR_NETDATA_CLOUD_API_TOKEN" ] } } }

配置文件的打开方式：打开 Claude Desktop → Settings → Developer（macOS 为 Claude → Settings → Developer）→Edit Config，文件位置为：

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json
• Linux（preview 构建）：~/.config/claude/claude_desktop_config.json

保存后重启 Claude Desktop。JetBrains AI Assistant 和 Cline 使用同样的 command/args 结构（参见 JetBrains 指南 与 VS Code 指南）。

验证接入结果

验证方式取决于你使用的客户端：

• Claude Code：claude mcp list查看 server 列表与连接状态，claude mcp get netdata-cloud查看具体配置；
• Cursor：Reload Window 后在Settings → MCP中确认netdata-cloud出现；
• Claude Desktop：点击提示框下方的 "Search and tools" 按钮，"netdata-cloud" 应列在可用工具中；若不可见，检查配置是否为合法 JSON 并重启；
• Gemini CLI：gemini mcp list列出已配置的 MCP server，会话内输入/mcp查看状态、/mcp desc查看工具描述；
• 任何客户端：用前面的curl -H "Authorization: Bearer YOUR_TOKEN" https://app.netdata.cloud/api/v1/mcp确认端点与 token 本身可用。

接入成功后，可以直接用自然语言提问，例如"What's the current CPU usage across all my servers?"、"Show me any anomalies in the last 4 hours"、"Are there any critical alerts active?"。

排查与限制

接入失败时，按 Netdata MCP 文档 的 Cloud MCP Troubleshooting 一节核对：

认证错误

• 确认 token 带有scope:mcp；
• 确认 token 以Authorization: Bearer <token>头传递，而不是 query 参数；
• 确认 Netdata Cloud 订阅包含 Paid plan 中的 space。

看不到节点（No Nodes Visible）

• 确认节点已 claim 到 Netdata Cloud，并且出现在 web dashboard 中；
• 确认 agent 在线且正在向 Cloud 流式传输数据。

连接问题

• 端点使用 HTTPS，不需要--allow-http；
• 用上面的 curl 命令测试连通性。

还有两个能力边界需要注意：

• Cloud MCP 的可见范围是你 Netdata Cloud 空间内的所有节点；
• Function Execution（在节点上执行 Netdata 函数）和 Log Exploration（读取节点日志）这两类工具要求对应的节点背后有 Netdata Parent。

进一步阅读

各客户端的完整指南还覆盖了本地 Agent/Parent 直连、nd-mcp桥接、多环境配置等内容，按需查阅：

• Netdata MCP 总览与本地 Agent/Parent 接入
• Claude Code、Claude Desktop、Cursor、VS Code、JetBrains IDEs、Gemini CLI
• API Tokens

【免费下载链接】netdataThe fastest path to AI-powered full stack observability, even for lean teams.项目地址: https://gitcode.com/GitHub_Trending/ne/netdata