关于 Coralogix
Coralogix MCP Server 是面向应用与基础设施排查的托管连接服务,供团队查询 Coralogix 可观测性数据。MCP 客户端可查询遥测信息并管理部分可观测性对象;公开仓库提供文档和连接元数据,不含服务端实现。
主要功能
- 01查询日志、跨度和数据集
- 02运行 PromQL 指标查询
- 03排查告警与案例
- 04探索服务依赖图和目录
- 05搜索仪表板与已保存视图
- 06检查 RUM 和 AI Center 数据
适用场景
- 01查找某个服务的常见错误
- 02沿案例时间线追踪告警
- 03查看指定时段的延迟百分位数
MCP 相关
远程 MCP 服务向 MCP 客户端提供 Coralogix 可观测性查询与管理工具,涵盖日志、指标、追踪、RUM、告警、案例、仪表板和服务目录数据。服务由 Coralogix 托管,支持 OAuth 2.1 或 Bearer API 密钥认证。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://api.{region}.coralogix.com/mgmt/api/v1/mcpclaude mcp add --transport http com-coralogix https://api.{region}.coralogix.com/mgmt/api/v1/mcp{"mcpServers":{"com-coralogix":{"type":"http","url":"https://api.{region}.coralogix.com/mgmt/api/v1/mcp"}}}在 Cursor 中打开{"servers":{"com-coralogix":{"type":"http","url":"https://api.{region}.coralogix.com/mgmt/api/v1/mcp"}}}在 VS Code 中打开{"mcpServers":{"com-coralogix":{"type":"http","url":"https://api.{region}.coralogix.com/mgmt/api/v1/mcp"}}}{"mcpServers":{"com-coralogix":{"serverUrl":"https://api.{region}.coralogix.com/mgmt/api/v1/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
https://api.{region}.coralogix.com/mgmt/api/v1/mcp需要授权工具
详细介绍
Coralogix MCP 服务
通过任意 Model Context Protocol 客户端查询和调查 Coralogix 可观测性数据——日志、跨度、指标、RUM、告警、案例、仪表板和服务目录。
该服务是完全托管的远程服务。无需安装、构建或运行任何内容。
https://api.<region>.coralogix.com/mgmt/api/v1/mcp
关于此代码仓库。 这是 Coralogix MCP 文档、连接示例和注册表元数据的公开存放处。服务实现由 Coralogix 私下维护;此仓库不包含服务源代码。请参阅贡献指南。
快速开始
选择客户端,替换为你的区域,然后连接。首次使用时会在浏览器中运行 OAuth——无需 API 密钥。
Claude Code
claude mcp add --transport http coralogix https://api.eu2.coralogix.com/mgmt/api/v1/mcp
Cursor — .cursor/mcp.json
{
"mcpServers": {
"coralogix": {
"url": "https://api.eu2.coralogix.com/mgmt/api/v1/mcp"
}
}
}
Codex
codex mcp add coralogix --url "https://api.eu2.coralogix.com/mgmt/api/v1/mcp"
这些客户端及其他客户端的完整可复制粘贴配置见 examples/clients/。
然后向你的助手提问:
“显示过去一小时内
payments-api服务最常见的错误。” “这个告警为什么会触发?按时间顺序带我了解整个案例。” “过去 24 小时内,checkout 的 p99 延迟是多少?”
更多示例见 examples/prompts/。
功能
71 个工具,涵盖 21 个功能领域——默认启用 65 个;设置 x-allow-costly-use 后,还可使用 6 个 Olly Agent 工具。此外还有 20 个技能,可按需教会模型 Coralogix 查询语言和调查工作流。
| 领域 | 涵盖内容 |
|---|---|
| 日志、跨度和数据集 | 使用 DataPrime 查询日志、跨度和命名数据集 |
| 指标 | PromQL 即时和范围查询、指标与标签发现 |
| 告警和案例 | 告警定义、告警事件、案例分诊与生命周期管理 |
| 服务目录 | RED 指标——错误率、延迟百分位数、吞吐量、饱和度 |
| 服务映射 | 服务间依赖关系图 |
| 基础设施 | 资源清单、运行状况历史记录、原始资源数据 |
| RUM | 真实用户监控——Web Vitals、前端错误、会话 |
| 仪表板 | 列出、搜索、创建、替换和删除仪表板及文件夹 |
| 已保存视图 | 管理已保存的日志视图和视图文件夹 |
| 数据用量 | 计费摄取量、配额归属、用量趋势 |
| AI Center | 观测和评估生成式 AI 应用、护栏及模型定价 |
| 字段发现 | 跨日志和跨度字段进行语义搜索 |
| 架构 | 数据集架构和可用字段 |
| DataPrime 语言 | 命令和函数参考、构造指导 |
| 文档 | 搜索和获取 Coralogix 文档 |
| 实用工具 | 当前 UTC 时间,用于确定相对时间范围 |
| Olly Agent | Coralogix 自然语言可观测性 Agent(可选启用) |
工具会声明 MCP 注解(readOnlyHint、destructiveHint、openWorldHint),让客户端了解哪些操作需要审批。大多数工具为只读;会更改状态的 manage_* 工具会标记为具有破坏性。
- 完整的逐工具参考 →
docs/tools.md - 机器可读清单 →
resources/tools.json - 技能参考 →
docs/skills.md
文档
| 快速入门 | 连接、验证并运行首次查询 |
| 区域 | 每个 Coralogix 区域对应的端点 URL |
| 身份验证 | OAuth 2.1 和 API 密钥、权限、租户 |
| 工具目录 | 当前全部 71 个工具,以及 12 个已弃用工具,附带注释 |
| 技能 | 20 个渐进式披露技能 |
| 请求头和版本管理 | mcp-version、x-allow-costly-use |
| 故障排除 | 常见故障及其含义 |
| 注册表发布 | server.json 的发布和验证方式 |
Agent:请从 llms.txt 开始。
注册表
注册表元数据位于 server.json 中,并遵循 MCP 官方注册表架构。
| 注册表名称 | com.coralogix/mcp-server |
| 传输方式 | streamable-http |
| 服务版本 | 2.0.0 |
| 身份验证 | OAuth 2.1(OIDC)或 Bearer API 密钥 |
支持
- 产品文档 — coralogix.com/docs/user-guides/mcp-server/setup
- 本文档中的错误和功能请求 — 提交 GitHub issue
- 服务、账户或数据问题 — 通过常用渠道联系 Coralogix 支持团队
- 隐私 — Coralogix 隐私政策
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。