用途：初始化或修复随插件分发的 SigNoz MCP 服务器注册，使客户端存在一个可用的 signoz MCP 服务器；除非用户明确要求单独配置，否则不创建重复服务器。
主要能力：
- 识别目标客户端（来自 $ARGUMENTS 或用户消息；无明确说明时仅在运行环境明显时推断），区分 Agent Plugins v1 便携安装、Claude Code/Cursor 兼容包安装以及 VS Code、Claude Desktop、Gemini CLI、Devin CLI、Windsurf、Zed、Antigravity CLI、OpenCode 等原生客户端配方。
- 通过 signoz_list_services(timeRange: "1h", limit: 1) 探测状态，区分 working、not-setup、configured-but-not-working。
- 解析并写入端点：SigNoz Cloud 区域（us、us2、eu、eu2、in、in2 或更新的区域代码）、Cloud MCP URL（如 https://mcp.us.signoz.cloud/mcp）、自托管 HTTP URL（如 http://localhost:8000/mcp）。
- Agent Plugins v1 使用插件根 mcp.json；Claude Code 更新 ~/.claude/settings.json 中 pluginConfigs[<plugin-id>].options.SIGNOZ_MCP_URL；Cursor 改 .signoz_cursor_mcp.json 的 url；Codex 可用 codex mcp add signoz --url <resolved-mcp-url> 做持久化；Grok Build 用 grok mcp add signoz -t http <resolved-mcp-url> -s user。
- 鉴权与角色诊断：读取至少需要 viewer，告警/仪表盘写入需要 editor 或 admin，通知渠道管理与 API key 创建需要 admin；401 表示凭据缺失/无效/过期，403 表示权限不足。
使用方式：先读取 references/mcp-settings.md 与 references/client-configs.md，再按“识别客户端 → 检查状态 → 解析端点 → 应用端点 → 完成鉴权”执行。云版不要索取 API key，OAuth 会在配置 URL 后要求实例 URL 与服务账号 API key；自托管优先 HTTP 模式。
限制与注意：MCP 不可用时不要回退到原始 HTTP 调用；不要查看或搜索与本客户端无关的插件注册文件；不要将 API key、令牌写入被跟踪的项目文件；不要修改 .signoz_grok_mcp.json；保留无关的 MCP 服务器与设置。插件更新可能重置便携注册文件，届时需重跑本技能。具体客户端配置细节以随附参考文档为准。