一、操作场景
·使用自然语言查询日志，降低日志查询复杂度。
·整合至运维排障流程中，智能分析系统异常。
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": [ "*" ] } ]}
三、安装方式一：本地标准输入输出模式（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=httpTENCENTCLOUD_SECRET_ID=<YOUR_SECRET_ID>TENCENTCLOUD_SECRET_KEY=<YOUR_SECRET_KEY># 如在内网使用 MCP，或管理员限定了仅能通过内网方式访问腾讯云 API，请取消下行注释# TENCENTCLOUD_API_BASE_HOST=internal.tencentcloudapi.comPORT=3000TZ=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。