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

如何在 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 文档一个处于Paid plan的 Netdata Cloud 账号一个带有scope:mcp权限的 API token你的节点已 claim 到 Netdata Cloud——Cloud MCP Server 只能访问连接到你 Netdata Cloud 空间的节点。创建带 scope:mcp 的 API Tokentoken 的创建方式参见 API Tokens 文档登录 Netdata Cloud点击左下角的头像选择User Settings进入API Tokens区域创建新 token 并勾选scope:mcp复制并妥善保存 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_TOKENscope 的含义来自 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 # 移除 serverscope 要与添加时一致CursorCursor 原生支持 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 CodeContinue 扩展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-remotelatest把远端 Streamable HTTP 会话包装成 stdio。以 Claude Desktop 为例参见 Claude Desktop 指南在claude_desktop_config.json中添加{ mcpServers: { netdata-cloud: { command: npx, args: [ mcp-remotelatest, https://app.netdata.cloud/api/v1/mcp, --header, Authorization: Bearer YOUR_NETDATA_CLOUD_API_TOKEN ] } } }配置文件的打开方式打开 Claude Desktop → Settings → DevelopermacOS 为 Claude → Settings → Developer→Edit Config文件位置为macOS~/Library/Application Support/Claude/claude_desktop_config.jsonWindows%APPDATA%\Claude\claude_desktop_config.jsonLinuxpreview 构建~/.config/claude/claude_desktop_config.json保存后重启 Claude Desktop。JetBrains AI Assistant 和 Cline 使用同样的 command/args 结构参见 JetBrains 指南 与 VS Code 指南。验证接入结果验证方式取决于你使用的客户端Claude Codeclaude mcp list查看 server 列表与连接状态claude mcp get netdata-cloud查看具体配置CursorReload Window 后在Settings → MCP中确认netdata-cloud出现Claude Desktop点击提示框下方的 Search and tools 按钮netdata-cloud 应列在可用工具中若不可见检查配置是否为合法 JSON 并重启Gemini CLIgemini mcp list列出已配置的 MCP server会话内输入/mcp查看状态、/mcp desc查看工具描述任何客户端用前面的curl -H Authorization: Bearer YOUR_TOKEN https://app.netdata.cloud/api/v1/mcp确认端点与 token 本身可用。接入成功后可以直接用自然语言提问例如Whats 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 CLIAPI Tokens【免费下载链接】netdataThe fastest path to AI-powered full stack observability, even for lean teams.项目地址: https://gitcode.com/GitHub_Trending/ne/netdata创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考