Skip to main content
Glama
deenesjakoruzh

Backlog MCP Server

by nulab
npmGitHub
TypeScript
MIT License
53
66
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

백로그 MCP 서버

MIT 라이센스짓다마지막 커밋

📘일본어데노ご利사용가이드

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

특징

  • 프로젝트 관리(생성, 읽기, 업데이트, 삭제)
  • 이슈 추적(생성, 업데이트, 삭제, 목록)
  • 위키 페이지 관리
  • Git 저장소 관리
  • 풀 리퀘스트 관리(생성, 업데이트, 목록, 댓글)
  • 알림 관리
  • 시청 목록 관리
  • 최적화된 응답을 위한 GraphQL 스타일 필드 선택
  • 대량 응답에 대한 토큰 제한
  • 향상된 오류 처리
  • 그리고 더 많은 Backlog API 통합

요구 사항

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

설치

옵션 1: Docker를 통해 설치

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

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

지엑스피1

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

고급 구성 옵션

이는 실험적인 접근 방식이며, 컨텍스트 창 크기를 줄이는 표준적인 방법은 아닙니다. AI 에이전트에서 이 MCP를 사용하는 데 문제가 있는 경우 다음 설정을 조정해 보세요. 서버 동작을 사용자 지정하기 위해 추가 옵션을 추가할 수 있습니다.

{ "mcpServers": { "backlog": { "command": "docker", "args": [ "run", "-i", "--rm", "-e", "BACKLOG_DOMAIN", "-e", "BACKLOG_API_KEY", "-e", "MAX_TOKENS", "-e", "OPTIMIZE_RESPONSE", "ghcr.io/nulab/backlog-mcp-server" ], "env": { "BACKLOG_DOMAIN": "your-domain.backlog.com", "BACKLOG_API_KEY": "your-api-key", "MAX_TOKENS": "10000", "OPTIMIZE_RESPONSE": "true" } } } }
  • MAX_TOKENS : 응답에 허용되는 최대 토큰 수(기본값: 50000)
  • OPTIMIZE_RESPONSE : 응답 크기를 최적화하기 위해 GraphQL 스타일 필드 선택을 활성화합니다(기본값: false)

Docker 이미지를 최신 상태로 유지하기

기본적으로 Docker는 이전에 가져온 로컬 캐시 이미지를 사용합니다. ghcr.io/nulab/backlog-mcp-server 의 최신 버전을 항상 사용하려면 다음 방법 중 하나를 고려해 보세요.

옵션 1: --pull always 사용(권장)

Docker 20.10 이상을 사용하는 경우 args 배열을 수정하여 --pull always 플래그를 포함할 수 있습니다.

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

이렇게 하면 Docker가 실행되기 전에 항상 GitHub 컨테이너 레지스트리에서 최신 이미지를 가져옵니다.

옵션 2: 최신 이미지를 수동으로 가져오기

Docker 버전이 --pull always를 지원하지 않는 경우 서버를 실행하기 전에 최신 이미지를 수동으로 가져올 수 있습니다.

docker pull ghcr.io/nulab/backlog-mcp-server:latest

옵션 2: 수동 설치

  1. 저장소를 복제합니다.
    git clone https://github.com/nulab/backlog-mcp-server.git cd backlog-mcp-server
  2. 종속성 설치:
    npm install
  3. 프로젝트를 빌드하세요:
    npm run build
  4. MCP로 사용할 JSON을 설정하세요
{ "mcpServers": { "backlog": { "command": "node", "args": [ "your-repository-location/build/index.js" ], "env": { "BACKLOG_DOMAIN": "your-domain.backlog.com", "BACKLOG_API_KEY": "your-api-key" } } } }

사용 가능한 도구

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

우주 도구

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

프로젝트 도구

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

문제 도구

도구 이름설명
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

필드 선택 사용

OPTIMIZE_RESPONSE 옵션이 활성화되면 GraphQL 스타일 구문을 사용하여 검색할 필드를 지정할 수 있습니다.

Show me the details of the PROJECT-KEY project, but only include the name, key, and description fields

AI는 필드 선택을 사용하여 응답을 최적화합니다.

get_project(projectIdOrKey: "PROJECT-KEY", fields: "{ name key description }")

이렇게 하면 특히 대형 객체의 경우 응답 크기와 처리 시간이 줄어듭니다.

고급 기능

응답 최적화

