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

一个用于与 Backlog API 交互的模型上下文协议（MCP）服务器。该服务器通过 AI 代理如 Claude Desktop / Cline / Cursor 等，提供管理项目、问题、维基页面等 Backlog 的工具。

特色

• 项目工具（创建、读取、更新、删除）
• 问题跟踪和评论（创建、更新、删除、列表）
• 版本/里程碑管理（创建、读取、更新、删除）
• 维基页面支持
• Git 仓库和拉取请求工具
• 通知工具
• 场选择以优化响应
• 对大型响应的令牌限制

开始

要求

• Docker
• 一个带有API访问权限的待办列表账户
• 来自你的待办列表账户的API密钥

选项1：通过Docker安装

使用该MCP服务器最简单的方式是通过以下配置：

1. 打开MCP设置
2. 导航到MCP配置部分
3. 添加以下构型：

将your-domain.backlog.com替换为你的Backlog域名，your-api-key替换为Backlog 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: