操作场景
通过 MCP Server ( Model Context Protocol Server) 或 Dify Tool 查询日志服务 CLS 中存储的日志数据，以实现大模型平台/工具与日志数据的结合。例如以下使用场景：
使用自然语言查询日志，降低日志查询复杂度。
整合至运维排障流程中，智能分析系统异常。
MCP Server 及 Dify Tool 支持如下功能：
功能 | MCP Server | Dify Tool |
日志主题查询 | 支持 | 支持 |
指标主题查询 | 支持 | 不支持 |
告警查询 | 支持 | 不支持 |
根据自然语言生成日志查询语句 | 支持 | 不支持 依赖通用大模型生成查询语句，准确率较低 |
辅助工具 | 支持 根据主题名称查询主题 ID 根据地域名称查询地域简称 时间戳转换 | 不支持 |
说明：
前提条件
{"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
安装说明
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（标准输入输出）或 sse（服务器发送事件），默认值：stdio。
TENCENTCLOUD_SECRET_ID：必填，前提条件 中的腾讯云子用户 SecretId。
TENCENTCLOUD_SECRET_KEY：必填，前提条件 中的腾讯云子用户 SecretKey。
TENCENTCLOUD_API_BASE_HOST：选填，腾讯云 API 请求域名。
注意：
如果您在内网使用 MCP，或管理员限定了仅能通过内网方式访问腾讯云 API，请使用内网域名 internal.tencentcloudapi.com。
使用示例
以 Cherry Studio 为例，演示 CLS MCP Server 配置方式：
1. 在设置 > MCP 服务器中编辑 JSON 配置，添加上述 JSON 配置，然后单击确定保存配置。
2. 保存配置后，单击 cls-mcp-server > 工具，如果能查看到可用工具列表，说明安装成功。
3. 在助手中添加并编辑助手，填写如下提示词：
在模型设置中选择合适的模型（首次使用 Cherry Studio 时，请在 Cherry Studio 设置菜单中配置模型服务）：
在 MCP 服务器中启用 cls-mcp-server。
4. 使用自然语言查询日志。
Dify Tool
安装说明
1. 单击链接 Tencent Cloud cls - Dify Marketplace 进入 Dify 市场，安装腾讯云日志服务插件，也可在 Dify 市场中直接搜索“cls”。
2. 完成安装后，单击该插件，再单击去授权。
3. 填写 前提条件 中的腾讯云子用户 SecretId 及 SecretKey，并设定默认查询的日志主题。
4. 单击保存完成插件安装及配置。
使用示例
1. 在 Dify 工作室中单击创建空白应用。
应用类型选择 Agent。
2. 在底部的工具中添加腾讯云日志服务 > CLS 日志检索分析。
3. 在右上角选择需要使用的大模型（首次使用时需安装该模型）。
4. 在对话框中使用自然语言查询日志。
说明：