도구 상세
경로: Tool Management 목록에서 도구 이름 클릭 등록된 MCP 도구의 구성과 이 도구가 노출하는 메서드(MCP tools), 호출 이력, 연결된 에이전트를 한 화면에서 확인합니다.헤더
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 로 이동. 각 변수는 아래 형식으로 표시됩니다.| 요소 | 설명 |
|---|---|
| Key | 환경변수 이름 |
| Value | 실제 값 또는 (empty) (미설정) · 시크릿은 •••• 로 마스킹 |
| Badge | Fixed value (System Default — 런타임 주입) / User Input (사용자 입력 저장됨) |
값 상태 해석
| 표시 | 의미 | 대응 |
|---|---|---|
| 실제 값 | 정상 (예: 5432, prefer) | — |
(empty) + Fixed value | System Default 인데 Environment 에 값이 없음 | 운영자가 Environment 에서 세팅 필요 |
(empty) + User Input | 사용자 입력 필요한데 저장된 값이 없음 | Edit 로 이동해 입력 |
•••• | 시크릿 마스킹 | 값 확인이 필요하면 Edit 화면에서 노출 (필요 시만) |
(empty) 표시는 System Default 변수가 Environment 에 아직 등록되지 않았다 는 의미입니다. 이 상태로 도구를 호출하면 인증 실패 등으로 조용히 멈출 수 있으니, 도구 상세 에서 값 상태를 먼저 확인하세요.지원 메서드 (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 |
커스텀 도구
커스텀 도구 생성 으로 등록한 MCP 서버는 노출 메서드가 서버 구현에 따라 다릅니다. Test 클릭으로 실제 노출 목록을 확인하세요.Connected Agents (연결된 에이전트)
이 도구를 사용하도록 등록한 에이전트 목록 — 도구 삭제 전 영향 분석에 핵심.| 컬럼 | 설명 |
|---|---|
| 에이전트 이름 | 클릭 시 Agent 상세 |
| 상태 | Ready / Deploying / Failed |
| 마지막 호출 | 이 도구를 마지막으로 호출한 시각 |
호출 로그 (Recent Calls)
최근 도구 호출 이력 — 디버깅·감사용.| 컬럼 | 설명 |
|---|---|
| 시각 | 호출 시각 |
| 에이전트 | 호출한 에이전트 |
| 메서드 | 호출된 tool name |
| 상태 | Success / Failed / Timeout |
| 소요 시간 | ms |
| 에러 | 실패 시 메시지 |
Tool 호출이 자주 실패한다면 이 로그를 먼저 확인. 가장 흔한 원인:
- 자격 증명 만료 — PAT/Token 갱신 필요
- 권한 부족 — 발급된 토큰 스코프가 메서드 요구 사항을 충족하지 못함
- Rate Limit — 외부 API 호출 한도 초과
- 네트워크/엔드포인트 도달 불가 — Transport 가 http/sse 인 경우
액션
- Edit → 도구 수정 — 환경변수·접근 권한 변경 시 권장
- Delete → 도구 삭제 — 연결 에이전트 영향 확인 필수
- Test → MCP 핸드셰이크 +
list_tools자동 호출. 정상 시 지원 메서드 목록 갱신