操作场景
通过 MCP Server ( Model Context Protocol Server) 或 Dify Tool 查询日志服务 CLS 中存储的日志数据，以实现大模型平台/工具与日志数据的结合。例如以下使用场景：
使用自然语言查询日志，降低日志查询复杂度。
整合至运维排障流程中，智能分析系统异常。
MCP Server 及 Dify Tool 支持如下功能：
功能 | Dify Tool | MCP Server |
查询日志 | 支持 | 支持 |
根据自然语言生成日志查询语句 | 不支持（依赖通用大模型生成查询语句，准确率较低） | 支持 |
根据日志主题名称查询日志主题 ID | 不支持 | 支持 |
根据地域名称查询地域简称 | 不支持 | 支持 |
获取当前时间戳 | 不支持 | 支持 |
前提条件
被查询日志主题需为标准存储，且已开启 索引。
MCP Server 及 Dify Tool 通过腾讯云子账户访问日志服务，需 创建子账户 并授予如下权限：
{"version": "2.0","statement": [{"effect": "allow","action": ["cls:SearchLog","cls:DescribeTopics","cls:ChatCompletions"],"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","registryUrl": "","command": "npx","args": ["-y","cls-mcp-server"],"env": {"TRANSPORT": "stdio","TENCENTCLOUD_SECRET_ID": "YOUR_TENCENT_SECRET_ID","TENCENTCLOUD_SECRET_KEY": "YOUR_TENCENT_SECRET_KEY","TENCENTCLOUD_API_BASE_HOST": "tencentcloudapi.com","TENCENTCLOUD_REGION": "ap-guangzhou","MAX_LENGTH": "15000"}}}}
TRANSPORT：选填，MCP 传输协议，可选值：stdio（标准输入输出）或 sse（服务器发送事件），默认值：stdio。
TENCENTCLOUD_SECRET_ID：必填，腾讯云子用户 SecretId。
TENCENTCLOUD_SECRET_KEY：必填，腾讯云子用户 SecretKey。
TENCENTCLOUD_API_BASE_HOST：选填，腾讯云 API 请求域名。
注意：
如果您的账号限定了仅能通过内网地址访问腾讯云 API，请使用内网域名 internal.tencentcloudapi.com。
TENCENTCLOUD_REGION：选填，默认查询日志主题所属地域。
MAX_LENGTH：选填，大模型上下文长度限制，未指定时会将所有内容发送至大模型。
PORT：选填，仅 SSE 模式有效，指定服务端监听端口，默认值：3000。
使用示例
以 Cherry Studio 为例，演示 CLS MCP Server 配置方式：
1. 在设置 > MCP 服务器中编辑 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. 在对话框中使用自然语言查询日志。
说明：
