Atlassian MCP

Atlassian Cloud에서 AI 에이전트가 Jira 및 Confluence와 상호 작용할 수 있게 해주는 맞춤형 Model Context Protocol 서버입니다. 백그라운드에서 Jira REST API v3 및 Confluence REST API v2를 사용하여 일반 REST 호출을 수행합니다.

설정

1. 의존성을 설치하고 빌드합니다:

   npm install
   npm run build

2. 서버를 전역 명령으로 노출하여 모든 워크스페이스에서 실행할 수 있게 합니다 (package.json의 bin 항목 사용):

   npm link

   이렇게 하면 atlassian-mcp 명령이 PATH에 추가됩니다. 코드 변경 후 npm run build를 다시 실행하세요. 연결된 명령은 항상 현재 dist를 가리킵니다.

3. https://id.atlassian.com/manage-profile/security/api-tokens에서 API 토큰을 생성합니다.

4. 환경 변수를 통해 자격 증명을 제공합니다 (.env.example 참조):

   변수	설명
   ATLASSIAN_SITE_URL	사용자 사이트, 예: https://your-domain.atlassian.net
   ATLASSIAN_EMAIL	사용자의 Atlassian 계정 이메일
   ATLASSIAN_API_TOKEN	위에서 생성한 API 토큰

Related MCP server: jira-mcp

클라이언트 연결

VS Code (권장)

이 저장소는 표준 .vscode/mcp.json을 제공합니다. 로그인 + 대화형 zsh(zsh -lic)를 통해 서버를 실행하므로 ~/.zshrc(또는 ~/.zshenv)에 내보낸 Atlassian 자격 증명을 상속받습니다. 구성에 비밀이 포함되지 않으며, 전역으로 연결된 atlassian-mcp 명령을 호출하므로 어떤 저장소가 열려 있든 작동합니다:

{
  "servers": {
    "atlassian": {
      "type": "stdio",
      "command": "zsh",
      "args": ["-lic", "exec atlassian-mcp"]
    }
  }
}

여기서 ${workspaceFolder}는 피하세요. 현재 열려 있는 저장소로 확인되므로 서버를 다른 워크스페이스에서 사용하면 깨질 수 있습니다. 대신 npm link 명령 이름은 셸 PATH에서 확인됩니다.

서버를 모든 워크스페이스에서 사용할 수 있게 하려면 동일한 servers 블록을 사용자 수준 MCP 구성에 추가하세요 (명령 팔레트 → MCP: Open User Configuration).

대안: node를 절대 경로로 실행

npm link를 사용하지 않으려면 node를 절대 경로를 사용하여 빌드된 진입 파일을 직접 가리키게 하세요 (${workspaceFolder}는 워크스페이스마다 달라지므로 사용하지 마세요). VS Code의 ${userHome} 변수를 사용하면 여러 머신에서 이식 가능합니다:

{
  "servers": {
    "atlassian": {
      "type": "stdio",
      "command": "zsh",
      "args": ["-lic", "exec node \"${userHome}/Sites/atlassian-mcp/dist/index.js\""]
    }
  }
}

저장소를 다른 위치에 클론한 경우 경로를 조정하세요. zsh -lic 래퍼는 여전히 셸 프로필에서 자격 증명을 제공합니다.

구성 파일 대신 셸 프로필에서 변수를 내보내세요:

export ATLASSIAN_SITE_URL="https://your-domain.atlassian.net"
export ATLASSIAN_EMAIL="you@example.com"
export ATLASSIAN_API_TOKEN="your-api-token"

셸 프로필을 변경한 후 VS Code 창을 다시 로드하면 새 값이 적용됩니다.

기타 클라이언트 (Claude Desktop, Cline, Cursor)

셸을 통해 실행되지 않는 클라이언트는 동일한 zsh -lic 래퍼를 사용하거나 변수를 명시적으로 설정할 수 있습니다:

{
  "mcpServers": {
    "atlassian": {
      "command": "atlassian-mcp",
      "env": {
        "ATLASSIAN_SITE_URL": "https://your-domain.atlassian.net",
        "ATLASSIAN_EMAIL": "you@example.com",
        "ATLASSIAN_API_TOKEN": "your-api-token"
      }
    }
  }
}

npm link를 사용하지 않는 경우 node에 빌드된 진입 파일의 절대 경로를 지정하세요:

{
  "mcpServers": {
    "atlassian": {
      "command": "node",
      "args": ["/absolute/path/to/atlassian-mcp/dist/index.js"],
      "env": {
        "ATLASSIAN_SITE_URL": "https://your-domain.atlassian.net",
        "ATLASSIAN_EMAIL": "you@example.com",
        "ATLASSIAN_API_TOKEN": "your-api-token"
      }
    }
  }
}

로컬 개발 시 npm run dev로 서버를 직접 실행할 수 있습니다.

도구

Jira

Confluence

참고 사항

• Jira 리치 텍스트 필드(설명, 댓글)는 일반 텍스트를 허용하며, 자동으로 Atlassian Document Format(ADF)으로 변환됩니다.

• Confluence 페이지/댓글 본문은 스토리지 형식(XHTML)을 사용합니다(예: <p>Hi</p>).

• API 토큰은 계정의 모든 권한을 상속받습니다. 비밀로 유지하고 절대 커밋하지 마세요.