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 개의 도구 로 네 가지 서비스 템플릿 중 가장 풍부한 기능을 가집니다.
| 필드 | 값 |
|---|
| Name | atlassian |
| Transport | Standard I/O (stdio) |
| 설명 | Atlassian MCP Server — Jira issues + Confluence pages (43 tools) |
| Access | 기본 Private |
Run Settings
| 항목 | 값 |
|---|
| Command | uvx |
| Args | mcp-atlassian |
사용자 지정 Args
템플릿은 아래 두 개의 Argument 자리표시자를 제공합니다. Argument value 필드에 실제 URL 을 입력해야 합니다.
| Argument | 설명 | 예시 |
|---|
--jira-url | Jira 사이트 URL | https://dnotitia.atlassian.net |
--confluence-url | Confluence 사이트 URL | https://dnotitia.atlassian.net/wiki |
Environment Variables
템플릿 기본 제공 (전부 System Default)
Slack 과 달리 Atlassian 템플릿은 사전 정의 변수가 모두 System Default 타입입니다. 값은 운영자가 Environment 에 세팅 한 값이 런타임에 자동 주입되며, 사용자는 이 화면에서 값을 입력할 수 없습니다.
각 Value 필드: This value is fixed and automatically used at runtime
| Key | 설명 |
|---|
| JIRA_USERNAME | Jira login email |
| JIRA_API_TOKEN | Jira API token |
| CONFLUENCE_USERNAME | Confluence login email |
| CONFLUENCE_API_TOKEN | Confluence API token |
추가 환경변수 (Add Environment Variable)
사전 정의 변수 아래 Add Environment Variable 버튼으로 필요한 변수를 추가할 수 있습니다. 이때 User Input 또는 System Default 타입을 선택 가능합니다.
| 타입 | 이 화면에서 값 입력? | 용도 |
|---|
| User Input | ✓ 직접 입력 | 도구 단위 설정 (테넌트별 사이트·프로젝트 제한 등) |
| System Default | ✗ 입력 불가 — 운영자가 Environment 에 세팅한 값이 주입 | 공통 프록시·네트워크 설정 등 |
| 변수 | 타입 권장 | 설명 |
|---|
READ_ONLY | User Input | true 로 두면 수정성 도구(editJiraIssue 등) 비활성화 |
ENABLED_TOOLS | User Input | 화이트리스트 방식으로 사용 도구 제한 (예: getJiraIssue,searchJiraIssuesUsingJql) |
HTTP_PROXY / HTTPS_PROXY | 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 결과로 전체 목록 확인 가능.
| 카테고리 | 주요 도구 |
|---|
| Jira 이슈 | getJiraIssue · createJiraIssue · editJiraIssue · transitionJiraIssue · addCommentToJiraIssue · addWorklogToJiraIssue · lookupJiraAccountId |
| Jira 검색·메타 | searchJiraIssuesUsingJql · getJiraIssueTypeMetaWithFields · getJiraProjectIssueTypesMetadata · getTransitionsForJiraIssue · getVisibleJiraProjects · getIssueLinkTypes · createIssueLink · getJiraIssueRemoteIssueLinks |
| Confluence 페이지 | getConfluencePage · createConfluencePage · updateConfluencePage · getConfluencePageDescendants · getPagesInConfluenceSpace · getConfluenceSpaces |
| Confluence 코멘트 | createConfluenceFooterComment · createConfluenceInlineComment · getConfluencePageFooterComments · getConfluencePageInlineComments · getConfluenceCommentChildren |
| 검색·공통 | searchConfluenceUsingCql · search · fetch · getAccessibleAtlassianResources · atlassianUserInfo |
외부 참고 문서
Atlassian 측 토큰·권한 설정은 Atlassian 공식 문서가 최신입니다. 본 템플릿을 쓰기 전에 참고하세요.
본 Seahorse 템플릿은 mcp-atlassian 을 uvx 로 실행합니다. 43 개 도구 구성·인자 스펙이 업스트림 변경에 따라 달라질 수 있으니, 문제가 생기면 위 MCP 서버 저장소를 먼저 확인하세요.
API 토큰 발급
Create API token
Create API token → 토큰 이름 입력 (예: seahorse-mcp) → Create → 토큰 복사.
운영자에게 전달
발급된 토큰과 계정 이메일을 운영자에게 전달 → 운영자가 Environment 의 JIRA_API_TOKEN · CONFLUENCE_API_TOKEN 에 설정. 도구 생성
Quick Setup → Atlassian → --jira-url / --confluence-url 입력 → Save.
Test 로 연결 검증
도구 상세 → Test 로 Jira 접근 가능 프로젝트·Confluence 스페이스 응답 확인. 활용 예
| 시나리오 | 구성 |
|---|
| 이슈 자동 트리아지 | Slack 이슈 멘션 → LLM 분류 → createJiraIssue + 라벨·담당자 자동 지정 |
| 주간 이슈 리포트 | searchJiraIssuesUsingJql → LLM 요약 → Confluence 페이지 updateConfluencePage |
| Confluence 지식 자동 정리 | 스페이스 크롤 → LLM 요약 → 새 Index 페이지 생성 |
| PR → Jira 자동 연계 | GitHub + Atlassian 조합 — PR 제목에서 이슈 키 추출 → Transition |
| Confluence RAG | 사내 위키 페이지 인덱싱 → 채팅에서 검색·인용 |
보안 주의
- 토큰 최소 권한 — 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 선택 시 입력 필드는 다음과 같이 바뀝니다:
| stdio 필드 | → | HTTP 필드 |
|---|
| Command + Args + Environment Variables | → | Connection Settings (Endpoint URL · Timeout · Verify SSL) + Headers |
본 템플릿의 기본 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 가 더 이상 의미를 갖지 않습니다.
관련 문서
