백로그 MCP 서버

Backlog API와 상호 작용하는 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 서버는 Claude Desktop/Cline/Cursor 등의 AI 에이전트를 통해 Backlog의 프로젝트, 이슈, 위키 페이지 등을 관리하는 도구를 제공합니다.

특징

프로젝트 관리(생성, 읽기, 업데이트, 삭제)
이슈 추적(생성, 업데이트, 삭제, 목록)
위키 페이지 관리
Git 저장소 관리
풀 리퀘스트 관리(생성, 업데이트, 목록, 댓글)
알림 관리
시청 목록 관리
그리고 더 많은 Backlog API 통합

요구 사항

도커
API 액세스가 가능한 Backlog 계정
Backlog 계정의 API 키

설치

옵션 1: Docker를 통해 설치

이 MCP 서버를 사용하는 가장 쉬운 방법은 Claude Desktop 또는 Cline에 대한 MCP 구성을 이용하는 것입니다.

Claude Desktop 또는 Cline 설정 열기
MCP 구성 섹션으로 이동합니다.
다음 구성을 추가합니다.

지엑스피1

your-domain.backlog.com Backlog 도메인으로 바꾸고 your-api-key Backlog API 키로 바꾸세요.

옵션 2: 수동 설치

저장소를 복제합니다.
git clone https://github.com/nulab/backlog-mcp-server.git cd backlog-mcp-server
종속성 설치:
npm install
프로젝트를 빌드하세요:
npm run build
MCP로 사용할 JSON을 설정하세요

{
  "mcpServers": {
    "backlog": {
      "command": "node",
      "args": [
        "your-repojitory-location/build/index.js"
      ],
      "env": {
        "BACKLOG_DOMAIN": "your-domain.backlog.com",
        "BACKLOG_API_KEY": "your-api-key"
      }
    }
  }
}

사용 가능한 도구

서버는 Backlog와 상호 작용하기 위해 다음과 같은 도구를 제공합니다.

우주 도구

도구 이름	설명
`get_space`	Backlog 공간에 대한 정보를 반환합니다.
`get_users`	Backlog 공간의 사용자 목록을 반환합니다.
`get_myself`	인증된 사용자에 대한 정보를 반환합니다.
`get_priorities`	우선순위 목록을 반환합니다
`get_resolutions`	문제 해결 목록 반환
`get_issue_types`	프로젝트의 이슈 유형 목록을 반환합니다.

프로젝트 도구

도구 이름	설명
`get_project_list`	프로젝트 목록을 반환합니다
`add_project`	새 프로젝트를 만듭니다
`get_project`	특정 프로젝트에 대한 정보를 반환합니다.
`update_project`	기존 프로젝트를 업데이트합니다
`delete_project`	프로젝트를 삭제합니다

문제 도구

도구 이름	설명
`get_issue`	특정 문제에 대한 정보를 반환합니다.
`get_issues`	문제 목록을 반환합니다.
`count_issues`	문제 수를 반환합니다.
`add_issue`	지정된 프로젝트에서 새로운 이슈를 생성합니다.
`update_issue`	기존 문제를 업데이트합니다
`delete_issue`	문제를 삭제합니다

댓글 도구

도구 이름	설명
`get_issue_comments`	문제에 대한 의견 목록을 반환합니다.
`add_issue_comment`	문제에 대한 의견을 추가합니다

위키 도구

도구 이름	설명
`get_wiki_pages`	위키 페이지 목록을 반환합니다
`get_wikis_count`	프로젝트의 위키 페이지 수를 반환합니다.
`get_wiki`	특정 위키 페이지에 대한 정보를 반환합니다.
`add_wiki`	새로운 위키 페이지를 만듭니다

카테고리 도구

도구 이름	설명
`get_categories`	프로젝트의 카테고리 목록을 반환합니다.

알림 도구

도구 이름	설명
`get_notifications`	알림 목록을 반환합니다.
`count_notifications`	알림 개수를 반환합니다.
`reset_unread_notification_count`	읽지 않은 알림 수 재설정
`mark_notification_as_read`	알림을 읽음으로 표시

Git 저장소 도구

도구 이름	설명
`get_git_repositories`	프로젝트의 Git 저장소 목록을 반환합니다.
`get_git_repository`	특정 Git 저장소에 대한 정보를 반환합니다.

풀 리퀘스트 도구

도구 이름	설명
`get_pull_requests`	저장소에 대한 풀 리퀘스트 목록을 반환합니다.
`get_pull_requests_count`	저장소에 대한 풀 요청 수를 반환합니다.
`get_pull_request`	특정 풀 리퀘스트에 대한 정보를 반환합니다.
`add_pull_request`	새로운 풀 리퀘스트를 생성합니다
`update_pull_request`	기존 풀 리퀘스트를 업데이트합니다.
`get_pull_request_comments`	풀 리퀘스트에 대한 댓글 목록을 반환합니다.
`add_pull_request_comment`	풀 리퀘스트에 주석을 추가합니다.
`update_pull_request_comment`	풀 리퀘스트에 대한 코멘트를 업데이트합니다.

도구 보기

