MCP 도구 목록¶

이 문서는 OWL MCP Server가 현재 MCP 래퍼 도구를 통해 호출할 수 있는 비즈니스 도구 기능을 설명합니다. 도구 분류, 권한 유형, 사용 규칙, 도구 개요 및 일반적인 MCP 사용 경로를 포함합니다.

도구의 가시 범위와 호출 결과는 현재 사용 중인 API Key의 권한에 따라 달라집니다. API Key에 관련 리소스 또는 작업 권한이 없으면 해당 도구 호출이 실패하거나 빈 결과를 반환할 수 있습니다.

도구 범위¶

OWL MCP Server에서 실행할 수 있는 비즈니스 도구는 플랫폼 기능에 따라 지속적으로 업데이트됩니다. 실제 실행 가능한 도구는 list_catalogs와 list_tools가 반환하는 도구 카탈로그를 기준으로 합니다.

현재 문서는 다음 비즈니스 분류를 다룹니다:

권한 유형¶

사용 규칙¶

MCP 클라이언트는 다음 순서로 호출해야 합니다:

1. list_catalogs를 호출하여 사용 가능한 분류를 확인합니다.
2. list_tools를 호출하여 catalog_id를 전달하고 해당 분류의 비즈니스 도구 및 매개변수를 확인합니다.
3. exec_tool을 호출하여 tool_name과 parameters를 전달하고 비즈니스 도구를 실행합니다.

도구 개요¶

Account¶

현재 API Key 워크스페이스와 동일 조직의 다른 워크스페이스를 검색하는 데 사용됩니다. 얻은 workspace_uuid는 owl.data.same_org.trace.query의 workspace_uuids 입력 매개변수로 사용되어 워크스페이스 간 트레이스 조회에 사용할 수 있습니다.

참고: 반환 결과의 workspace_uuid가 이후 workspace_uuids 입력 매개변수로 사용됩니다. workspace_id는 목록 페이지네이션에만 사용되며 Trace 조회 도구에 전달하지 마십시오.

Catalog¶

통합 카탈로그의 엔터티 유형 검색, 엔터티 조회, 엔터티 상세 정보 가져오기 및 토폴로지 관계 조회에 사용됩니다.

참고: 대시보드 도구(owl.dashboard.create / owl.dashboard.replace / owl.dashboard.get)는 OWL CLI에서만 제공되며 MCP 도구 목록에 나타나지 않습니다. 관련 사용법은 OWL CLI 문서를 참조하십시오.

Data¶

DQL namespace 탐색, 데이터 소스 및 필드 검색, 로그 인덱스 검색, SLO 조회, 로그 클러스터링 분석, 동일 조직 내 워크스페이스 간 트레이스 조회, MCP 클라이언트를 위한 간소화된 데이터 조회에 사용됩니다. 현재 MCP 측에서는 간소화된 조회 및 조회 보조 도구만 제공하며, 전체 DQL 또는 PromQL 사용자 정의 실행 도구는 포함하지 않습니다.

owl.data.same_org.trace.query의 workspace_uuids를 생략하거나 빈 배열로 전달하면 현재 워크스페이스만 조회합니다. 동일 조직 내 워크스페이스 간 조회 기능이 비활성화된 경우 현재 워크스페이스만 조회할 수 있습니다. 다른 워크스페이스 UUID를 전달하면 매개변수 오류가 반환됩니다.

Errors¶

오류 센터의 문제 목록 조회, 댓글 추가, 조회 및 업데이트에 사용됩니다.

Event¶

이벤트 센터 목록 조회 및 이벤트 상세 정보 가져오기에 사용됩니다.

• owl.event.list는 start_time과 end_time을 반드시 제공해야 합니다. status의 선택 가능한 값은 fatal, critical, error, warning, nodata이며, limit의 기본값은 20, 최대값은 100입니다. 반환 항목에는 이벤트 차원 태그 필드 df_dimension_tags가 포함될 수 있습니다.
• owl.event.get의 timeRange는 선택적 2요소 배열 [start, end]이며, 요소는 모두 13자리 밀리초 타임스탬프이고 end는 start보다 커야 합니다. 매개변수 이름은 timeRange이며 time_range로 변경하지 마십시오.

Incident¶

인시던트 목록, 인시던트 댓글, 작업 기록 및 온콜 스케줄 조회에 사용됩니다.

Infrastructure¶

인프라스트럭처 객체 목록 및 상세 정보 조회에 사용되며, 호스트, 컨테이너, 프로세스 등의 리소스 객체를 포함합니다.

LLM¶

LLM 관측 가능성 애플리케이션 목록 조회에 사용됩니다.

Member¶

워크스페이스 멤버 목록 조회 및 이름, 이메일 키워드 검색에 사용됩니다.

Monitor¶

모니터 목록 조회, 상세 정보 가져오기, 생성 또는 업데이트, 외부 이벤트 수신에 사용됩니다.

노트¶

현재 API Key 계정에서 볼 수 있는 노트를 관리하는 데 사용됩니다.

