一、操作场景
·使用自然语言查询应用性能数据，降低监控数据获取复杂度。
·整合至运维排障流程中，智能分析调用链异常根因。
·一键关联查询 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。