> ## Documentation Index
> Fetch the complete documentation index at: https://manual.seahorse.dnotitia.ai/llms.txt
> Use this file to discover all available pages before exploring further.

> 도구 상세 — 등록된 MCP 도구의 구성, 지원 메서드(tools) 목록, 환경 변수, 호출 로그, 연결 에이전트 확인

# Tool detail

# 도구 상세

**경로**: Tool Management 목록에서 도구 이름 클릭

등록된 MCP 도구의 구성과 **이 도구가 노출하는 메서드(MCP tools)**, 호출 이력, 연결된 에이전트를 한 화면에서 확인합니다.

## 헤더

| 요소                     | 설명                                                          |
| ---------------------- | ----------------------------------------------------------- |
| **도구 이름**              | 식별자 (예: `postgresql`)                                       |
| **Edit** (우측 상단)       | 수정 진입 → [도구 수정](/console/agent-ops/agent-tool/tool-update)  |
| **Delete** (우측 상단, 빨강) | [도구 삭제](/console/agent-ops/agent-tool/tool-delete) 확인 다이얼로그 |

## Basic Information

Basic Information 섹션은 도구의 핵심 메타를 **읽기 전용** 으로 표시합니다.

| 항목              | 설명                       | 예시                                     |
| --------------- | ------------------------ | -------------------------------------- |
| **Name**        | 도구 이름                    | `postgresql`                           |
| **Tool UUID**   | 내부 고유 식별자                | `5c69fd5b-9343-49d0-b843-6112c6c687b3` |
| **Transport**   | stdio / streamable\_http | `stdio`                                |
| **Access**      | `Private` / `Public`     | `Private`                              |
| **Description** | 용도 메모                    | `PostgreSQL RDB MCP Server`            |
| **Created At**  | 생성 시각                    | `2026. 04. 22. 오후 05:39`               |
| **Updated At**  | 마지막 수정 시각                | `2026. 04. 22. 오후 05:39`               |

## Run / Connection Settings

Transport 에 따라 표시되는 필드가 다릅니다.

### Standard I/O (stdio) 의 경우

| 항목            | 설명              | 예시                                          |
| ------------- | --------------- | ------------------------------------------- |
| **Command**   | 실행 명령           | `python`                                    |
| **Arguments** | 명령 인자 목록 (순서대로) | `-u` / `/app/app/mcp_servers/rdb_server.py` |

### Streamable HTTP 의 경우

| 항목               | 설명           | 예시                               |
| ---------------- | ------------ | -------------------------------- |
| **Endpoint URL** | HTTP 스트리밍 주소 | `https://example.com/api/stream` |
| **Timeout**      | 타임아웃 (초)     | `30`                             |
| **Verify SSL**   | SSL 검증 여부    | `true`                           |
| **Headers**      | 요청 헤더 목록     | `Authorization: Bearer ...`      |

## Environment Variables (읽기 전용)

상세 화면에서는 환경변수를 **조회만** 합니다. 편집하려면 헤더 우측 상단의 **Edit** 로 이동.

각 변수는 아래 형식으로 표시됩니다.

```
PG_HOST:       (empty)     [Fixed value]
PG_PORT:        5432        [Fixed value]
PG_SSLMODE:     prefer      [Fixed value]
SLACK_BOT_TOKEN: ••••       [User Input]
```

| 요소        | 설명                                                                  |
| --------- | ------------------------------------------------------------------- |
| **Key**   | 환경변수 이름                                                             |
| **Value** | 실제 값 또는 `(empty)` (미설정) · 시크릿은 `••••` 로 마스킹                         |
| **Badge** | `Fixed value` (System Default — 런타임 주입) / `User Input` (사용자 입력 저장됨) |

### 값 상태 해석

| 표시                        | 의미                                        | 대응                                                                       |
| ------------------------- | ----------------------------------------- | ------------------------------------------------------------------------ |
| 실제 값                      | 정상 (예: `5432`, `prefer`)                  | —                                                                        |
| `(empty)` + `Fixed value` | System Default 인데 **Environment 에 값이 없음** | 운영자가 [Environment](/internal/system-admin/settings/environment) 에서 세팅 필요 |
| `(empty)` + `User Input`  | 사용자 입력 필요한데 저장된 값이 없음                     | **Edit** 로 이동해 입력                                                        |
| `••••`                    | 시크릿 마스킹                                   | 값 확인이 필요하면 Edit 화면에서 노출 (필요 시만)                                          |

