tencent cloud

日志服务

文档日志服务开发者指南MCP Server/Dify Tool 日志查询

MCP Server/Dify Tool 日志查询

Download
聚焦模式
字号
最后更新时间： 2026-05-19 22:04:52

操作场景

通过 MCP Server ( Model Context Protocol Server) 或 Dify Tool 查询日志服务 CLS 中存储的日志数据，以实现大模型平台/工具与日志数据的结合。例如以下使用场景：
使用自然语言查询日志，降低日志查询复杂度。
整合至运维排障流程中，智能分析系统异常。
MCP Server 及 Dify Tool 支持如下功能：
功能
MCP Server
Dify Tool
日志主题查询
支持
支持
指标主题查询
支持
不支持
告警查询
支持
不支持
根据自然语言生成日志查询语句
支持
不支持
（依赖通用大模型生成查询语句，准确率较低）
辅助工具
支持
根据主题名称查询主题 ID
根据地域名称查询地域简称
时间戳转换
不支持
说明：
CLS MCP Server 已在 Github 中开源，您可前往 cls-mcp-server 项目查看详细信息。

前提条件

需使用腾讯云子用户密钥（SecretId/SecretKey）访问日志服务，请先 新建子用户，并为其授予以下权限，再前往 API 密钥管理 页面获取密钥。
{
    "version": "2.0",
    "statement": [
        {
            "effect": "allow",
            "action": [
                "cls:SearchLog",
                "cls:DescribeLogContext",
                "cls:ChatCompletions",
                "cls:DescribeIndex",
                "cls:DescribeIndexs",
                "cls:DescribeLogHistogram",
                "cls:QueryMetric",
                "cls:QueryRangeMetric",
                "cls:DescribeAlarms",
                "cls:DescribeAlertRecordHistory",
                "cls:GetAlarmLog",
                "cls:DescribeAlarmNotices",
                "cls:DescribeAlarmShields",
                "cls:DescribeNoticeContents",
                "cls:DescribeWebCallbacks",
                "cls:DescribeTopics"
            ],
            "resource": [
                "*"
            ]
        }
    ]
}

MCP Server

安装方式一：本地标准输入输出模式（stdio）

适用于本地开发与个人使用，例如在本地的 Claude Desktop、Cursor、VS Code 中使用。
1. 安装 Node.js，建议使用 LTS（long-term support）版本。
2. 在 MCP Server 配置文件中添加如下配置：
{
	"mcpServers": {
		"cls-mcp-server": {
			"isActive": true,
			"name": "cls-mcp-server",
			"type": "stdio",
			"command": "npx",
			"args": [
				"-y",
				"cls-mcp-server@latest"
			],
			"env": {
                "TRANSPORT": "stdio",
                "TENCENTCLOUD_SECRET_ID": "YOUR_TENCENT_SECRET_ID",
				"TENCENTCLOUD_SECRET_KEY": "YOUR_TENCENT_SECRET_KEY",
				"TENCENTCLOUD_API_BASE_HOST": "tencentcloudapi.com",
				"TZ": "Asia/Shanghai"
			}
		}
	}
}
TRANSPORT：选填，MCP 传输协议，该部署模式下建议使用 stdio。
TENCENTCLOUD_SECRET_ID：必填，前提条件 中的腾讯云子用户 SecretId。
TENCENTCLOUD_SECRET_KEY：必填，前提条件 中的腾讯云子用户 SecretKey。
TENCENTCLOUD_API_BASE_HOST：选填，腾讯云 API 请求域名。
注意：
如果您在内网使用 MCP，或管理员限定了仅能通过内网方式访问腾讯云 API，请使用内网域名 internal.tencentcloudapi.com。
TZ：选填，系统时区。

安装方式二：远程/独立服务模式（Streamable HTTP）

适用于团队共享、远程部署，例如对接企业内部的 AI 平台。
1. 安装 Node.js，建议使用 LTS（long-term support）版本。
2. 
在服务器当前目录创建 .env 文件：

TRANSPORT=http
TENCENTCLOUD_SECRET_ID=<YOUR_SECRET_ID>
TENCENTCLOUD_SECRET_KEY=<YOUR_SECRET_KEY>
# 如在内网使用 MCP，或管理员限定了仅能通过内网方式访问腾讯云 API，请取消下行注释
# TENCENTCLOUD_API_BASE_HOST=internal.tencentcloudapi.com
PORT=3000
TZ=Asia/Shanghai
TRANSPORT：必填，MCP 传输协议，该部署模式下请使用 http。
TENCENTCLOUD_SECRET_ID：必填，前提条件 中的腾讯云子用户 SecretId。
TENCENTCLOUD_SECRET_KEY：必填，前提条件 中的腾讯云子用户 SecretKey。
TENCENTCLOUD_API_BASE_HOST：选填，腾讯云 API 请求域名。
PORT：选填，监听端口。
TZ：选填，系统时区。
3. 启动服务。
npx -y cls-mcp-server@latest
4. 在 MCP 客户端中配置。
{
  "mcpServers": {
    "cls-mcp-server": {
      "name": "cls-mcp-server",
      "type": "http",
      "isActive": true,
      "url": "http://localhost:3000/mcp"
    }
  }
}

注意：
请将 url 中的 localhost:3000 替换为 步骤2 中实际的服务器 IP 及 PORT。

更多安装方式

更多安装方式详见 cls-mcp-server 开源项目说明。

Dify Tool

1. 单击链接 Tencent Cloud cls - Dify Marketplace 进入 Dify 市场，安装腾讯云日志服务插件，也可在 Dify 市场中直接搜索“cls”。
2. 完成安装后，单击该插件，再单击 API Key 授权配置。
3. 填写 前提条件 中的腾讯云子用户 SecretId 及 SecretKey，并设定默认查询的日志主题。
4. 单击保存完成插件安装及配置。
注意：
该方式支持功能较少，建议使用 MCP Server。

上一篇: 通过 Grafana 使用 CLS下一篇: History

帮助和支持

本页内容是否解决了您的问题？

填写满意度调查问卷，共创更好文档体验。

文档反馈