CLS MCP Server를 사용하여 LLM에서 CLS 로그 쿼리하기

로그 트러블슈팅 (troubleshooting)이 복잡한 쿼리 구문에 의존할 때, 가장 느린 단계는 운영상의 질문을 적절한 쿼리로 변환하는 과정인 경우가 많습니다. 원문 기사는 Model Context Protocol (MCP)을 통해 대규모 언어 모델 (LLM)을 CLS 로그 데이터에 연결하는 방법으로 Tencent Cloud Log Service (CLS) MCP Server를 소개합니다.

실질적인 목표는 간단합니다. 운영자가 자연어 질문을 던지면, MCP Server가 쿼리를 생성하거나 지원하고, 그 다음 CLS 로그 토픽 (log topics)을 데이터 소스로 사용하는 것입니다.

CLS MCP Server란 무엇인가

원문에서는 Model Context Protocol (MCP) Server를 MCP 프로토콜을 기반으로 하는 경량 서비스 프로그램으로 설명합니다. 이는 표준화된 인터페이스를 통해 LLM을 데이터베이스, API 또는 파일과 같은 외부 리소스와 연결합니다.

CLS의 경우, 해당 외부 리소스는 CLS 로그 토픽에 저장된 로그 데이터입니다.

핵심 기능

원문 기사의 CLS MCP Server는 세 가지 기능을 제공합니다:

기능	역할
로그 쿼리 (Log querying)	쿼리 문에 따라 CLS 로그 토픽에 저장된 로그 데이터를 조회합니다.
...

전형적인 운영 시나리오

기사에서는 세 가지 일반적인 사용 사례를 제시합니다:

시나리오	운영자 질문 또는 워크플로 예시
장애 트러블슈팅 (Incident troubleshooting)	시스템이 비정상적으로 작동할 때 현재 에러 로그를 분석하여 문제를 더 빠르게 찾아냅니다.
...

설정 전제 조건

원문의 설정은 두 가지 요구 사항으로 시작합니다:

1. Node.js 런타임 설치.
2. Tencent Cloud 서브 계정(sub-account)을 생성하고, 필요한 CLS 권한을 부여한 뒤, SecretId 및 SecretKey를 획득합니다.

원문 기사의 다음 권한 정책을 사용하십시오:

{
    "version": "2.0",
    "statement": [
...

MCP 설정 추가

기사에서는 Cherry Studio를 설정 예시로 사용합니다.

다음 MCP 서버 설정을 사용하고, 플레이스홀더 자격 증명을 본인의 값으로 교체하세요:

{
   "mcpServers": {
      "cls-mcp-server": {
...

중요한 운영상의 세부 사항은 LLM이 단순히 정적인 프롬프트(static prompt)만 받는 것이 아니라는 점입니다. MCP 서버는 로그 쿼리(log query)를 실행하기 전에 토픽 조회(topic lookup) 및 리전 조회(region lookup)와 같은 CLS 관련 헬퍼 함수(helper functions)를 호출할 수도 있습니다.

Dify Tool vs MCP Server

원본 기사는 기존의 CLS Dify Tool과 CLS MCP Server를 비교하기도 합니다.

기능	Dify Tool	MCP Server
로그 쿼리 (Query logs)	지원됨	지원됨
...

재사용 가능한 구현 체크리스트

설정을 조정할 때 다음 체크리스트를 사용하세요:

1. 대상 CLS 로그 토픽(topic) 및 리전(region)을 확인합니다.
2. Tencent Cloud 서브 계정(sub-account)을 생성하거나 선택합니다.
3. 원본 정책에 표시된 작업(actions)만 부여합니다: cls:SearchLog, cls:DescribeTopics, cls:ChatCompletions.
4. LLM 클라이언트에 MCP 서버 설정을 추가합니다.
5. TENCENTCLOUD_SECRET_ID, TENCENTCLOUD_SECRET_KEY, TENCENTCLOUD_REGION을 교체합니다.
6. 에러 로그 쿼리나 로그인 실패 쿼리와 같이 좁은 범위의 운영 질문을 먼저 던집니다.
7. 생성된 쿼리와 반환된 로그 토픽 컨텍스트(context)가 의도한 대상과 일치하는지 확인합니다.

FAQ

CLS MCP Server는 어떤 문제를 해결하나요?

모델을 CLS 로그 쿼리 기능 및 CLS 컨텍스트 헬퍼(context helpers)에 연결함으로써, LLM이 운영 로그 분석 요청을 이해할 수 있도록 돕습니다.

원본 기사에서 요구되는 CLS 권한은 무엇인가요?

원본 정책은 cls:SearchLog, cls:DescribeTopics, cls:ChatCompletions 권한을 부여합니다.

토픽 및 리전 조회가 왜 유용한가요?

원본 기사에 따르면, 이러한 헬퍼들은 필요한 로그 토픽을 더 빠르게 찾을 수 있게 하며, 로그 쿼리를 생성하거나 실행할 때 LLM의 환각(hallucination)을 줄여줍니다.