필드 선택

OPTIMIZE_RESPONSE=true 로 활성화하면 GraphQL 스타일 구문을 사용하여 특정 필드를 선택할 수 있습니다.

{ id name description users { id name } }

이를 통해 다음을 수행할 수 있습니다.

  • 필요한 필드만 요청하여 응답 크기를 줄이세요.
  • 특정 데이터 포인트에 집중하세요
  • 대량 응답에 대한 성능 향상
토큰 제한

토큰 한도를 초과하지 않도록 대량의 응답은 자동으로 제한됩니다.

  • 기본 한도: 50,000개 토큰
  • MAX_TOKENS 환경 변수를 통해 구성 가능
  • 제한을 초과하는 응답은 메시지와 함께 잘립니다.

i18n / 설명 재정의

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

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

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

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

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

샘플 구성:

{ "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

새로운 도구 추가

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

명령줄 옵션

서버는 여러 가지 명령줄 옵션을 지원합니다.

  • --export-translations : 모든 번역 키와 값을 내보냅니다.
  • --optimize-response : GraphQL 스타일 필드 선택을 활성화합니다.
  • --max-tokens=NUMBER : 응답에 대한 최대 토큰 제한을 설정합니다.

예:

node build/index.js --optimize-response --max-tokens=100000

특허

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

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

Install Server
A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Tools

View all tools

클로드가 API 통합을 통해 Backlog 프로젝트 관리 도구와 상호 작용할 수 있도록 하는 모델 컨텍스트 프로토콜 서버로, 프로젝트, 이슈, 위키 페이지 및 기타 Backlog 리소스를 관리할 수 있습니다.

  1. 특징
    1. 요구 사항
      1. 설치
        1. 옵션 1: Docker를 통해 설치
        2. Docker 이미지를 최신 상태로 유지하기
        3. 옵션 2: 수동 설치
      2. 사용 가능한 도구
        1. 우주 도구
        2. 프로젝트 도구
        3. 문제 도구
        4. 댓글 도구
        5. 위키 도구
        6. 카테고리 도구
        7. 알림 도구
        8. Git 저장소 도구
        9. 풀 리퀘스트 도구
        10. 도구 보기
      3. 사용 예
        1. 프로젝트 목록
        2. 새로운 이슈 생성
        3. 프로젝트 세부 정보 가져오기
        4. Git 저장소 작업
        5. 풀 리퀘스트 관리
        6. 아이템 보기
        7. 필드 선택 사용
      4. 고급 기능
        1. 응답 최적화
        2. i18n / 설명 재정의
        3. 현재 번역 내보내기
        4. 일본어 번역 템플릿 사용
        5. 환경 변수 사용
      5. 개발
        1. 테스트 실행
        2. 새로운 도구 추가
        3. 명령줄 옵션
      6. 특허

        Related MCP Servers

        • Linear MCP Server

          cpropster
          -
          security
          A
          license
          -
          quality
          A Model Context Protocol server that allows Claude to interact with Linear's API for managing teams, issues, projects, and cycles.
          Last updated -
          21
          1
          TypeScript
          MIT License

        • ConnectWise Manage MCP Server

          ethangillani
          -
          security
          A
          license
          -
          quality
          A Model Context Protocol server that enables Claude to interact with the ConnectWise Manage API to perform operations like retrieving, creating, updating, and deleting tickets, companies, contacts, and other entities.
          Last updated -
          JavaScript
          MIT License
          • Apple

        • API Tester MCP Server

          Vikrant-Khedkar
          -
          security
          F
          license
          -
          quality
          A Model Context Protocol server that allows Claude to make API requests on your behalf, providing tools for testing various APIs including HTTP requests and OpenAI integrations without sharing your API keys in the chat.
          Last updated -
          Python
          • Linux
          • Apple

        • Backlog MCP Server

          katsuhirohonda
          -
          security
          F
          license
          -
          quality
          Integrates Backlog project management with Claude via Model Context Protocol, enabling access to projects, issues, and wiki pages through natural language interactions.
          Last updated -
          TypeScript

        View all related MCP servers

        Appeared in Searches

        New MCP Servers

        MCP directory API

        We provide all the information about MCP servers via our MCP API.

        curl -X GET 'https://glama.ai/api/mcp/v1/servers/nulab/backlog-mcp-server'

        If you have feedback or need assistance with the MCP directory API, please join our Discord server