tencent cloud

Cloud Log Service

ドキュメントCloud Log ServiceAIの利用MCP Server/Dify Toolを介したログ検索

MCP Server/Dify Toolを介したログ検索

ダウンロード
フォーカスモード
フォントサイズ
最終更新日: 2026-10-12 15:13:58
AI翻訳・品質チェック済み

操作シナリオ

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プロジェクトで詳細情報を確認できます。

前提条件

Tencent Cloudサブユーザーキー（SecretId/SecretKey）を使用してCLSにアクセスする必要があります。まずサブユーザーを作成し、以下の権限を付与してから、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

インストール方法1：ローカル標準入出力モード（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：必須項目です。前提条件に記載されているTencent CloudサブユーザーのSecretIdです。
TENCENTCLOUD_SECRET_KEY：必須項目です。前提条件に記載されているTencent CloudサブユーザーのSecretKeyです。
TENCENTCLOUD_API_BASE_HOST：任意項目です。TencentCloud APIリクエストドメインです。
注意：
内網でMCPを使用する場合、または管理者が内部ネットワーク経由でのみTencentCloud APIにアクセスできるように制限している場合は、内部ドメイン internal.tencentcloudapi.com を使用してください。
TZ：任意項目です。システムのタイムゾーンです。

インストール方法2：リモート/スタンドアロンサービスモード（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を使用する場合、または管理者が内部ネットワーク経由でのみTencentCloud APIにアクセスできるように制限している場合は、次の行のコメントを解除してください。
# TENCENTCLOUD_API_BASE_HOST=internal.tencentcloudapi.com
PORT=3000
TZ=Asia/Shanghai
TRANSPORT：必須項目です。MCP伝送プロトコルです。このデプロイメントモードではhttpを使用してください。
TENCENTCLOUD_SECRET_ID：必須項目です。前提条件に記載されているTencent CloudサブユーザーのSecretIdです。
TENCENTCLOUD_SECRET_KEY：必須項目です。前提条件に記載されているTencent CloudサブユーザーのSecretKeyです。
TENCENTCLOUD_API_BASE_HOST：任意項目です。TencentCloud 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マーケットに入り、Tencent Cloud CLSプラグインをインストールします。Difyマーケットで「cls」を直接検索することもできます。
2. インストール完了後、そのプラグインをクリックし、次にAPI Key 認証設定をクリックしてください。
3. 前提条件に記載されているTencent CloudサブユーザーのSecretIdとSecretKeyを入力し、デフォルトでクエリするログトピックを設定してください。
4. 保存をクリックして、プラグインのインストールと設定を完了します。
注意：
この方式はサポートする機能が少ないため、MCP Serverの使用をおすすめします。

前の記事へ: Agent Traceフィールド定義の説明次の記事へ: SkillによるCLSの使用

ヘルプとサポート

この記事はお役に立ちましたか？

フィードバック

キーワードで検索
    Enter keywords to search documentation