API キーを発行せずに Claude Code から Backlog を使う：Backlog MCP Server の OAuth モードを試してみた

$ mkdir -p ~/src && cd ~/src
$ git clone https://github.com/nulab/backlog-mcp-server.git
$ cd backlog-mcp-server
$ pnpm install
$ pnpm run build

$ mkdir -p ~/.config/backlog-mcp
$ touch ~/.config/backlog-mcp/env
$ chmod 600 ~/.config/backlog-mcp/env

BACKLOG_DOMAIN=example.backlog.com
BACKLOG_OAUTH_CLIENT_ID=（登録したアプリケーションの Client ID）
BACKLOG_OAUTH_CLIENT_SECRET=（登録したアプリケーションの Client Secret）
MCP_SERVER_BASE_URL=http://localhost:3333
MCP_TRANSPORT=http
MCP_HTTP_HOST=127.0.0.1
MCP_HTTP_PORT=3333
ENABLE_TOOLSETS=space,project,issue,wiki,document

$ nvm version default
v26.13.1

#!/bin/bash
set -euo pipefail

set -a
source "$HOME/.config/backlog-mcp/env"
set +a

# nvm を読み込み、既定のバージョンの node を PATH に入れる
export NVM_DIR="$HOME/.nvm"
set +u
source "$NVM_DIR/nvm.sh"
set -u

exec node "$HOME/src/backlog-mcp-server/build/index.js"

$ chmod 700 ~/.config/backlog-mcp/start.sh

$ op --version
2.42.0
$ which op
/opt/homebrew/bin/op

$ op vault list
ID                            NAME
a1b2c3d4e5f6g7h8i9j0k1l2m3    Employee

BACKLOG_DOMAIN=example.backlog.com
BACKLOG_OAUTH_CLIENT_ID=op://Private/backlog-oauth/username
BACKLOG_OAUTH_CLIENT_SECRET=op://Private/backlog-oauth/credential
MCP_SERVER_BASE_URL=http://localhost:3333
MCP_TRANSPORT=http
MCP_HTTP_HOST=127.0.0.1
MCP_HTTP_PORT=3333
ENABLE_TOOLSETS=space,project,issue,wiki,document

#!/bin/bash
set -euo pipefail

# nvm を読み込み、既定のバージョンの node を PATH に入れる
export NVM_DIR="$HOME/.nvm"
set +u
source "$NVM_DIR/nvm.sh"
set -u

exec /path/to/op run --env-file="$HOME/.config/backlog-mcp/env" -- \
  node "$HOME/src/backlog-mcp-server/build/index.js"

$ ~/.config/backlog-mcp/start.sh

$ curl -s http://localhost:3333/.well-known/oauth-authorization-server

{
  "issuer": "http://localhost:3333",
  "authorization_endpoint": "http://localhost:3333/authorize",
  "token_endpoint": "http://localhost:3333/token",
  "registration_endpoint": "http://localhost:3333/register",
  "response_types_supported": [
    "code"
  ],
  "grant_types_supported": [
    "authorization_code",
    "refresh_token"
  ],
  "token_endpoint_auth_methods_supported": [
    "client_secret_post",
    "none"
  ],
  "code_challenge_methods_supported": [
    "S256"
  ],
  "authorization_response_iss_parameter_supported": true
}

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
  <key>Label</key>
  <string>local.backlog-mcp</string>
  <key>ProgramArguments</key>
  <array>
    <string>/bin/bash</string>
    <string>/Users/USERNAME/.config/backlog-mcp/start.sh</string>
  </array>
  <key>RunAtLoad</key>
  <true/>
  <key>KeepAlive</key>
  <true/>
  <key>StandardOutPath</key>
  <string>/Users/USERNAME/Library/Logs/backlog-mcp.log</string>
  <key>StandardErrorPath</key>
  <string>/Users/USERNAME/Library/Logs/backlog-mcp.log</string>
</dict>
</plist>

$ launchctl bootstrap gui/$(id -u) ~/Library/LaunchAgents/local.backlog-mcp.plist

$ launchctl print gui/$(id -u)/local.backlog-mcp | grep -E "state|pid"

        state = running
        pid = 83164
                state = active
                state = active

# 再起動
$ launchctl kickstart -k gui/$(id -u)/local.backlog-mcp

# 停止して登録を解除
$ launchctl bootout gui/$(id -u)/local.backlog-mcp

$ claude mcp remove backlog

$ claude mcp add --transport http --scope project backlog http://localhost:3333/mcp

{
  "mcpServers": {
    "backlog": {
      "type": "http",
      "url": "http://localhost:3333/mcp"
    }
  }
}

❯ /mcp

