About Backlog MCP Server
Backlog MCP Server makes Backlog issue operations available to MCP clients, for teams that need to find or maintain project issues through prompts. It supports searching, retrieving, and updating issues.
Key features
- 01Search Backlog issues
- 02Retrieve issue details
- 03Update issues
Use cases
- 01Find in-progress issues in a project
- 02Review the details of an issue
- 03Change an issue status or add a comment
MCP support
The MCP server exposes Backlog API capabilities for searching, retrieving, and updating issues to MCP clients.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
Tools
Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.
Details
From the project READMEBacklog MCP Server
BacklogのAPIに接続するMCPサーバーです。課題の検索、取得、更新機能を提供します。
機能
- 課題の検索
- 課題の取得
- 課題の更新
セットアップ
MCPの設定
~/Library/Application Support/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/cline_mcp_settings.jsonに以下を追加:
{
"mcpServers": {
"backlog": {
"command": "node",
"args": ["build/index.js"],
"cwd": "/path/to/backlog-mcp-server"
}
}
}
注意:cwdは実際のプロジェクトパスに置き換えてください。
Docker環境
開発環境
開発やテスト用にDockerコンテナを使用する場合:
# .envファイルを作成
cp .env.example .env
# 必要な環境変数を設定
BACKLOG_SPACE_URL=https://your-space.backlog.com
BACKLOG_API_KEY=your_api_key
# 開発モードでビルドと起動
NODE_ENV=development docker compose up -d --build
開発モードでは、ソースコードの変更を監視し、自動的に再起動します。
本番環境
本番環境用にDockerコンテナを使用する場合:
# .envファイルを作成
cp .env.example .env
# 必要な環境変数を設定
BACKLOG_SPACE_URL=https://your-space.backlog.com
BACKLOG_API_KEY=your_api_key
# 本番モードでビルドと起動
docker compose up -d --build
MCPサーバーとしての使用
Dockerコンテナを使用してMCPサーバーとして実行するには、利用するアプリの設定ファイルに以下のように設定します
Cline、RooClineの例:
cline_mcp_settings.json
{
"mcpServers": {
"backlog": {
"command": "docker",
"args": ["exec", "-i", "backlog-mcp-server", "node", "build/index.js"],
"env": {
"BACKLOG_SPACE_URL": "https://your-space.backlog.com",
"BACKLOG_API_KEY": "your_api_key"
}
}
}
}
その他のアプリ設定方法
Claude Desktop:https://ainow.jp/claude-mcp-guide/
Windsurf:https://zenn.dev/y16ra/articles/3ed3e2ae734fa4
Cursor:https://note.com/shuzon__/n/na2aafacf7324 →[Notion MCP Server を Cursor に設定]
プロンプト例
# 課題の検索
・バックログのPROJECT1-100の課題を説明して
・バックログのPROJECT1のプロジェクトで処理中の課題を教えて
# 課題の更新
・PROJECT1-100の課題のステータスを完了にして
・PROJECT1-100の課題に「〜〜〜」とコメントして
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.