도구 이름	설명
`get_watching_list_items`	사용자의 감시 항목 목록을 반환합니다.
`get_watching_list_count`	사용자의 시청 항목 수를 반환합니다.

사용 예

AI 에이전트에서 MCP 서버를 구성하면 대화에서 해당 도구를 직접 사용할 수 있습니다. 몇 가지 예를 들면 다음과 같습니다.

프로젝트 목록

Could you list all my Backlog projects?

새로운 이슈 생성

Create a new bug issue in the PROJECT-KEY project with high priority titled "Fix login page error"

프로젝트 세부 정보 가져오기

Show me the details of the PROJECT-KEY project

Git 저장소 작업

List all Git repositories in the PROJECT-KEY project

풀 리퀘스트 관리

Show me all open pull requests in the repository "repo-name" of PROJECT-KEY project

Create a new pull request from branch "feature/new-feature" to "main" in the repository "repo-name" of PROJECT-KEY project

아이템 보기

Show me all items I'm watching 

i18n / 설명 재정의

홈 디렉토리 에 .backlog-mcp-serverrc.json 파일을 만들어 도구 설명을 재정의할 수 있습니다.

해당 파일에는 도구 이름을 키로, 새 설명을 값으로 갖는 JSON 객체가 포함되어야 합니다.
예를 들어:

{
  "TOOL_ADD_ISSUE_COMMENT_DESCRIPTION": "An alternative description",
  "TOOL_CREATE_PROJECT_DESCRIPTION": "Create a new project in Backlog"
}

서버가 시작되면 다음 우선순위에 따라 각 도구에 대한 최종 설명을 결정합니다.

환경 변수(예: BACKLOG_MCP_TOOL_ADD_ISSUE_COMMENT_DESCRIPTION )
.backlog-mcp-serverrc.json 의 항목 - 지원되는 구성 파일 형식: .json, .yaml, .yml
내장된 대체 값(영어)

샘플 구성:

{
  "mcpServers": {
    "backlog": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e", "BACKLOG_DOMAIN",
        "-e", "BACKLOG_API_KEY",
        "-v", "/yourcurrentdir/.backlog-mcp-serverrc.json:/root/.backlog-mcp-serverrc.json:ro",
        "ghcr.io/nulab/backlog-mcp-server"
      ],
      "env": {
        "BACKLOG_DOMAIN": "your-domain.backlog.com",
        "BACKLOG_API_KEY": "your-api-key"
      }
    }
  }
}

현재 번역 내보내기

--export-translations 플래그로 바이너리를 실행하면 현재 기본 번역(모든 재정의 포함)을 내보낼 수 있습니다.

이렇게 하면 사용자 정의한 내용을 포함하여 모든 도구 설명이 stdout으로 인쇄됩니다.

예:

docker run -i --rm ghcr.io/nulab/backlog-mcp-server node build/index.js --export-translations

또는

npx github:nulab/backlog-mcp-server --export-translations

일본어 번역 템플릿 사용

샘플 일본어 구성 파일은 다음에서 제공됩니다.

translationConfig/.backlog-mcp-serverrc.json.example

사용하려면 .backlog-mcp-serverrc.json 형식으로 홈 디렉토리에 복사하세요.

그런 다음 필요에 따라 설명을 사용자 정의하기 위해 파일을 편집할 수 있습니다.

환경 변수 사용

혹은 환경 변수를 통해 도구 설명을 재정의할 수 있습니다.

환경 변수 이름은 도구 키를 기반으로 하며, BACKLOG_MCP_로 시작해서 대문자로 작성됩니다.

예: TOOL_ADD_ISSUE_COMMENT_DESCRIPTION을 재정의하려면 다음을 수행합니다.

{
  "mcpServers": {
    "backlog": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e", "BACKLOG_DOMAIN",
        "-e", "BACKLOG_API_KEY",
        "-e", "BACKLOG_MCP_TOOL_ADD_ISSUE_COMMENT_DESCRIPTION"
        "ghcr.io/nulab/backlog-mcp-server"
      ],
      "env": {
        "BACKLOG_DOMAIN": "your-domain.backlog.com",
        "BACKLOG_API_KEY": "your-api-key",
        "BACKLOG_MCP_TOOL_ADD_ISSUE_COMMENT_DESCRIPTION": "An alternative description"
      }
    }
  }
}

서버는 시작 시에 동기적으로 구성 파일을 로드합니다.

환경 변수는 항상 구성 파일보다 우선합니다.

개발

테스트 실행

npm test

새로운 도구 추가

기존 도구 패턴을 따라 src/tools/ 에 새 파일을 만듭니다.
해당 테스트 파일을 만듭니다.
src/tools/tools.ts 에 새 도구를 추가합니다.
변경 사항을 빌드하고 테스트하세요

특허

이 프로젝트는 MIT 라이선스 에 따라 라이선스가 부여되었습니다.

참고 사항: 이 도구는 MIT 라이선스에 따라 어떠한 보증이나 공식 지원 없이 제공됩니다.
내용을 검토하고 귀하의 필요에 적합한지 확인한 후, 귀하의 책임 하에 사용하시기 바랍니다.
문제가 발생하면 GitHub Issues를 통해 보고해 주세요.

Backlog MCP Server

Integrations