📘 日本語でのご利用ガイド

백로그 API와 상호작용하기 위한 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 서버는 Claude Desktop / Cline / Cursor 등 AI 에이전트를 통해 백로그 내 프로젝트, 이슈, 위키 페이지 등 다양한 데이터를 관리할 수 있는 도구를 제공합니다.

특징

• 프로젝트 도구 (생성, 읽기, 업데이트, 삭제)
• 이슈 추적 및 댓글(생성, 업데이트, 삭제, 목록)
• 버전/마일스톤 관리 (생성, 읽기, 업데이트, 삭제)
• 위키 페이지 지원
• Git 저장소 및 풀 요청 도구
• 알림 도구
• 최적화된 응답을 위한 필드 선택
• 대규모 응답에 대한 토큰 제한

시작하기

요구 사항

• 도커
• API 접근 권한이 있는 백로그 계정
• 백로그 계정의 API 키

옵션 1: 도커를 통해 설치

이 MCP 서버를 사용하는 가장 쉬운 방법은 다음 MCP 구성을 통해서입니다:

1. MCP 설정 열기
2. MCP 구성 섹션으로 이동하세요
3. 다음 구성을 추가한다:

your-domain.backlog.com를 백로그 도메인으로, your-api-key를 백로그 API 키로 바꿉니다.

✅ --pull을 항상 사용할 수 없다면, 다음 방법으로 이미지를 수동으로 업데이트할 수 있습니다:

옵션 2: npx로 설치

Backlog MCP Server

📘 日本語でのご利用ガイド

A Model Context Protocol (MCP) server for interacting with the Backlog API. This server provides tools for managing projects, issues, wiki pages, and more in Backlog through AI agents like Claude Desktop / Cline / Cursor etc.

Features

• Project tools (create, read, update, delete)
• Issue tracking and comments (create, update, delete, list)
• Version/Milestone management (create, read, update, delete)
• Wiki page support
• Git repository and pull request tools
• Notification tools
• Field selection for optimized responses
• Token limiting for large responses

Getting Started

Requirements

• Docker
• A Backlog account with API access
• API key from your Backlog account

Option 1: Install via Docker

The easiest way to use this MCP server is through MCP configurations:

1. Open MCP settings
2. Navigate to the MCP configuration section
3. Add the following configuration:

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

Replace your-domain.backlog.com with your Backlog domain and your-api-key with your Backlog API key.

✅ If you cannot use --pull always, you can manually update the image using:

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

Option 2: Install via npx

You can also run the server directly using npx without cloning the repository. This is a convenient way to run the server without a full installation.

1. Open MCP settings
2. Navigate to the MCP configuration section
3. Add the following configuration:

{
  "mcpServers": {
    "backlog": {
      "command": "npx",
      "args": ["backlog-mcp-server"],
      "env": {
        "BACKLOG_DOMAIN": "your-domain.backlog.com",
        "BACKLOG_API_KEY": "your-api-key"
      }
    }
  }
}

Replace your-domain.backlog.com with your Backlog domain and your-api-key with your Backlog API key.

Option 3: Manual Setup (Node.js)

1. Clone and install:

   git clone https://github.com/nulab/backlog-mcp-server.git
   cd backlog-mcp-server
   pnpm install
   pnpm run build
   

2. Create .env from template and set required variables:

cp .env.example .env

Set the following values in .env: