Skip to main content

서비스 템플릿

경로: 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 종

템플릿도구 수설명사전 제공 변수 타입
GitHub26Commit history, file content, code search, PR/issue managementGITHUB_PERSONAL_ACCESS_TOKEN (System Default)
Atlassian (Jira + Confluence)43Jira issue management + Confluence page search and managementJira/Confluence 자격 증명 4 종 (System Default)
PostgreSQL (RDB)가변RDB MCP Server for PostgreSQL database query and managementDB 접속 정보 7 종 (System Default)
Slack6Channels, messages, threads, reactions, users managementSLACK_BOT_TOKEN, SLACK_TEAM_ID (User Input)

자격 증명 타입 차이

템플릿마다 환경변수를 채우는 방식이 다릅니다.
타입의미이 템플릿
User Input사용자가 도구 생성 화면에서 직접 입력GitHub · Slack
System Default운영자가 Environment 에 미리 설정한 값이 런타임 자동 주입PostgreSQL · Atlassian
System Default 타입 템플릿(PostgreSQL · Atlassian) 은 운영자가 Environment 값을 채우지 않으면 도구가 침묵 실패합니다. 도구 생성 전 Environment 설정 에서 값 확인. 사용자는 이 화면에서 변경할 수 없으니 운영자에게 요청.

공통 동작 흐름

1

Quick Setup 진입

+ 도구 생성 → 상단 Quick Setup 카드 중 선택.
2

Basic Information 확인

Name · Transport · 설명이 자동 채워집니다. Access (Private/Public) 만 필요에 따라 변경.
3

Run Settings

Command / Args 는 기본값 사용. 고급 설정(추가 인자·디버그 플래그) 은 Add Argument 로 확장 가능.
4

Environment Variables

  • User Input 필드는 자격 증명 직접 입력
  • System Default 필드는 This value is fixed and automatically used at runtime — 입력 불필요
5

Save → Test

Save도구 상세Test 로 연결 검증. 정상 시 도구 목록(list_tools) 이 자동 채워짐.
6

에이전트에 연결

Agent 수정 → Tools 탭 에서 새 도구 체크 후 Save.

템플릿 선택 가이드

하고 싶은 일권장 템플릿
코드 리뷰·PR 요약·릴리스 노트GitHub
이슈 트리아지·Confluence 지식 정리Atlassian
DB 기반 정기 리포트·대시보드PostgreSQL
사내 봇·알림·양방향 Q&ASlack
위 네 가지에 해당 안 됨커스텀 도구 생성 — 외부 MCP 서버 직접 등록

활용 레시피

템플릿을 조합한 실제 자동화 패턴:

보안·운영 공통 주의

  • Access 기본 Private — Public 으로 바꾸기 전에 같은 테넌트의 어떤 에이전트가 쓸지 검토.
  • 자격 증명은 환경변수로만 전달 — 도구 호출 인자에 토큰 직접 금지 (감사 로그 노출 위험).
  • 토큰 만료·퇴사자 회수 — 주기적 점검. GitHub PAT 는 만료일 필수, Slack/Atlassian 토큰도 정기 갱신.
  • Write 권한 분리 — 자동 머지·DB DELETE 같은 파괴적 동작은 별도 도구·별도 계정으로 나누어 관리.

MCP 공급사 변경에 따른 영향 — 사전 설정이 가장 중요합니다

도구가 정상 동작하느냐 안 하느냐의 대부분은 “Seahorse 등록 전 외부 서비스 쪽 사전 설정” 에서 결정됩니다. Seahorse 의 템플릿은 접속·인증에 필요한 값을 받아 전달할 뿐, 공급사 측 권한·App·토큰을 생성해주지 않습니다. 사전 설정이 누락되면 도구는 등록되더라도 호출 시 조용히 실패 합니다.
템플릿별 사전 설정 체크리스트
  • GitHub — PAT 발급 + 저장소 접근 권한 + 최소 Scope → GitHub 템플릿
  • Atlassian — Jira/Confluence API Token + 프로젝트·스페이스 접근 권한 + 사이트 URL 확정 → Atlassian 템플릿
  • PostgreSQL — DB 인스턴스 구축 (AWS RDS / GCP Cloud SQL 등) + 읽기 전용 계정 발급 + 네트워크 접근 허용 → PostgreSQL 템플릿
  • Slack — Slack App 생성 + Bot Token Scopes + Install to Workspace + 채널 초대 → Slack 템플릿