──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
  Backlog MCP Server

  Status:           ⚠ needs authentication
  Auth:             ✘ not authenticated
  URL:              http://localhost:3333/mcp
  Config location:  /path/to/.mcp.json

  ❯ 1. Authenticate
    2. Disable

  ↑/↓ to navigate · Enter to select · Esc to back

❯ /mcp

──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
  Backlog MCP Server

  Status:           ✔ connected
  Auth:             ✔ authenticated
  Protocol:         2026-07-28
  URL:              http://localhost:3333/mcp
  Config location:  /path/to/.mcp.json
  Capabilities: tools
  Tools: 50 tools

  ❯ 1. View tools
    2. Re-authenticate
    3. Clear authentication
    4. Reconnect
    5. Disable

  ↑/↓ to navigate · Enter to select · Esc to back

$ cd ~/src/backlog-mcp-server
$ { printf '%s\n' \
    '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"check","version":"0"}}}' \
    '{"jsonrpc":"2.0","method":"notifications/initialized"}' \
    '{"jsonrpc":"2.0","id":2,"method":"tools/list"}'; sleep 3; } \
  | BACKLOG_DOMAIN=example.backlog.com BACKLOG_API_KEY=dummy node build/index.js \
  | jq -r 'select(.id == 2) | .result.tools[] | select(.annotations.readOnlyHint != true) | .name'
add_project
update_project
add_issue
update_issue
delete_issue
add_issue_comment
update_issue_comment
add_related_issue
remove_related_issue
add_category
add_watching
update_watching
delete_watching
mark_watching_as_read
add_version_milestone
update_version_milestone
delete_version
add_wiki
update_wiki
add_pull_request
update_pull_request
add_pull_request_comment
update_pull_request_comment
add_document
reset_unread_notification_count
mark_notification_as_read

{
  "permissions": {
    "deny": [
      "mcp__backlog__add_project",
      "mcp__backlog__update_project",
      "mcp__backlog__add_issue",
      "mcp__backlog__update_issue",
      "mcp__backlog__delete_issue",
      "mcp__backlog__add_issue_comment",
      "mcp__backlog__update_issue_comment",
      "mcp__backlog__add_related_issue",
      "mcp__backlog__remove_related_issue",
      "mcp__backlog__add_category",
      "mcp__backlog__add_watching",
      "mcp__backlog__update_watching",
      "mcp__backlog__delete_watching",
      "mcp__backlog__mark_watching_as_read",
      "mcp__backlog__add_version_milestone",
      "mcp__backlog__update_version_milestone",
      "mcp__backlog__delete_version",
      "mcp__backlog__add_wiki",
      "mcp__backlog__update_wiki",
      "mcp__backlog__add_pull_request",
      "mcp__backlog__update_pull_request",
      "mcp__backlog__add_pull_request_comment",
      "mcp__backlog__update_pull_request_comment",
      "mcp__backlog__add_document",
      "mcp__backlog__reset_unread_notification_count",
      "mcp__backlog__mark_notification_as_read"
    ]
  }
}

> 自分に割り当てられている未完了の課題を一覧にしてください

⏺ Backlog で大栗さんが担当している課題は全部で XX 件あり、そのうち完了していないものが XX 件 あります（未対応 X / 処理中 X / 処理済み X）。

  MCP_TEST_1234567（某プロジェクトの機材準備）XX 件

  ┌─────────────────────┬────────┬────────┬────────────┬────────────────────────────────────┐
  │      課題キー       │  状態  │ 優先度 │    期限    │  件名                │
  ├─────────────────────┼────────┼────────┼────────────┼────────────────────────────────────┤
  │ MCP_TEST_1234567-30 │ 処理中 │ 中     │ なし       │ ネットワーク環境                   │
  └─────────────────────┴────────┴────────┴────────────┴────────────────────────────────────┘

  気になる点

  - XXXX は 1件が期限切れです。

> 課題 XXX-1 に「確認しました」とコメントを追加してください

⏺ コメントは追加できていません。XXX-1 は変更していません。

  追加できなかった理由

  コメント追加用の mcp__backlog__add_issue_comment を含め、Backlog MCP の書き込み系ツールは次の 2 つのファイルで permissions.deny
  に入っています。そのため、このセッションにツールが読み込まれません。

  - ~/.claude/settings.json
  - .claude/settings.json（このプロジェクト）

  書き込みを意図して止めている設定なので、curl で Backlog API を直接呼ぶような回避はしていません。

  コメントを追加する方法

  1. 両方のファイルの deny から "mcp__backlog__add_issue_comment" を外す: Claude Code を再起動するとツールが読み込まれ、私から「確認しました」
     を投稿できます。テストの後に deny へ戻すなら、そのときもお手伝いします。
  2. Backlog の画面から手で投稿する: 一度きりのテストならこちらが手軽です。

  どちらで進めるか教えてください。