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

Backlog APIとやり取りするためのModel Context Protocol(MCP)サーバーです。このサーバーは、Claude DesktopやCline、CursorなどのAIエージェントを通じて、プロジェクト、課題、WikiページなどをBacklogで管理するためのツールを提供します。

特徴

• プロジェクトツール(作成、読み取り、更新、削除)
• 問題追跡とコメント(作成、更新、削除、リスト)
• バージョン/マイルストーン管理(作成、読み取り、更新、削除)
• ウィキページのサポート
• Gitリポジトリおよびプルリクエストツール
• 通知ツール
• 最適化された応答のためのフィールド選択
• 大きな応答に対するトークン制限

始めて

要件

• Docker
• APIアクセス可能なバックログアカウント
• バックログアカウントからのAPIキー

オプション1:Docker経由でインストール

このMCPサーバーを最も簡単に利用する方法は、以下のMCP構成を通じてです:

1. MCP設定を開く
2. MCP設定セクションへ移動します
3. 以下の構成を追加する:

your-domain.backlog.comをバックログドメインに、your-api-keyをバックログAPIキーに置き換えます。

✅ --pull aleversが使えない場合は、以下を使って手動で画像を更新できます:

オプション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: