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_KEYandBACKLOG_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 が起動し、自分が参加しているプロジェクトの一覧が返る。
根拠
- https://github.com/nulab/backlog-mcp-server (official README; variable names)
- https://developer.nulab.com/docs/backlog/auth/ (official developer docs; header / query parameter, access decided by the user's permission)
- https://support.nulab.com/hc/en-us/articles/8783772200217 and https://support.backlog.com/hc/en-us/articles/115015420567-API-Settings (official help; the screen path appears in the search snippet, but the page body returned 403 to the fetcher in every route record)
- https://codenote.net/ja/posts/backlog-api-key-for-ai-agents/ (third-party walkthrough with the Japanese UI labels)
- 確認日: none. The screen path has not been independently verified by KanseiLINK on a test space; "確認できない" for the exact current labels.
- 環境: any MCP client running backlog-mcp-server over stdio.
解決しなかった場合
- 「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 は手がかりで、評価には使いません。