ONE MCP 服务 是 Bonree ONE 平台内置的 MCP Server，在 资源市场 > 工具 > MCP 服务 列表中始终置顶，带「内置」标识，不可编辑或删除。
该服务当前提供 61 个工具，覆盖告警、事件、日志、链路、实体、指标、终端应用、关系拓扑、标签、观测视角、仪表盘等能力。智能体在创作空间编排时可勾选这些工具；外部 MCP 客户端可通过 MCP Key 以相同工具集访问平台数据。
在 ONE MCP 服务详情抽屉的 「工具」 Tab 中，可按标签分类筛选，点击左侧工具名称查看描述、输入参数与输出示例。
（配图：ONE MCP 服务工具列表与标签分类筛选）
工具分类概览
| 分类 | 工具数 | 说明 |
|---|
| 告警 | 2 | 单条告警详情与告警列表检索 |
| 事件 | 2 | 事件列表与事件类型字典 |
| 日志 | 2 | 结构化日志与原始日志查询 |
| 链路 | 3 | APM 调用链列表与详情 |
| 实体 | 4 | 实体搜索、列表、类型与属性 |
| 基础设施 | 1 | 主机 Top 进程查询 |
| 指标 | 4 | 指标数据、元数据、维度与时序 |
| 系统服务 | 3 | 连接池、慢 SQL、异常比例 |
| 通用 | 2 | HTTP 请求与定时任务 |
| 终端应用 | 13 | 崩溃/ANR/JS 错误/网络请求与应用管理 |
| 关系 | 3 | 实体关联与拓扑子图 |
| 标签 | 11 | 标签与标签 Key 的增删改查 |
| 观测洞察 | 5 | APM 观测视角管理 |
| 仪表盘 | 6 | 仪表盘查询与卡片管理 |
| 工具名称 | 标识符 | 简要说明 |
|---|
| 获取告警详情 | get_alert_by_id | 已知 alert_id 时查询单条告警详情，获取摘要、关联实体、建议分析时间窗，供后续查指标/日志/链路 |
| 告警列表 | search_alerts | 按时间范围等条件批量检索告警列表 |
| 工具名称 | 标识符 | 简要说明 |
|---|
| 事件列表 | list_events | 查询指定实体或账号环境下的事件列表 |
| 事件类型列表 | list_event_types | 查询可用于筛选的事件类型字典 |
| 工具名称 | 标识符 | 简要说明 |
|---|
| 日志列表 | list_logs | 按模式字符串查询多目标/多账号下的日志 |
| 原始日志查询 | query_raw_logs | 查询目标/账号的原始日志列表 |
| 工具名称 | 标识符 | 简要说明 |
|---|
| 查询 APM 调用链列表 | list_apm_traces | 查询 APM 错误/慢调用链列表 |
| 查询调用链详情 | get_trace_detail_by_id | 按 ID 获取调用链详细信息 |
| 查询有效调用链详情 | get_effective_trace_detail | 在已知实体上下文下获取有效调用链详情 |
| 工具名称 | 标识符 | 简要说明 |
|---|
| 搜索实体 | search_entity | 按实体类型与关键字搜索实体实例 |
| 获取实体列表 | get_entities | 获取实体实例列表 |
| 查询实体类型 | list_entity_types | 查询可用实体类型 |
| 获取实体属性 | list_entity_fields | 查询实体类型的属性字段 |
基础设施
| 工具名称 | 标识符 | 简要说明 |
|---|
| 按资源类型查 Top 进程 | list_host_top_processes_by_resource | 按资源类型查询主机 Top 进程占用 |
| 工具名称 | 标识符 | 简要说明 |
|---|
| 指标数据查询 | query_metric | 查询指标数据 |
| 指标元数据查询 | search_metric_metadata | 搜索指标元数据 |
| 获取指标维度 | list_metric_dimensions_by_metric_id | 按指标 ID 获取维度信息 |
| 指标时序数据 | query_metric_by_target_id | 按目标 ID 查询指标时序数据 |
系统服务
| 工具名称 | 标识符 | 简要说明 |
|---|
| 查询连接池列表 | list_connection_pools | 查询数据库连接池列表 |
| 慢 SQL 语句查询 | list_top_slow_sql | 查询 Top 慢 SQL |
| 异常比例 TOP 列表及详情 | list_apm_error_ratio | 查询 APM 异常比例 TOP 及详情 |
| 工具名称 | 标识符 | 简要说明 |
|---|
| 通用 HTTP 请求 | send_http_request | 发送通用 HTTP 请求 |
| 创建定时任务 | create_scheduled_task | 创建定时任务 |
终端应用
| 工具名称 | 标识符 | 简要说明 |
|---|
| 获取应用崩溃列表 | list_app_crash | 查询终端应用崩溃列表 |
| 获取应用 JS 错误列表 | list_app_js_error | 查询 JS 错误列表 |
| 获取应用 ANR 列表 | list_app_anr | 查询 ANR 列表 |
| 查询崩溃详情 | get_app_crash_detail | 查询单条崩溃详情 |
| 查询 ANR 详情 | get_app_anr_detail | 查询单条 ANR 详情 |
| 查询 JS 错误详情 | get_app_js_error_detail | 查询单条 JS 错误详情 |
| 查询应用网络请求列表 | list_app_request | 查询应用网络请求列表 |
| 查询网络请求详情 | get_app_request_detail | 查询单条网络请求详情 |
| 创建终端应用 | create_app | 创建终端应用 |
| 删除终端应用 | delete_app | 删除终端应用 |
| 更新终端应用监控状态 | update_app_monitor_state | 更新终端应用监控启停状态 |
| 查询终端数据采集配置 | get_data_collect_config | 查询终端数据采集配置 |
| 修改终端数据采集配置 | update_data_collect_config | 修改终端数据采集配置 |
| 工具名称 | 标识符 | 简要说明 |
|---|
| 按关系边查询一跳关联实体 | get_one_hop_related_entities | 按关系边查询一跳关联实体 |
| 按指标维度关联查询实体 | get_related_entities_by_metric | 通过指标维度关联查询相关实体 |
| 查询实体关联子图 | get_entity_subgraph | 查询实体关联拓扑子图 |
| 工具名称 | 标识符 | 简要说明 |
|---|
| 查询标签列表 | list_user_tags | 查询用户标签列表 |
| 创建标签 | create_tag | 创建标签 |
| 更新标签 | update_tag | 更新标签 |
| 删除标签 | delete_tag | 删除标签 |
| 查询标签 Key 列表 | list_tag_keys | 查询标签 Key 列表 |
| 创建标签 Key | create_tag_key | 创建标签 Key |
| 编辑标签 Key | update_tag_key | 编辑标签 Key |
| 删除标签 Key | delete_tag_key | 删除标签 Key |
| 查询 Key 下标签列表 | list_tags_by_key | 查询指定 Key 下的标签列表 |
| 实体添加标签 | add_entity_tags_batch | 批量为实体添加标签 |
| 实体移除标签 | remove_entity_tags | 为实体移除标签 |
观测洞察
| 工具名称 | 标识符 | 简要说明 |
|---|
| 查询 APM 观测视角列表 | list_observation_perspectives | 查询观测视角列表 |
| 创建 APM 观测视角 | create_observation_perspective | 创建观测视角 |
| 更新 APM 观测视角 | update_observation_perspective | 更新观测视角 |
| 删除 APM 观测视角 | delete_observation_perspective | 删除观测视角 |
| 查询 APM 观测视角可用实体类型 | list_observation_entity_types | 查询观测视角下可用实体类型 |
仪表盘
| 工具名称 | 标识符 | 简要说明 |
|---|
| 查询仪表盘列表 | list_dashboards | 查询仪表盘列表 |
| 查询仪表盘详情 | get_dashboard | 查询单个仪表盘详情 |
| 创建仪表盘 | create_dashboard | 创建仪表盘 |
| 修改仪表盘名称 | update_dashboard_name | 修改仪表盘名称 |
| 向仪表盘添加卡片 | create_dashboard_component | 向仪表盘添加可视化卡片 |
| 批量删除仪表盘 | delete_dashboards | 批量删除仪表盘 |
如何使用
在智能体编排中选用
- 在 创作空间 创建或编辑智能体，进入 MCP 工具配置步骤。
- 从 ONE MCP 服务 提供的工具列表中勾选所需工具（可参考上表分类选型）。
- 发布智能体后，在 Sage AI 或自动化中调用。
在详情页查看单个工具说明
- 资源市场 > 工具，点击 ONE MCP 服务 卡片。
- 在 「工具」 Tab 使用标签下拉筛选分类，或搜索工具名称。
- 点击工具查看触发条件、用途、边界、参数与输出示例。
通过 MCP Key 在外部客户端调用
外部 MCP 客户端使用 MCP Key 连接后，可调用上表中的同一套工具；数据范围受 Key 绑定的环境与资源域限制。
注意事项
- 工具清单与分类以平台当前版本为准；ONE MCP 服务升级后工具数量或名称可能变化，请以界面展示为准。
- 部分工具有明确的使用边界（如
get_alert_by_id 仅用于已知 ID 的单条查询，批量请用 search_alerts），请在详情页阅读说明后再编排。
- 内置 ONE MCP 服务不可删除；自定义 MCP Server 的工具不在本文档范围内。
- 工具参数与返回结构以详情页 输出示例 为准；编排智能体时建议先通过 Sage AI 或调试面板试跑验证。
延伸阅读