> ## 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. > Quick Setup 서비스 템플릿 — GitHub · Atlassian · PostgreSQL · Slack 4 종 원클릭 MCP 서버 등록 # Templates # 서비스 템플릿 **경로**: Console → **Agent Ops → Tool Management** → **+ 도구 생성** → **Quick Setup** 자주 쓰는 MCP 서버 4 종을 **토큰·자격 증명만 입력하면 즉시 사용 가능** 한 형태로 제공합니다. Transport·Command·Args 같은 기술 설정은 사전 주입되므로 처음 사용자도 1 분 내 등록할 수 있습니다. Image `Select a service template to auto-fill the configuration. You only need to provide your credentials.` ## 제공 템플릿 4 종 | 템플릿 | 도구 수 | 설명 | 사전 제공 변수 타입 | | -------------------------------------------------------------------------------------- | ---- | ---------------------------------------------------------------- | ----------------------------------------------- | | [**GitHub**](/console/agent-ops/agent-tool/templates/github) | 26 | `Commit history, file content, code search, PR/issue management` | `GITHUB_PERSONAL_ACCESS_TOKEN` (System Default) | | [**Atlassian (Jira + Confluence)**](/console/agent-ops/agent-tool/templates/atlassian) | 43 | `Jira issue management + Confluence page search and management` | Jira/Confluence 자격 증명 4 종 (System Default) | | [**PostgreSQL (RDB)**](/console/agent-ops/agent-tool/templates/postgresql) | 가변 | `RDB MCP Server for PostgreSQL database query and management` | DB 접속 정보 7 종 (System Default) | | [**Slack**](/console/agent-ops/agent-tool/templates/slack) | 6 | `Channels, messages, threads, reactions, users management` | `SLACK_BOT_TOKEN`, `SLACK_TEAM_ID` (User Input) | ## 자격 증명 타입 차이 템플릿마다 환경변수를 채우는 방식이 다릅니다. | 타입 | 의미 | 이 템플릿 | | ------------------ | ----------------------------------------------------------------------------------------- | ---------------------- | | **User Input** | 사용자가 도구 생성 화면에서 **직접 입력** | GitHub · Slack | | **System Default** | 운영자가 [Environment](/internal/system-admin/settings/environment) 에 미리 설정한 값이 **런타임 자동 주입** | PostgreSQL · Atlassian | **System Default 타입 템플릿**(PostgreSQL · Atlassian) 은 운영자가 Environment 값을 채우지 않으면 도구가 침묵 실패합니다. 도구 생성 전 [Environment 설정](/internal/system-admin/settings/environment) 에서 값 확인. 사용자는 이 화면에서 변경할 수 없으니 운영자에게 요청. ## 공통 동작 흐름 **+ 도구 생성** → 상단 `Quick Setup` 카드 중 선택. Name · Transport · 설명이 자동 채워집니다. **Access** (Private/Public) 만 필요에 따라 변경. Command / Args 는 기본값 사용. 고급 설정(추가 인자·디버그 플래그) 은 **Add Argument** 로 확장 가능. * **User Input** 필드는 자격 증명 직접 입력 * **System Default** 필드는 `This value is fixed and automatically used at runtime` — 입력 불필요 **Save** 후 [도구 상세](/console/agent-ops/agent-tool/tool-detail) 의 **Test** 로 연결 검증. 정상 시 도구 목록(`list_tools`) 이 자동 채워짐. [Agent 수정 → Tools 탭](/console/agent-ops/agent/agent-update) 에서 새 도구 체크 후 Save. ## 템플릿 선택 가이드 | 하고 싶은 일 | 권장 템플릿 | | ------------------------ | -------------------------------------------------------------------------- | | 코드 리뷰·PR 요약·릴리스 노트 | [GitHub](/console/agent-ops/agent-tool/templates/github) | | 이슈 트리아지·Confluence 지식 정리 | [Atlassian](/console/agent-ops/agent-tool/templates/atlassian) | | DB 기반 정기 리포트·대시보드 | [PostgreSQL](/console/agent-ops/agent-tool/templates/postgresql) | | 사내 봇·알림·양방향 Q\&A | [Slack](/console/agent-ops/agent-tool/templates/slack) | | 위 네 가지에 해당 안 됨 | [커스텀 도구 생성](/console/agent-ops/agent-tool/custom-create) — 외부 MCP 서버 직접 등록 | ## 활용 레시피 템플릿을 조합한 실제 자동화 패턴: * [PostgreSQL 반복 쿼리 자동화](/agent-chat/recipes/postgres-sql-automation) * [GitHub PR 리뷰 요약](/agent-chat/recipes/github-pr-review) * [Slack 으로 문서 받아보기](/agent-chat/recipes/slack-document-delivery) (주기 폴링 / Socket Mode) * [Slack 알림 자동화](/agent-chat/recipes/slack-notification) * [보고서 자동 발행](/agent-chat/recipes/scheduled-report) (PostgreSQL + Slack + Word/PPTX) ## 보안·운영 공통 주의 * **Access 기본 Private** — Public 으로 바꾸기 전에 같은 테넌트의 어떤 에이전트가 쓸지 검토. * **자격 증명은 환경변수로만 전달** — 도구 호출 인자에 토큰 직접 금지 (감사 로그 노출 위험). * **토큰 만료·퇴사자 회수** — 주기적 점검. GitHub PAT 는 만료일 필수, Slack/Atlassian 토큰도 정기 갱신. * **Write 권한 분리** — 자동 머지·DB DELETE 같은 파괴적 동작은 별도 도구·별도 계정으로 나누어 관리. ## MCP 공급사 변경에 따른 영향 — 사전 설정이 가장 중요합니다 **도구가 정상 동작하느냐 안 하느냐의 대부분은 "Seahorse 등록 전 외부 서비스 쪽 사전 설정" 에서 결정됩니다.** Seahorse 의 템플릿은 접속·인증에 필요한 값을 받아 전달할 뿐, 공급사 측 권한·App·토큰을 생성해주지 않습니다. 사전 설정이 누락되면 도구는 등록되더라도 **호출 시 조용히 실패** 합니다. **템플릿별 사전 설정 체크리스트** * **GitHub** — PAT 발급 + 저장소 접근 권한 + 최소 Scope → [GitHub 템플릿](/console/agent-ops/agent-tool/templates/github) * **Atlassian** — Jira/Confluence API Token + 프로젝트·스페이스 접근 권한 + 사이트 URL 확정 → [Atlassian 템플릿](/console/agent-ops/agent-tool/templates/atlassian) * **PostgreSQL** — DB 인스턴스 구축 (AWS RDS / GCP Cloud SQL 등) + 읽기 전용 계정 발급 + 네트워크 접근 허용 → [PostgreSQL 템플릿](/console/agent-ops/agent-tool/templates/postgresql) * **Slack** — Slack App 생성 + Bot Token Scopes + Install to Workspace + 채널 초대 → [Slack 템플릿](/console/agent-ops/agent-tool/templates/slack) **공통 원칙** * **사전에 공급사 측 담당자(DBA·인프라·보안)와 협의** 해 권한·접근·네트워크를 확정하고 값을 준비하세요. * **최소 권한 원칙** — 꼭 필요한 Scope·권한만 부여. `admin.*` / 쓰기 계정은 사고의 주요 원인. * 사전 설정 결과(토큰·URL·DB 계정) 는 **운영자에게 전달** 해 [Environment](/internal/system-admin/settings/environment) 에 안전하게 세팅. * 등록 직후 반드시 [도구 상세](/console/agent-ops/agent-tool/tool-detail) 의 **Test** 로 핸드셰이크 검증. **MCP 연결에 필요한 설정 항목·자격 증명·권한 체계는 외부 서비스 정책에 따라 언제든 달라질 수 있습니다.** 공급사 API 변경·MCP 서버 업스트림 업데이트·환경별 차이·인증 방식 전환 등이 원인이 됩니다. **변동이 생기는 주요 경로** * **공급사의 업데이트·정책 변경** — Slack·GitHub·Atlassian 등은 자체 API 정책을 수시로 변경합니다. Scope 이름이 바뀌거나 (`channels:read` → `channels:read.v2` 같은 식), 신규 필수 권한이 추가되거나, 특정 권한이 deprecated 될 수 있습니다. * **MCP 서버 업스트림 변경** — `@modelcontextprotocol/server-*` 패키지가 도구 스펙·인자 이름·동작을 업데이트하면 기존 자동화가 실패할 수 있습니다. * **환경별 차이** — 같은 서비스라도 **Enterprise Plan·Free Plan·사내 프라이빗 호스팅(GHES 등)** 마다 제공되는 API·권한·Rate Limit 이 다릅니다. * **인증 방식 전환** — Personal Access Token → OAuth App, 기본 API Token → SSO 강제 등 발급 방식 자체가 바뀌기도 합니다. **권장 운영** * 도구 등록 후 [**도구 상세**](/console/agent-ops/agent-tool/tool-detail)\*\* Test\*\* 로 주기적으로 연결 상태 확인 * 공급사의 **변경·deprecation 공지** 를 구독하거나 담당자를 지정해 모니터링 * MCP 서버 업스트림 저장소의 **Changelog** 확인 (각 템플릿 문서의 "외부 참고 문서" 섹션 참고) * 도구 호출이 갑자기 실패하면 — 자격 증명·Scope·공급사 API 변경·MCP 서버 버전 순으로 원인 점검 * 사내 프록시·방화벽·VPC 같은 **네트워크 환경 변경** 도 동작에 영향을 줄 수 있으니 인프라 담당자와 협업 ## 공식 지원 범위 **공식 지원되는 템플릿은 위 4 종(GitHub · Atlassian · PostgreSQL · Slack) 뿐** 입니다. 그 외 MCP 서버는 [커스텀 도구](/console/agent-ops/agent-tool/custom-create) 로 직접 등록할 수 있지만 Seahorse 에서 동작·호환성을 보장하지 않습니다. * 업스트림(MCP 서버 저장소) 변경·드라이버 버전·네트워크 구성에 따라 **연결 실패·타임아웃·도구 스펙 불일치** 가 발생할 수 있습니다. * 커스텀 도구 등록 후 반드시 [도구 상세](/console/agent-ops/agent-tool/tool-detail) 의 **Test** 로 핸드셰이크·`list_tools` 응답을 사전 검증하세요. * 운영 배포 전 **개발/스테이징 테넌트에서 먼저 검증** 하고, 실패 패턴(인증·타임아웃·Rate Limit) 을 미리 파악해두길 권장합니다. * 필요한 서비스가 있으면 [고객지원 창구](/shared/intro/seahorse-cloud-overview#지원--문의) 로 요청해주세요 — 수요에 따라 향후 템플릿으로 추가될 수 있습니다. **공식 템플릿과의 차이** | 항목 | 공식 템플릿 (4 종) | 커스텀 도구 | | ----------- | ------------------------------------- | ----------------- | | 동작 보장 | ✓ Seahorse 검증 | ✗ 보장 안 됨 | | 자격 증명 주입 방식 | `User Input` / `System Default` 사전 설계 | 사용자가 설계 | | 업그레이드 | Seahorse 업데이트에 맞춰 자동 | 사용자가 수동 점검 | | 지원 문의 | 정식 서포트 | 수요 기반 (템플릿 편입 요청) | Atlassian MCP Server 템플릿 — Jira 이슈 + Confluence 페이지 관리 (43 tools). uvx mcp-atlassian 기반 GitHub MCP Server 템플릿 — 커밋·파일·코드 검색·PR·이슈 관리 (26 tools). 공식 @modelcontextprotocol/server-github 원클릭 등록 PostgreSQL RDB MCP Server 템플릿 — 관리형 서버(rdb\_server.py) + System Default 환경변수. 구 RDB Endpoint 통합 Slack MCP Server 템플릿 — channels, messages, threads, reactions, users 관리 (6 tools). Bot Token + Team ID 만으로 1 분 내 등록 ## 관련 문서 * [Tool Management](/)