<Info>
  `(empty)` 표시는 **System Default 변수가 Environment 에 아직 등록되지 않았다** 는 의미입니다. 이 상태로 도구를 호출하면 인증 실패 등으로 조용히 멈출 수 있으니, [도구 상세](#) 에서 값 상태를 먼저 확인하세요.
</Info>

## 지원 메서드 (Tools)

이 MCP 서버가 노출하는 **호출 가능한 메서드 목록**. **Test** 또는 `list_tools` 자동 호출로 채워집니다.

| 컬럼                | 설명                                |
| ----------------- | --------------------------------- |
| **Tool Name**     | 메서드 식별자 (예: `list_pull_requests`) |
| **Description**   | 메서드 용도                            |
| **Input Schema**  | JSON Schema (펼쳐 보기)               |
| **Required Args** | 필수 인자                             |

### 템플릿 도구별 대표 메서드

| 템플릿                   | 카테고리       | 대표 Tools                                                                                                                       |
| --------------------- | ---------- | ------------------------------------------------------------------------------------------------------------------------------ |
| **GitHub** (26 tools) | PR         | `list_pull_requests`, `get_pull_request`, `get_pull_request_diff`, `add_pr_comment`                                            |
|                       | 이슈         | `list_issues`, `create_issue`, `add_issue_comment`, `update_issue`                                                             |
|                       | 커밋·코드      | `list_commits`, `get_commit`, `search_code`, `get_file_contents`                                                               |
|                       | 릴리스·CI     | `list_releases`, `create_release`, `list_workflow_runs`, `get_workflow_run`                                                    |
| **Atlassian**         | Jira       | `getJiraIssue`, `createJiraIssue`, `editJiraIssue`, `transitionJiraIssue`, `addCommentToJiraIssue`, `searchJiraIssuesUsingJql` |
|                       | Confluence | `getConfluencePage`, `createConfluencePage`, `updateConfluencePage`, `searchConfluenceUsingCql`, `getPagesInConfluenceSpace`   |
| **PostgreSQL**        | 메타         | `list_tables`, `get_table_schema`, `list_databases`                                                                            |
|                       | 쿼리         | `execute_query`, `execute_select` (읽기 전용 권장)                                                                                   |
|                       | 통계         | `analyze_table`, `get_query_plan`                                                                                              |
| **Slack**             | 메시지        | `slack_send_message`, `slack_schedule_message`, `slack_send_message_draft`                                                     |
|                       | 읽기         | `slack_read_channel`, `slack_read_thread`, `slack_read_user_profile`                                                           |
|                       | 검색         | `slack_search_public`, `slack_search_users`, `slack_search_channels`                                                           |
|                       | Canvas     | `slack_create_canvas`, `slack_read_canvas`, `slack_update_canvas`                                                              |

자세한 인자·예시는 각 템플릿 문서 참고:

* [GitHub 템플릿](/console/agent-ops/agent-tool/templates/github)
* [Atlassian 템플릿](/console/agent-ops/agent-tool/templates/atlassian)
* [PostgreSQL 템플릿](/console/agent-ops/agent-tool/templates/postgresql)
* [Slack 템플릿](/console/agent-ops/agent-tool/templates/slack)

### 커스텀 도구

[커스텀 도구 생성](/console/agent-ops/agent-tool/custom-create) 으로 등록한 MCP 서버는 노출 메서드가 서버 구현에 따라 다릅니다. **Test** 클릭으로 실제 노출 목록을 확인하세요.

## Connected Agents (연결된 에이전트)

이 도구를 사용하도록 등록한 에이전트 목록 — [도구 삭제](/console/agent-ops/agent-tool/tool-delete) 전 영향 분석에 핵심.

| 컬럼          | 설명                                                     |
| ----------- | ------------------------------------------------------ |
| **에이전트 이름** | 클릭 시 [Agent 상세](/console/agent-ops/agent/agent-detail) |
| **상태**      | `Ready` / `Deploying` / `Failed`                       |
| **마지막 호출**  | 이 도구를 마지막으로 호출한 시각                                     |

## 호출 로그 (Recent Calls)

최근 도구 호출 이력 — 디버깅·감사용.

| 컬럼        | 설명                               |
| --------- | -------------------------------- |
| **시각**    | 호출 시각                            |
| **에이전트**  | 호출한 에이전트                         |
| **메서드**   | 호출된 tool name                    |
| **상태**    | `Success` / `Failed` / `Timeout` |
| **소요 시간** | ms                               |
| **에러**    | 실패 시 메시지                         |

<Info>
  **Tool 호출이 자주 실패한다면** 이 로그를 먼저 확인. 가장 흔한 원인:

  * **자격 증명 만료** — PAT/Token 갱신 필요
  * **권한 부족** — 발급된 토큰 스코프가 메서드 요구 사항을 충족하지 못함
  * **Rate Limit** — 외부 API 호출 한도 초과
  * **네트워크/엔드포인트 도달 불가** — Transport 가 http/sse 인 경우
</Info>

## 액션

* **Edit** → [도구 수정](/console/agent-ops/agent-tool/tool-update) — 환경변수·접근 권한 변경 시 권장
* **Delete** → [도구 삭제](/console/agent-ops/agent-tool/tool-delete) — 연결 에이전트 영향 확인 필수
* **Test** → MCP 핸드셰이크 + `list_tools` 자동 호출. 정상 시 지원 메서드 목록 갱신

## 관련 문서

* [도구 생성](/console/agent-ops/agent-tool/tool-create)
* [도구 수정](/console/agent-ops/agent-tool/tool-update)
* [도구 삭제](/console/agent-ops/agent-tool/tool-delete)
* [서비스 템플릿](/console/agent-ops/agent-tool/templates)
* [Tool Management 개요](/console/agent-ops/agent-tool)