Skip to main content

​
Atlassian MCP Server 템플릿

경로: Console → Agent Ops → Tool Management → + 도구 생성 → Quick Setup 에서 Atlassian (Jira + Confluence) 선택 Jira issue management + Confluence page search and management (43 tools) Jira 이슈 관리와 Confluence 페이지 조회·작성을 하나의 MCP 로 묶어 제공합니다. 43 개의 도구 로 네 가지 서비스 템플릿 중 가장 풍부한 기능을 가집니다.

​
사전 주입 값 (Basic Information)

​
Run Settings

​
사용자 지정 Args

템플릿은 아래 두 개의 Argument 자리표시자를 제공합니다. Argument value 필드에 실제 URL 을 입력해야 합니다. Add Argument 로 추가 인자를 확장할 수 있습니다.

​
Environment Variables

​
템플릿 기본 제공 (전부 System Default)

Slack 과 달리 Atlassian 템플릿은 사전 정의 변수가 모두 System Default 타입입니다. 값은 운영자가 Environment 에 세팅 한 값이 런타임에 자동 주입되며, 사용자는 이 화면에서 값을 입력할 수 없습니다.
각 Value 필드: This value is fixed and automatically used at runtime
일반적으로 한 계정(이메일) 의 토큰이 Jira·Confluence 모두에 적용되므로 두 서비스의 USERNAME 은 동일 값을 가리킵니다.

​
추가 환경변수 (Add Environment Variable)

사전 정의 변수 아래 Add Environment Variable 버튼으로 필요한 변수를 추가할 수 있습니다. 이때 User Input 또는 System Default 타입을 선택 가능합니다. 추가를 고려할 변수
운영자가 System Default 의 토큰·이메일을 세팅하지 않은 상태면 도구가 호출 시점에 인증 실패로 조용히 멈춥니다. 도구 등록 전 Environment 설정 에서 값을 먼저 확인하세요.
Slack(User Input) 과 Atlassian(System Default) 의 차이
  • Slack 은 팀마다 자기 워크스페이스 토큰을 쓰므로 User Input
  • Atlassian 은 대부분 조직 단위 단일 사이트·단일 서비스 계정으로 통합 운영하므로 System Default
  • 팀별로 다른 사이트를 써야 하면 커스텀 도구(custom-create.md) 로 User Input 환경변수 기반으로 재구성

​
43 개 노출 도구 (카테고리별)

실제 호출 가능한 MCP 도구들 — 도구 상세 의 Test 결과로 전체 목록 확인 가능.

​
외부 참고 문서

Atlassian 측 토큰·권한 설정은 Atlassian 공식 문서가 최신입니다. 본 템플릿을 쓰기 전에 참고하세요.
본 Seahorse 템플릿은 mcp-atlassian 을 uvx 로 실행합니다. 43 개 도구 구성·인자 스펙이 업스트림 변경에 따라 달라질 수 있으니, 문제가 생기면 위 MCP 서버 저장소를 먼저 확인하세요.

​
API 토큰 발급

1

Atlassian 계정 로그인

id.atlassian.com 접속.
2

Create API token

Create API token → 토큰 이름 입력 (예: seahorse-mcp) → Create → 토큰 복사.
3

운영자에게 전달

발급된 토큰과 계정 이메일을 운영자에게 전달 → 운영자가 Environment 의 JIRA_API_TOKEN · CONFLUENCE_API_TOKEN 에 설정.
4

도구 생성

Quick Setup → Atlassian → --jira-url / --confluence-url 입력 → Save.
5

Test 로 연결 검증

도구 상세 → Test 로 Jira 접근 가능 프로젝트·Confluence 스페이스 응답 확인.

​
활용 예

​
보안 주의

  • 토큰 최소 권한 — API Token 은 발급 계정의 권한을 상속합니다. 관리자 계정으로 토큰을 발급하지 말고, 필요한 프로젝트/스페이스에만 접근 가능한 별도 계정을 사용하세요.
  • JQL/CQL 검색 범위 — 검색 쿼리로 과도한 결과를 가져오면 토큰 비용·API Rate Limit 이슈 발생. System Prompt 에 project = ABC 같은 제약을 추가.
  • 자동 수정·삭제 주의 — editJiraIssue / transitionJiraIssue / updateConfluencePage 는 운영 이슈·페이지를 바꿀 수 있습니다. Team Control 의 Autonomy 를 Approve 로 시작.
  • 퇴사자 토큰 회수 — Atlassian 관리 콘솔에서 토큰 revoke + Environment 갱신.

​
Transport 필드에 관하여

Basic Information 의 Transport 드롭다운에서 Standard I/O 외에 Streamable HTTP 를 선택하는 것이 UI 상으로는 가능합니다. HTTP 선택 시 입력 필드는 다음과 같이 바뀝니다:
본 템플릿의 기본 Transport 는 Standard I/O 입니다. 업스트림 MCP 서버(@modelcontextprotocol/server-slack · @modelcontextprotocol/server-github · uvx mcp-atlassian · rdb_server.py) 는 모두 로컬 프로세스(stdio) 기반 으로 설계되어 있습니다.UI 에서 Streamable HTTP 로 전환할 수는 있지만, 그 경우 같은 기능을 HTTP 엔드포인트로 감싸서 별도 호스팅한 서버가 이미 준비되어 있어야 합니다 (공식 지원되는 HTTP 버전이 Seahorse 에 번들된 것은 아닙니다).
  • 일반 사용자는 기본 Standard I/O 를 그대로 유지 하세요.
  • HTTP 엔드포인트를 자체 운영 중이고 그걸 연결하려는 경우라면, 사실상 커스텀 도구 로 처음부터 등록하는 편이 깔끔합니다.
  • HTTP 로 전환한 상태에서는 본 템플릿의 사전 주입 Command/Args/Env 가 더 이상 의미를 갖지 않습니다.

​
관련 문서