奇链 奇链
← 文章 / 云原生与基础设施
signoz 12天前 · 2026-10-24 01:02:42 · 15 阅读

SigNoz MCP 服务器

SigNoz MCP Server 实现了 Model Context Protocol (MCP)，这是一项开放标准，允许 AI 智能体访问您的 SigNoz 可观测性数据。您可以使用自然语言查询 metrics、traces 和 logs，调查告警，并管理仪表盘、告警规则、保存视图及通知渠道。

该 MCP server 与 SigNoz 插件 配合效果最佳：一次安装即可注册 server 并加载所有 Agent Skill，使智能体从首个提示词起便能直接在 SigNoz 中执行查询、构建及排障任务。

已配置好？

如果您已设置好 MCP server，可直接跳至用例，了解其具体功能。

连接 SigNoz MCP server

SigNoz Cloud 自托管

将您的 AI 工具连接至 SigNoz Cloud 托管的 MCP server。无需安装，添加 URL 并完成身份验证即可。

复制
https://mcp.<region>.signoz.cloud/mcp
注意

请确保选择与您 SigNoz Cloud 账号匹配的正确 region。使用错误的 region 会导致身份验证失败。

请核对以下值：

  • <region>：您的 SigNoz Cloud region。可在 SigNoz 的Settings → Ingestion 中查看，或参考region 说明。
Cursor VS Code / GitHub Copilot Claude Desktop Claude Code OpenAI Codex Gemini CLI Windsurf Antigravity Grok Build

一键安装

手动配置

将此配置添加到 .cursor/mcp.json：

.cursor/mcp.json
{
  "mcpServers": {
    "signoz": {
      "url": "https://mcp.<region>.signoz.cloud/mcp"
    }
  }
}

请核对以下值：

  • <region>：您的 SigNoz Cloud region

需要帮助？请参考 Cursor MCP 文档 ↗

一键安装

手动配置

将此配置添加到 .vscode/mcp.json：

.vscode/mcp.json
{
  "servers": {
    "signoz": {
      "type": "http",
      "url": "https://mcp.<region>.signoz.cloud/mcp"
    }
  }
}

请核对这些参数：

  • <region>：你的 SigNoz Cloud region

需要帮助？请参阅 VS Code MCP 文档 ↗

配置

你可以在 Claude Desktop 中将 SigNoz Cloud 添加为自定义连接器：

  1. 打开 Claude Desktop。
  2. 进入 Settings → Developer（根据版本不同，也可能是 Features）。
  3. 点击 Add Custom Connector 或 Add Remote MCP Server。
  4. 输入你的 SigNoz MCP URL：https://mcp.<region>.signoz.cloud/mcp

请核对这些参数：

  • <region>：你的 SigNoz Cloud region

在提示时，完成身份验证流程。

配置

运行以下命令添加 SigNoz MCP 服务器：

Copy
claude mcp add --scope user --transport http signoz https://mcp.<region>.signoz.cloud/mcp

请核对这些参数：

  • <region>：你的 SigNoz Cloud region

配置好 MCP 服务器后，需要进行身份验证。在终端中运行：

Copy
claude /mcp

选择 signoz 服务器并完成身份验证流程。

配置

运行以下命令添加 SigNoz MCP 服务器：

Copy
codex mcp add signoz --url https://mcp.<region>.signoz.cloud/mcp

或者将以下配置添加到 config.toml：

config.toml
[mcp_servers.signoz]
url = "https://mcp.<region>.signoz.cloud/mcp"

请核对这些参数：

  • <region>：你的 SigNoz Cloud region

添加服务器后，进行身份验证：

Copy
codex mcp login signoz

然后在 Codex 中运行 /mcp 验证连接。

配置

通过 CLI 添加 MCP 服务器：

Copy
gemini mcp add -t http signoz https://mcp.<region>.signoz.cloud/mcp

或者将此配置添加到 ~/.gemini/settings.json：

settings.json
{
  "mcpServers": {
    "signoz": {
      "httpUrl": "https://mcp.<region>.signoz.cloud/mcp"
    }
  }
}

请验证以下值：

  • <region>：你的 SigNoz Cloud region

安装完成后，启动 Gemini CLI 并进行身份验证：

Copy
/mcp auth signoz

配置

将此配置添加到 ~/.codeium/windsurf/mcp_config.json：

mcp_config.json
{
  "mcpServers": {
    "signoz": {
      "serverUrl": "https://mcp.<region>.signoz.cloud/mcp"
    }
  }
}

请验证以下值：

  • <region>：你的 SigNoz Cloud region

系统提示时，请完成身份验证流程。

配置

  1. 通过 agent 面板中的 ... 菜单打开 MCP Store。
  2. 点击 Manage MCP Servers。
  3. 使用 SigNoz MCP URL 添加新服务器： https://mcp.<region>.signoz.cloud/mcp

