帮你快速理解、总结文档立即下载
文档中心>腾讯云可观测平台>应用性能监控>实践教程>APM MCP Server

APM MCP Server

最近更新时间：2026-10-14 09:36:02
我的收藏

本页目录：

操作场景

通过 MCP Server（Model Context Protocol Server），能够 AI coding Agent（如 Claude Desktop、Cursor、WorkBuddy 等）深度集成应用性能监控的能力，实现大模型平台/工具与可观测数据的结合。例如以下使用场景：
使用自然语言查询应用性能数据，降低监控数据获取复杂度。
整合至运维排障流程中，智能分析调用链异常根因。
一键关联查询 Trace 与 CLS 日志，无需在多个工具间切换。
批量核查应用探针版本、APM 用量计费等运维数据。

能力说明

业务系统与用量：
工具
描述
DescribeApmOverview
APM 概览查询，支持业务系统列表、应用列表、接口列表三层下钻
DescribeApmCombo
查询账号下 APM 套餐包列表
DescribeApmConsumption
查询 APM 用量与计费统计
DescribeAgentVersion
查询业务系统下探针 / 应用维度的标签值
指标查询与性能分析：
工具
描述
DescribeGeneralMetric
通用指标查询，支持走势线 / 指标点两种模式，自动注入 SQL / MQ / ERROR 场景默认指标
DescribeApmMetricByFields
自由组合 metrics + group_by 的开放式指标查询
DescribeMetricAnalyze
指标根因分析，自动按多维度交叉查询找出导致异常的候选维度及关联 trace_id
DescribeProfileTask
查询性能剖析任务列表与火焰图详情
调用链与日志：
工具
描述
DescribeGeneralSpanTree
查询 Trace 调用树，支持按错误 / 慢调用场景抽样并下钻根因
DescribeSpanTagList
查询 Span 列表，通过 filters 过滤出相关 TraceID / SpanID
QueryTraceLogs
查询 Trace 关联的 CLS 日志，实现调用链 + 日志联合分析

前提条件

准备腾讯云 API 凭证：MCP 服务通过调用腾讯云 API 获取监控数据，需要准备访问密钥（SecretId/SecretKey），建议使用腾讯云子用户密钥，请先 新建子用户，并为其授予 APM 只读权限，如需使用 Trace 关联日志查询功能，需额外关联 CLS 只读策略，再前往 API 密钥管理 页面获取密钥。多人协作场景下，建议优先使用 STS 临时凭证，有效期可控。
运行环境：MCP 服务运行依赖 Node.js 16 或更高版本。首次使用需先安装 Node.js 环境。

接入方式

在 AI coding Agent（如 Claude Desktop 、WorkBuddy 、Cursor）的 MCP 配置文件中，添加以下配置，Agent 会自动通过 npx 命令拉取并启动 MCP 服务。

使用腾讯云用户的访问密钥

{
  "mcpServers": {
    "tapm-mcp": {
      "command": "npx",
      "args": ["-y", "tapm-mcp"],
      "env": {
        "TENCENTCLOUD_SECRET_ID": "<SECRET_ID>",
        "TENCENTCLOUD_SECRET_KEY": "<SECRET_KEY>"
      }
    }
  }
}
对应字段说明：
<SECRET_ID>：腾讯云用户的 SecretId。
<SECRET_KEY>：腾讯云用户的 SecretKey。

使用 STS 临时凭证

{
  "mcpServers": {
    "tapm-mcp": {
      "command": "npx",
      "args": ["-y", "tapm-mcp"],
      "env": {
        "TENCENTCLOUD_SECRET_ID": "<SECRET_ID>",
        "TENCENTCLOUD_SECRET_KEY": "<SECRET_KEY>",
        "TENCENTCLOUD_TOKEN": "<TOKEN>"
      }
    }
  }
}

对应字段说明：
<SECRET_ID>：STS 临时凭证中获取的密钥 ID。
<SECRET_KEY>：STS 临时凭证中获取的密钥 Key。
<TOKEN>：STS 临时凭证中获取的 Token。

中国站