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

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

# Atlassian

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

| 필드            | 값                                                                  |
| ------------- | ------------------------------------------------------------------ |
| **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` |

**Add Argument** 로 추가 인자를 확장할 수 있습니다.

## Environment Variables

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

Slack 과 달리 Atlassian 템플릿은 **사전 정의 변수가 모두 System Default** 타입입니다. 값은 **운영자가 [Environment](/internal/system-admin/settings/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   |

일반적으로 한 계정(이메일) 의 토큰이 Jira·Confluence 모두에 적용되므로 두 서비스의 USERNAME 은 동일 값을 가리킵니다.

### 추가 환경변수 (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 | 사내 프록시 경유 시 운영자가 전역 설정                                            |

<Warning>
  운영자가 System Default 의 토큰·이메일을 세팅하지 않은 상태면 도구가 호출 시점에 **인증 실패로 조용히 멈춥니다**. 도구 등록 전 [Environment 설정](/internal/system-admin/settings/environment) 에서 값을 먼저 확인하세요.
</Warning>

<Info>
  **Slack(User Input) 과 Atlassian(System Default) 의 차이**

  * Slack 은 팀마다 자기 워크스페이스 토큰을 쓰므로 User Input
  * Atlassian 은 대부분 조직 단위 단일 사이트·단일 서비스 계정으로 통합 운영하므로 System Default
  * 팀별로 다른 사이트를 써야 하면 **커스텀 도구**([custom-create.md](/console/agent-ops/agent-tool/custom-create)) 로 User Input 환경변수 기반으로 재구성
</Info>

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

실제 호출 가능한 MCP 도구들 — [도구 상세](/console/agent-ops/agent-tool/tool-detail) 의 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 공식 문서가 최신입니다. 본 템플릿을 쓰기 전에 참고하세요.

| 주제                            | 링크                                                                                                                     |
| ----------------------------- | ---------------------------------------------------------------------------------------------------------------------- |
| **Atlassian 계정 API 토큰 관리**    | [id.atlassian.com — API tokens](https://id.atlassian.com/manage-profile/security/api-tokens)                           |
| **Jira Cloud REST API**       | [developer.atlassian.com/cloud/jira/platform/rest](https://developer.atlassian.com/cloud/jira/platform/rest/v3/intro/) |
| **JQL (Jira 쿼리 언어)**          | [support.atlassian.com/jira — JQL](https://support.atlassian.com/jira-service-management-cloud/docs/jql-fields/)       |
| **Confluence Cloud REST API** | [developer.atlassian.com/cloud/confluence](https://developer.atlassian.com/cloud/confluence/rest/v2/intro/)            |
| **CQL (Confluence 검색)**       | [developer.atlassian.com — CQL](https://developer.atlassian.com/cloud/confluence/advanced-searching-using-cql/)        |
| **Atlassian MCP 서버 소스**       | [github.com/sooperset/mcp-atlassian](https://github.com/sooperset/mcp-atlassian)                                       |

<Info>
  본 Seahorse 템플릿은 `mcp-atlassian` 을 `uvx` 로 실행합니다. **43 개 도구 구성·인자 스펙이 업스트림 변경에 따라 달라질 수 있으니**, 문제가 생기면 위 MCP 서버 저장소를 먼저 확인하세요.
</Info>

## API 토큰 발급

<Steps>
  <Step title="Atlassian 계정 로그인">
    [id.atlassian.com](https://id.atlassian.com/manage-profile/security/api-tokens) 접속.
  </Step>

  <Step title="Create API token">
    **Create API token** → 토큰 이름 입력 (예: `seahorse-mcp`) → **Create** → 토큰 복사.
  </Step>

  <Step title="운영자에게 전달">
    발급된 토큰과 계정 이메일을 **운영자에게 전달** → 운영자가 [Environment](/internal/system-admin/settings/environment) 의 `JIRA_API_TOKEN` · `CONFLUENCE_API_TOKEN` 에 설정.
  </Step>

  <Step title="도구 생성">
    Quick Setup → **Atlassian** → `--jira-url` / `--confluence-url` 입력 → Save.
  </Step>

  <Step title="Test 로 연결 검증">
    [도구 상세](/console/agent-ops/agent-tool/tool-detail) → **Test** 로 Jira 접근 가능 프로젝트·Confluence 스페이스 응답 확인.
  </Step>
</Steps>

## 활용 예

| 시나리오                    | 구성                                                                                                     |
| ----------------------- | ------------------------------------------------------------------------------------------------------ |
| **이슈 자동 트리아지**          | Slack 이슈 멘션 → LLM 분류 → `createJiraIssue` + 라벨·담당자 자동 지정                                                |
| **주간 이슈 리포트**           | `searchJiraIssuesUsingJql` → LLM 요약 → Confluence 페이지 `updateConfluencePage`                            |
| **Confluence 지식 자동 정리** | 스페이스 크롤 → LLM 요약 → 새 Index 페이지 생성                                                                      |
| **PR → Jira 자동 연계**     | [GitHub](/console/agent-ops/agent-tool/templates/github) + Atlassian 조합 — PR 제목에서 이슈 키 추출 → Transition |
| **Confluence RAG**      | 사내 위키 페이지 인덱싱 → 채팅에서 검색·인용                                                                             |

## 보안 주의

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

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

<Warning>
  **본 템플릿의 기본 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 엔드포인트를 자체 운영 중이고 그걸 연결하려는 경우라면, 사실상 [커스텀 도구](/console/agent-ops/agent-tool/custom-create#streamable-http-방식) 로 처음부터 등록하는 편이 깔끔합니다.
  * HTTP 로 전환한 상태에서는 본 템플릿의 사전 주입 Command/Args/Env 가 더 이상 의미를 갖지 않습니다.
</Warning>

## 관련 문서

* [Quick Setup 템플릿 목록](/console/agent-ops/agent-tool/templates)
* [도구 상세](/console/agent-ops/agent-tool/tool-detail)
* [GitHub 템플릿](/console/agent-ops/agent-tool/templates/github) — 코드 + 이슈 조합
* [Environment (운영자)](/internal/system-admin/settings/environment)