공통 원칙
  • 사전에 공급사 측 담당자(DBA·인프라·보안)와 협의 해 권한·접근·네트워크를 확정하고 값을 준비하세요.
  • 최소 권한 원칙 — 꼭 필요한 Scope·권한만 부여. admin.* / 쓰기 계정은 사고의 주요 원인.
  • 사전 설정 결과(토큰·URL·DB 계정) 는 운영자에게 전달Environment 에 안전하게 세팅.
  • 등록 직후 반드시 도구 상세Test 로 핸드셰이크 검증.
MCP 연결에 필요한 설정 항목·자격 증명·권한 체계는 외부 서비스 정책에 따라 언제든 달라질 수 있습니다. 공급사 API 변경·MCP 서버 업스트림 업데이트·환경별 차이·인증 방식 전환 등이 원인이 됩니다.
변동이 생기는 주요 경로
  • 공급사의 업데이트·정책 변경 — Slack·GitHub·Atlassian 등은 자체 API 정책을 수시로 변경합니다. Scope 이름이 바뀌거나 (channels:readchannels:read.v2 같은 식), 신규 필수 권한이 추가되거나, 특정 권한이 deprecated 될 수 있습니다.
  • MCP 서버 업스트림 변경@modelcontextprotocol/server-* 패키지가 도구 스펙·인자 이름·동작을 업데이트하면 기존 자동화가 실패할 수 있습니다.
  • 환경별 차이 — 같은 서비스라도 Enterprise Plan·Free Plan·사내 프라이빗 호스팅(GHES 등) 마다 제공되는 API·권한·Rate Limit 이 다릅니다.
  • 인증 방식 전환 — Personal Access Token → OAuth App, 기본 API Token → SSO 강제 등 발급 방식 자체가 바뀌기도 합니다.
권장 운영
  • 도구 등록 후 도구 상세** Test** 로 주기적으로 연결 상태 확인
  • 공급사의 변경·deprecation 공지 를 구독하거나 담당자를 지정해 모니터링
  • MCP 서버 업스트림 저장소의 Changelog 확인 (각 템플릿 문서의 “외부 참고 문서” 섹션 참고)
  • 도구 호출이 갑자기 실패하면 — 자격 증명·Scope·공급사 API 변경·MCP 서버 버전 순으로 원인 점검
  • 사내 프록시·방화벽·VPC 같은 네트워크 환경 변경 도 동작에 영향을 줄 수 있으니 인프라 담당자와 협업

공식 지원 범위

공식 지원되는 템플릿은 위 4 종(GitHub · Atlassian · PostgreSQL · Slack) 뿐 입니다. 그 외 MCP 서버는 커스텀 도구 로 직접 등록할 수 있지만 Seahorse 에서 동작·호환성을 보장하지 않습니다.
  • 업스트림(MCP 서버 저장소) 변경·드라이버 버전·네트워크 구성에 따라 연결 실패·타임아웃·도구 스펙 불일치 가 발생할 수 있습니다.
  • 커스텀 도구 등록 후 반드시 도구 상세Test 로 핸드셰이크·list_tools 응답을 사전 검증하세요.
  • 운영 배포 전 개발/스테이징 테넌트에서 먼저 검증 하고, 실패 패턴(인증·타임아웃·Rate Limit) 을 미리 파악해두길 권장합니다.
  • 필요한 서비스가 있으면 고객지원 창구 로 요청해주세요 — 수요에 따라 향후 템플릿으로 추가될 수 있습니다.
공식 템플릿과의 차이
항목공식 템플릿 (4 종)커스텀 도구
동작 보장✓ Seahorse 검증✗ 보장 안 됨
자격 증명 주입 방식User Input / System Default 사전 설계사용자가 설계
업그레이드Seahorse 업데이트에 맞춰 자동사용자가 수동 점검
지원 문의정식 서포트수요 기반 (템플릿 편입 요청)

Atlassian MCP Server 템플릿

Atlassian MCP Server 템플릿 — Jira 이슈 + Confluence 페이지 관리 (43 tools). uvx mcp-atlassian 기반

GitHub MCP Server 템플릿

GitHub MCP Server 템플릿 — 커밋·파일·코드 검색·PR·이슈 관리 (26 tools). 공식 @modelcontextprotocol/server-github 원클릭 등록

PostgreSQL RDB MCP Server 템플릿

PostgreSQL RDB MCP Server 템플릿 — 관리형 서버(rdb_server.py) + System Default 환경변수. 구 RDB Endpoint 통합

Slack MCP Server 템플릿

Slack MCP Server 템플릿 — channels, messages, threads, reactions, users 관리 (6 tools). Bot Token + Team ID 만으로 1 분 내 등록

관련 문서