Claude Code/Claude DesktopでBacklogのMCPを設定する

はじめに

backlog-mcp-server を使うと、Claude CodeやClaude DesktopからBacklogの課題・プロジェクト・Wiki・Pull Requestなどを直接参照・操作できます。

本記事では、Claude Code（CLI）・VS Code拡張・Claude Desktopそれぞれの設定方法をまとめます。

前提

• Node.js（npmコマンドが使える状態）
• BacklogのAPIキー（ユーザーアイコン → 個人設定 → API → APIキーの発行）
• BacklogのドメインURL（例: yourspace.backlog.jp）

Claude Code（CLI） / VS Code拡張

動作確認環境: Windows 11 / PowerShell 7

Claude Code CLIとVS Code上のClaude Code拡張は、同じ設定ファイル（~/.claude/settings.json）を共有しています。CLI側でコマンドを実行すれば、VS Code拡張にも自動的に反映されます。

設定コマンド

任意のディレクトリでPowerShellを開き、以下を実行します。

PS C:\Users\<ユーザー名> claude mcp add --scope user backlog `
  -e BACKLOG_DOMAIN=yourspace.backlog.jp `
  -e BACKLOG_API_KEY=YOUR_API_KEY `
  -- npx -y backlog-mcp-server

設定確認

Claude Codeを再起動後、/mcp コマンドを実行して backlog が Connected になっていればOKです。

/mcp

Claude Desktop

Claude Desktopは設定ファイルが別のため、JSON ファイルを直接編集します。

設定ファイルの場所

C:\Users\<ユーザー名>\AppData\Roaming\Claude\claude_desktop_config.json

Claude DesktopのメニューからはFile → Settings → Developer → Edit Config（日本語UI: ファイル → 設定 → 開発者 → 設定を編集）で開けます。

設定内容

{
  "mcpServers": {
    "backlog": {
      "command": "npx",
      "args": ["-y", "backlog-mcp-server"],
      "env": {
        "BACKLOG_DOMAIN": "yourspace.backlog.jp",
        "BACKLOG_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

他のMCPサーバーがすでに設定されている場合は、mcpServers の中に backlog ブロックを追記します。

設定確認

Claude Desktopを完全に再起動（タスクトレイから終了 → 再起動）します。チャット画面にハンマーアイコンが表示され、Backlogのツール一覧が確認できればOKです。

使用例

接続後は自然言語でBacklogを操作できます。

FUKUDA_PRJプロジェクトの課題一覧を取得して

FUKUDA_PRJ-1の詳細を教えて

まとめ