• owl.nbook_note.list의 page_index 기본값은 1, page_size 기본값은 20, 최대값은 100입니다.
• owl.nbook_note.get은 Markdown 본문 content를 반환하는 유일한 노트 도구이지만 path, etag, version은 반환하지 않습니다. list, add, modify는 요약만 반환하고 content, path, ETag, 버전 정보는 반환하지 않습니다. delete 응답은 백엔드의 기존 간소화된 구조를 유지합니다.
• type은 normal과 runbook을 지원합니다. owl.nbook_note.list는 type으로 필터링할 수 있으며, 생략하면 유형을 필터링하지 않습니다. owl.nbook_note.add는 type을 설정할 수 있으며, 생략하면 백엔드에서 normal 노트를 생성합니다. get과 modify의 응답에는 type이 포함되지만, get, modify, delete는 type 입력 매개변수를 허용하지 않으며, 기존 노트 유형은 수정할 수 없습니다.
• owl.nbook_note.add는 title과 content를 반드시 제공해야 하며 path는 허용되지 않습니다. created_source는 서버에서 ai로 고정 설정되며, 생성 계정은 현재 API Key에서 가져옵니다.
• owl.nbook_note.modify는 note_uuid 외에 title, content, tags, tag_kv 중 하나 이상을 제공해야 합니다. content를 생략하면 원본 본문이 유지됩니다.
• 가져오기, 수정 및 삭제는 모두 목록에서 반환된 note_uuid를 사용합니다. path, etag, if_match, version, creator, created_source 등 백엔드에서 관리하는 필드를 전달하지 마십시오.
• tagkv_query는 목록 도구에서 사용하는 TagKV 표현식 문자열이고, tag_kv는 생성 및 수정 도구에서 사용하는 키-값 객체이므로 혼용하지 마십시오.

Pipeline¶

Pipeline 목록 조회 및 샘플 검증에 사용됩니다.

mdsearch¶

통합 문서 코퍼스 검색, id 또는 path로 전체 문서 읽기, 코퍼스 디렉터리 구조 탐색에 사용되며, 중국어, 영어 및 혼합 검색을 지원합니다.

MCP 사용 경로¶

데이터 조회 관련 문제¶

"메트릭, 로그, RUM, APM, Network, Profile 데이터 조회" 등의 문제에 적합합니다.

1. exec_tool을 통해 owl.data.show_dql_namespace를 호출하여 데이터 namespace를 확인합니다.
2. 데이터 영역에 따라 exec_tool을 통해 검색 도구를 호출합니다:
3. 메트릭: owl.metric.list
4. RUM: owl.rum.list
5. APM: owl.apm.list
6. Network: owl.network.list
7. Profile: owl.profile.list
8. 로그: owl.logging.list
9. 클라우드 청구: owl.billing.list
10. 로그 인덱스: owl.log_index.list
11. 필드 카탈로그: owl.field_schema.get
12. 필요한 source, field, index를 얻은 후 exec_tool을 통해 owl.data.simple_query를 호출하여 조회를 실행합니다.

인시던트 트러블슈팅 관련 문제¶

"인시던트 조회, 인시던트 처리 과정 추적, 인시던트 댓글 추가" 등의 문제에 적합합니다.

1. exec_tool을 통해 owl.incident.list를 호출하여 인시던트 티켓을 조회합니다.
2. 인시던트 티켓의 incident_uuid를 사용하여 exec_tool을 통해 다음을 호출합니다:
3. owl.incident_comment.list로 댓글 확인
4. owl.incident_operation.list로 작업 기록 확인
5. 처리 정보를 추가해야 하는 경우 exec_tool을 통해 owl.incident_comment.add를 호출합니다.

리소스 객체 위치 확인 관련 문제¶

"호스트, 컨테이너, 프로세스 등 인프라스트럭처 객체 상세 정보 조회" 문제에 적합합니다.

1. exec_tool을 통해 owl.infrastructure.list를 호출하여 대상 객체를 찾습니다.
2. 반환 결과의 식별 정보를 사용하여 exec_tool을 통해 owl.infrastructure.get을 호출하여 객체 상세 정보를 가져옵니다.

워크스페이스 간 트레이스 조회 관련 문제¶

"trace_id로 동일 조직 내 여러 워크스페이스에 걸친 트레이스 조회" 문제에 적합합니다.

1. exec_tool을 통해 owl.account.workspace.same_org.list를 호출하여 동일 조직의 후보 워크스페이스를 검색합니다.
2. 반환 결과에서 workspace_uuid를 가져옵니다. (workspace_id를 가져오지 마십시오.)
3. exec_tool을 통해 owl.data.same_org.trace.query를 호출하고 필수 trace_id를 전달하며, 선택한 workspace_uuid를 workspace_uuids로 전달합니다. 생략하거나 빈 배열을 전달하면 현재 워크스페이스만 조회합니다.
4. 추가 필터가 필요한 경우 외부 중괄호가 없는 where_clause를 사용하고 trace_id 조건을 중복 추가하지 마십시오. 워크스페이스 간 트레이스 조회는 owl.data.simple_query로 대체하지 마십시오.

노트 관리 관련 문제¶

"노트 검색, 읽기, 생성, 수정 또는 삭제" 등 문제에 적합합니다.

1. exec_tool을 통해 owl.nbook_note.list를 호출하여 노트를 검색하고 note_uuid를 얻습니다.
2. Markdown 본문을 읽어야 하는 경우 owl.nbook_note.get을 호출합니다.
3. 노트 생성 시 owl.nbook_note.add를 호출하고, 업데이트 시 owl.nbook_note.modify를 호출합니다.
4. 삭제 시 owl.nbook_note.delete를 호출합니다. add, modify, delete는 쓰기 도구이므로 실행 전에 클라이언트에서 수동 확인을 수행해야 합니다.

모니터 관리 관련 문제¶

"모니터 조회, 모니터 생성 또는 업데이트, 외부 이벤트 전송" 등 문제에 적합합니다.

1. exec_tool을 통해 owl.monitor.list를 호출하여 모니터를 조회합니다.
2. 반환 결과의 rule_uuid를 사용하여 exec_tool을 통해 owl.monitor.get을 호출하여 모니터 상세 정보를 확인합니다.
3. 모니터를 생성하거나 업데이트해야 하는 경우 exec_tool을 통해 owl.monitor.upsert를 호출합니다.
4. 외부 이벤트를 전송해야 하는 경우 exec_tool을 통해 owl.monitor.receive를 호출합니다.