或者手动添加到 mcp_config.json：

mcp_config.json
{
  "mcpServers": {
    "signoz": {
      "serverUrl": "https://mcp.<region>.signoz.cloud/mcp"
    }
  }
}

请验证以下值：

  • <region>：你的 SigNoz Cloud region

保存配置后，系统会提示你完成 OAuth 流程。若要在 Antigravity 内编辑配置，请点击 Agent 面板顶部的 ... 菜单 → MCP Servers → Manage MCP Servers → View raw config。

如果遇到身份验证问题，请打开命令面板并运行 Authentication: Remove Dynamic Authentication Providers，以清除缓存的 OAuth 凭证并重新认证。

配置

通过 CLI 添加 MCP 服务器：

Copy
grok mcp add -t http signoz https://mcp.<region>.signoz.cloud/mcp

或将此配置添加到 ~/.grok/config.toml：

config.toml 
[mcp_servers.signoz]
url = "https://mcp.<region>.signoz.cloud/mcp"
enabled = true

请核对以下参数：

  • <region>：对应你的 SigNoz Cloud 所在的区域

添加服务器并不会自动完成身份验证。启动 Grok Build，运行 /mcps，选择 signoz 服务器，然后在浏览器中完成 OAuth 授权流程：

Copy 
grok
Copy 
/mcps

配置文件中不会存储 API 密钥；OAuth 流程完成后，凭据会被单独保存。

在 add 命令后加上 -s project 参数，即可将配置写入 ./.grok/config.toml，以便让在该目录下的所有协作者共享此服务器设置。

验证连接状态：

Copy 
grok mcp list
grok mcp doctor

在客户端完成身份验证

当你在客户端中添加托管 MCP 的 URL 时，MCP 客户端会发起身份验证流程。系统会提示你输入：

  1. 你的 SigNoz 实例 URL（例如 https://your-instance.signoz.cloud）
  2. 你的 API 密钥：前往 SigNoz 的 Settings → Service Accounts 页面，创建一个服务账户并生成 API 密钥（需具备 Admin 角色）。详情参见Service Accounts文档。
身份验证是如何工作的？

SigNoz Cloud 的托管 MCP 服务器采用 OAuth 2.1 进行客户端与 MCP 之间的身份验证。MCP 客户端会从服务器元数据中发现认证端点；若受支持，会通过动态客户端注册（DCR，RFC 7591）自动注册为 OAuth 客户端，随后使用 Authorization Code 配合 PKCE。在浏览器交互阶段，SigNoz 会要求提供你的实例 URL 和服务账户 API 密钥；MCP 服务器验证这些凭据后，会颁发 bearer/refresh token 供后续 MCP 请求使用。

对于不支持 OAuth 的客户端，SigNoz Cloud 的 MCP 服务器也支持基于请求头的身份验证。但出于更好的安全性和令牌管理考虑，建议在支持时优先使用 OAuth。

Warning

只有 Admin 用户才能创建 API 密钥。如果找不到该选项，请联系你的工作区管理员。

基于请求头的身份验证

部分 MCP 客户端（如 Cursor Automations）完全在云端运行，无法执行交互式 OAuth 认证。对这类客户端，请改用基于 header 的认证方式，直接在请求 header 中传入 API key 和实例 URL。

什么时候使用基于 header 的认证？

如果你的 MCP 客户端不支持 OAuth 流程或 stdio transport（例如 Cursor Automations），请使用下面这种基于 header 的配置。

mcp.json
{
  "mcpServers": {
    "signoz": {
      "url": "https://mcp.<region>.signoz.cloud/mcp",
      "headers": {
        "SIGNOZ-API-KEY": "<your-api-key>",
        "X-SigNoz-URL": "<your-signoz-instance-url>"
      }
    }
  }
}

请核对以下值：

  • <region>：你的 SigNoz Cloud region
  • <your-api-key>：来自 SigNoz Service accounts 的 API key
  • <your-signoz-instance-url>：你的 SigNoz Cloud 实例 URL
警告

妥善保管 API key：当 mcp.json 中包含密钥时，切勿将其提交到版本控制系统。

如果是 Self-Hosted SigNoz，你需要在本地运行 MCP server。该 server 支持两种 transport 模式：Stdio（本地二进制文件，由客户端启动）和 HTTP（独立 server，客户端通过网络连接）。

请使用最新版 SigNoz 搭配最新版 MCP server。MCP server 面向当前的 SigNoz API，较旧的 SigNoz 部署可能不支持所有工具。

获取你的 API key

  1. 登录你的 SigNoz 实例。
  2. 进入 Settings → Service Accounts。
  3. 创建一个 service account，打开其 Keys 标签页，点击 Add Key，然后复制生成的 key。详情参见 Service Accounts。
警告

只有 Admin 用户才能创建 API

原始来源： signoz

评论 (0)