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

Сервер Model Context Protocol (MCP) для взаимодействия с API Backlog. Этот сервер предоставляет инструменты для управления проектами, проблемами, страницами в вики и другим в Backlog через AI-агенты, такие как Claude Desktop / Cline / Cursor и др.

Особенности

• Инструменты проекта (создание, чтение, обновление, удаление)
• Отслеживание проблем и комментариев (создание, обновление, удаление, список)
• Управление версиями/этапами (создание, чтение, обновление, удаление)
• Поддержка страниц Википедии
• Репозиторий Git и инструменты для pull-запросов
• Инструменты уведомлений
• Выбор полей для оптимизированных ответов
• Ограничение токенов для больших ответов

Начало

Требования

• Docker
• Аккаунт Backlog с доступом API
• API-ключ из вашего аккаунта Backlog

Вариант 1: Установка через Docker

Самый простой способ использовать этот MCP-сервер — использовать конфигурации 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: