> ## 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.

> Seahorse 에이전트용 외부 도구(MCP) 등록·관리

# Agent tool

# Tool Management

**경로**: Console → **Agent Ops** → **Tool Management**

Seahorse 에이전트가 사용할 **외부 도구(MCP 서버)** 를 등록·관리합니다. 한 번 등록한 도구는 여러 에이전트에 재사용할 수 있고, 에이전트는 LLM 의 **Tool Call** 능력으로 적절한 시점에 자동 호출합니다.

<Info>
  이전 **RDB Endpoint** 는 별도 메뉴가 아닌 **PostgreSQL 템플릿** 으로 통합되었습니다. [PostgreSQL 템플릿](/console/agent-ops/agent-tool/templates/postgresql) 참고.
</Info>

## MCP 가 뭐예요?

**Model Context Protocol** — Anthropic 이 표준화한 LLM ↔ 외부 도구 통신 규약입니다. MCP 서버를 등록하면 어떤 LLM (Claude·GPT·Qwen 등) 이든 **표준 인터페이스로 같은 도구를 호출** 할 수 있어, 모델 교체 시에도 도구 코드를 다시 만들 필요가 없습니다.

## 도구 유형

| 유형                    | 예시                                      | 설명                                      |
| --------------------- | --------------------------------------- | --------------------------------------- |
| **Service Templates** | GitHub / Atlassian / PostgreSQL / Slack | 원클릭 등록용 사전 정의 MCP 템플릿 — 토큰만 입력하면 즉시 사용  |
| **Custom Tool**       | 사내 개발 MCP 서버                            | stdio/http/sse 직접 설정. 환경변수·인자·접근 권한 커스텀 |

## 빠른 시작

<Steps>
  <Step title="도구 선택 — 템플릿 우선">
    [서비스 템플릿](/console/agent-ops/agent-tool/templates) 에 원하는 도구가 있으면 **무조건 템플릿 사용** — 검증된 환경변수·tool 목록이 미리 채워져 있어 1 분 내 등록.
  </Step>

  <Step title="자격 증명 발급">
    각 서비스의 토큰을 발급. 권한은 **꼭 필요한 범위로 최소화**.

    * GitHub: PAT (repo · read 권장)
    * Slack: Bot Token (xoxb-) + App Token (xapp-)
    * PostgreSQL: 읽기 전용 DB 사용자 권장
    * Atlassian: API Token + 사이트 URL
  </Step>

  <Step title="Tool 등록">
    목록 페이지의 **+ 도구 생성** → 템플릿 선택 → 자격 증명 입력 → 저장. 자세한 단계: [도구 생성](/console/agent-ops/agent-tool/tool-create).
  </Step>

  <Step title="에이전트에 연결">
    [Agent 수정](/console/agent-ops/agent/agent-update) → **Tools 탭** 에서 등록된 도구 체크 → Save. 채팅 시 LLM 이 필요한 시점에 자동 호출.
  </Step>

  <Step title="동작 검증">
    Agent Chat 에서 도구를 명시적으로 시도 (예: `"Slack #general 채널에 'hi' 보내봐"`). 채팅 툴바의 **MCP Tools** 패널에서 해당 도구가 녹색(connected) 인지 확인.
  </Step>
</Steps>

## 서비스 템플릿 한눈에

| 템플릿                                                              | 주요 용도                             | 인증                    |
| ---------------------------------------------------------------- | --------------------------------- | --------------------- |
| [GitHub](/console/agent-ops/agent-tool/templates/github)         | 커밋·PR·이슈·코드 검색 (26 tools)         | PAT                   |
| [Atlassian](/console/agent-ops/agent-tool/templates/atlassian)   | Jira 이슈 · Confluence 페이지          | API Token + 사이트 URL   |
| [PostgreSQL](/console/agent-ops/agent-tool/templates/postgresql) | SQL 쿼리·스키마 조회 (구 RDB Endpoint 통합) | DB 사용자                |
| [Slack](/console/agent-ops/agent-tool/templates/slack)           | 채널 메시지 전송·검색                      | Bot Token + App Token |

## 보안·운영 주의

<Warning>
  * **최소 권한 원칙** — 토큰은 꼭 필요한 스코프만. PR 자동 머지·DB DELETE 등 위험 동작은 별도 도구·계정으로 분리.
  * **공개 vs 비공개** — Tool 의 접근 권한을 `Public` 으로 두면 같은 테넌트 내 모든 에이전트가 사용 가능. 민감한 자격 증명을 가진 도구는 **Private** 로 제한.
  * **자격 증명 갱신** — Slack/GitHub 토큰 만료 시 도구가 조용히 실패합니다. 만료일 기록 + 정기 갱신.
  * **퇴사자·계약 종료** 시 발급된 PAT/Bot Token 회수.
  * **로깅** — Tool 호출 인자가 감사 로그에 남을 수 있으므로, 자격 증명은 인자가 아닌 **환경변수** 로 전달.
  * **호출량·비용** — Tool 호출이 잦은 자동화(Slack 폭주·반복 SQL)는 토큰 비용으로 이어집니다. 호출 횟수 한도·요금은 [Billing](/billing) 참고.
</Warning>

<Info>
  **도구를 에이전트에 적용한 자동화 레시피**

  * [GitHub PR 리뷰 요약](/agent-chat/recipes/github-pr-review)
  * [PostgreSQL 반복 쿼리 자동화](/agent-chat/recipes/postgres-sql-automation)
  * [Slack 으로 문서 받아보기](/agent-chat/recipes/slack-document-delivery)
  * [Slack 알림 자동화](/agent-chat/recipes/slack-notification)
</Info>

## 페이지

<CardGroup cols={2}>
  <Card title="커스텀 도구 생성" href="/console/agent-ops/agent-tool/custom-create">
    커스텀 도구 생성 — Standard I/O (stdio) / Streamable HTTP 두 가지 Transport 지원. 자체 MCP 서버·서드파티 도구 등록
  </Card>

  <Card title="도구 생성" href="/console/agent-ops/agent-tool/tool-create">
    템플릿 선택 또는 커스텀 설정으로 새 도구 등록
  </Card>

  <Card title="도구 삭제" href="/console/agent-ops/agent-tool/tool-delete">
    도구 삭제 — 연결된 모든 에이전트의 해당 도구 호출이 즉시 실패. 삭제 전 영향 범위 확인 필수
  </Card>

  <Card title="도구 상세" href="/console/agent-ops/agent-tool/tool-detail">
    도구 상세 — 등록된 MCP 도구의 구성, 지원 메서드(tools) 목록, 환경 변수, 호출 로그, 연결 에이전트 확인
  </Card>

  <Card title="도구 목록" href="/console/agent-ops/agent-tool/tool-list">
    도구 목록 — 등록된 MCP 서버를 Name·Transport·Access·Required Fields·Created At 컬럼으로 조회
  </Card>

  <Card title="도구 수정" href="/console/agent-ops/agent-tool/tool-update">
    도구 수정 — 기존 도구의 Name·Access·Args·환경변수 등 변경. Transport 는 변경 불가
  </Card>

  <Card title="서비스 템플릿" href="/console/agent-ops/agent-tool/templates">
    Quick Setup 서비스 템플릿 — GitHub · Atlassian · PostgreSQL · Slack 4 종 원클릭 MCP 서버 등록
  </Card>
</CardGroup>

## 관련 문서

* [Agent Ops Menu Group](/)
* [Agent 기능](/console/agent-ops/agent)
* [Agent Rules 기능](/console/agent-ops/agent-rules)
* [System Prompts 기능](/console/agent-ops/system-prompts)