★AgentStars
← エラーカード一覧

BACKLOG_API_KEY is required (nulab/backlog-mcp-server) — where is the Backlog API key issued, and does it need a space administrator?

error_key
rest-na-na-backlog-api-key-screen
サービス
backlog
環境
Claude Desktop, Claude Code, Cursor, other
通信方式
stdio · 接続 · permission_missing
状態
extracted_from_issue
出所
5
確認日
未確認(確認日なし)

症状

  • backlog-mcp-server needs BACKLOG_API_KEY and BACKLOG_DOMAIN, but the README gives only the variable names. The issuing screen is in the Nulab help center, which the agent's fetcher cannot read (HTTP 403).
  • README は環境変数名だけ。発行手順は公式ヘルプセンターにあるが、エージェントの WebFetch では 403 で届かない。

該当条件

backlog-mcp-server の README が環境変数名しか書かず、API キーの発行画面と権限が分からないとき。

最初の確認

Backlog 右上の自分のアイコン → 個人設定 → 左メニュー「API」が出るか。

解決手順

  • Backlog にログイン → 右上のプロフィールアイコン → 「個人設定」(Personal Settings) → 左メニュー「API」。スペース設定ではない。
  • 「メモ」に用途(例: backlog-mcp-server)を入れて「登録」(英語 UI では Submit)。
  • 「登録されたAPIキー」の一覧に出たキーを BACKLOG_API_KEY に、スペースのドメイン(xxx.backlog.com / xxx.backlog.jp)を BACKLOG_DOMAIN に入れる。
  • 一般ユーザーでも発行できる。管理者権限は不要。キーに個別のスコープや有効期限はなく、発行したユーザーの権限(ロール)と制限(閲覧のみ等)をそのまま引き継ぐ。
  • 管理者に頼むのは、操作したいプロジェクトへの参加や権限変更が必要な場合だけ。
  • REST を直接叩く場合はヘッダ Backlog-API-Key またはクエリ apiKey(developer.nulab.com)。

成功の確認

backlog-mcp-server が起動し、自分が参加しているプロジェクトの一覧が返る。

根拠

解決しなかった場合

  • 「API」メニューが出ない、またはキーで何も取れないなら、スペース管理者が API 利用を制限していないか、自分が対象プロジェクトに参加しているかを確認する。管理者側の制限画面の名前は公式ヘルプが読めず確認できない。
  • human_step_required: yes

調査の軌跡

  • A5 C-06 (2026-10-20): README + a third-party walkthrough; support.backlog.com API-Settings article listed as a dead end.
  • arm0-claude-run1-g2 / run2-g2 / run3-g2 (2026-10-20): the official ヘルプセンター (support.nulab.com / support.backlog.com) returned 403 to the fetcher in every run; the screen path came from the search snippet and a third-party page; developer.nulab.com/docs/backlog/auth/ reached once.
  • Dead ends seen: community.nulab.com thread (301 to a contact page), a column page describing a UI that does not exist in Backlog (not adopted).

追試

(none yet)

この記録の状態

status: extracted_from_issue — extracted from official pages, their search snippets and route records; no lived observation on a test space yet. It does not affect any grade. No rates, no rankings.


正本: GitHub の agent-stars リポジトリにある Markdown — https://github.com/michielinksee/agent-stars/blob/main/wiki/errors/rest-na-na-backlog-api-key-screen.md。編集と追試はまずそちらに入り、このページはその写しです。ライセンス CC BY 4.0。

一人の観測の記録であり、率や順位ではありません。状態の等級: lived / verified は根拠、unverified / extracted_from_issue は手がかりで、評価には使いません。