# Reported issues for mcp by luno-cms

Pod holds 10 of 10 GitHub reports that passed its relevance review. This can include external user reports, maintainer-confirmed bugs, and concrete feature gaps. Treat them as evidence to inspect, not a count of distinct defects.

Back to [mcp by luno-cms](/mcp/mcp-by-luno-cms).

## Most discussed

### [P1] ask_admin_help 502 / truncated — 再現性と影響範囲を調べる

Parent: https://github.com/luno-cms/mcp/issues/45
Priority: 🟡〜🔴（再現性次第）
Owner: MCP wrap + hosted LUNO help/LLM 経路

## Symptom

`ask_admin_help` が 502。メッセージ例: `AI response was truncated`。

候補: response token limit / timeout / backend proxy / model limit / retry / streaming。

## Why it matters

Admin Help は Agent のトラブルシュート手段。Help 自身が不安定なのは UX として痛い。

## This issue

- 再現手順（何を聞いたか、何回、どの環境）を残す
- 複数回なら本調査。単発なら観測継続
- MCP 側で 502 を Agent が読めるエラー（retryable / hint）にできているかも確認

複数回発生しているなら優先度を 🔴 に上げて実装する。

[Read the thread](https://github.com/luno-cms/mcp/issues/53) · 2026-09-06 · closed · outside contributor · 2 comments

### [P0] rename_master_record_slug の sort_order 副作用を仕様確認する

Parent: https://github.com/luno-cms/mcp/issues/45
Priority: 🔴 仕様確認必須。放置しない
Owner repo: hosted luno-cms/luno

## Symptom (AT)

```
一般  sort_order=10
↓ rename
↓
0
```

他レコードも `0, 1, 2` に再採番された。**未変更レコードまで変わった。**

Agent から見ると `rename_master_record_slug` なのに `sort_order` まで変わる。side effect が大きい。

## Principle

> Tool は名前から予想できない mutation を極力発生させない

Schema migration の安全性と同じ思想。

## Resolve one of

1. **仕様** → ドキュメントに「rename は sort_order を正規化する。他レコードも再採番する」と書く
2. **バグ** → rename は slug/value…

[Read the thread](https://github.com/luno-cms/mcp/issues/50) · 2026-09-06 · closed · outside contributor · 2 comments

### [P0] [Bug] JSONB constraints を正規化して読む（横展開）

Parent: https://github.com/luno-cms/mcp/issues/45
Priority: 🔴 横展開すべきバグ調査
Owner repo: hosted luno-cms/luno（MCP は wrap のみ）

## Symptom (AT)

```
fetch_types: false
↓
JSONB → string
↓
asConstraintObject()
↓
parse されない
↓
enum が存在しないと誤判定
```

`migrate_field_to_master_reference` が、実在する `constraints.enum` を見逃した。

## Ask

`constraints` を読んでいる箇所を **LUNO 本体で全検索してレビュー**。migration 専用ではなく:

> JSONB constraints handling should be normalized

同じ前提（JSONB が string で来る）を持つ読取経路を潰す。

この Issue は公開 MCP…

[Read the thread](https://github.com/luno-cms/mcp/issues/49) · 2026-09-06 · closed · outside contributor · 2 comments

### [Epic] MCP / Agent Developer Experience & Reliability

実地 AT（`migrate_field_to_master_reference` / Claude Code）から見えた境界です。

**問題は「Tool が足りない」だけではない。** Agent / MCP Tool / Docs / Backend API / Actual behavior の**契約の一貫性**が、成功率に直結している。

```
             Agent
               │
       ┌───────┴───────┐
       ↓               ↓
     MCP Tool        Docs
       │               │
       ↓               ↓
    Backend API     Expected behavior
       │
       ↓
    Actual behavior
```

個別 Issue を同じ重みで切らない。優先度は下表。

| # | Issue | Priority | Why |…

[Read the thread](https://github.com/luno-cms/mcp/issues/45) · 2026-09-06 · closed · outside contributor · 1 comment

### [P0] apply_form_blueprint: description / docs / 実能力を一致させる

Parent: https://github.com/luno-cms/mcp/issues/45
Priority: 🔴 Agent 成功率に直結（契約）

## Problem

Agent は Tool description を見て動く。

書いてあること: 既存 Form Set にも `kind=update` で field 追加できる。

実地: 新規 Form Set 作成しか通らない（またはそう見える）。

正しい行動なのに失敗する → **intelligence ではなく contract の問題。**

## Quality bar

```
Tool description
      ≡
Actual API capability
      ≡
Documentation
```

これをテストする（description に `kind=update` と書いてあるなら、既存 slug への field 追加 dryRun が `kind=update` になること。未対応なら description / README /…

[Read the thread](https://github.com/luno-cms/mcp/issues/51) · 2026-09-06 · closed · outside contributor · 0 comments

### [P0] API と MCP のリリース同期 / capability discovery

Parent: https://github.com/luno-cms/mcp/issues/45
Priority: 🔴 Agent 成功率に直結
Backend: hosted luno-cms/luno（このリポから API は触らない）

## Problem

実地 AT:

```
MCP 0.2.43  migrate_field_to_master_reference
        ↓
Backend API
        ↓
404
```

逆方向もあった（API に color があるが MCP 未対応）。

**MCP Tool の存在 = Backend でその機能が使える、とは限らない。** Agent には致命的。

## Direction

理想のリリース単位:

```
Feature X
 ├ Backend API
 ├ MCP Tool
 ├ Documentation
 └ Version
```

最低限、リリース時に対応表が見えること:

```
migrate_field_to_master_reference
MCP:…

[Read the thread](https://github.com/luno-cms/mcp/issues/48) · 2026-09-06 · closed · outside contributor · 0 comments

### [P0] Agent 配布: npx cache でも最新 MCP を確実に取る

Parent: https://github.com/luno-cms/mcp/issues/45
Priority: 🔴 Agent 成功率に直結

## Problem

Claude Code の `.mcp.json` は:

```
npx -y @luno-cms/mcp run stg
```

npx キャッシュが残ると:

> 「最新版を公開したから試してください」
> Agent: 「まだ古いバージョンです」

を繰り返す。**Agent の問題ではなく配布 UX。**

ユーザーに「毎回 version pin して上げて」は美しくない。

## Direction (pick in implementation)

1. 生成する `.mcp.json` を `npx -y @luno-cms/mcp@latest` にし、latest が確実に更新されることを検証する
2. それでも cache が残るなら、`run` 起動時に自分の version をログ / ツール出力に出す
3. README / setup に「取り直し + `/mcp`…

[Read the thread](https://github.com/luno-cms/mcp/issues/47) · 2026-09-06 · closed · outside contributor · 0 comments

### [P2] CLI: add --version / version for Agent diagnostics

Parent: https://github.com/luno-cms/mcp/issues/45
Priority: 🟡 small, fix soon

## Problem

`npx @luno-cms/mcp --version` も `version` も無い。Agent の診断が

```
MCPが動かない → バージョン確認 → API と比較
```

なのに、今は `ps` / npx cache / `package.json` を辿るしかない。

## Proposal

```bash
npx @luno-cms/mcp --version
npx @luno-cms/mcp version
```

`package.json` の version を stdout に出して終了（MCP は起動しない）。`help` にも載せる。

## Not

大きな version 同期基盤（#3）。これは診断の入口だけ。

[Read the thread](https://github.com/luno-cms/mcp/issues/46) · 2026-09-06 · closed · outside contributor · 0 comments

## Most recent

### [UX] Align MCP setup environments with user-accessible LUNO environments

## Problem

`npx @luno-cms/mcp setup` generates **dev / stg / prod** as equal, first-class environments, and docs / CLI / the `/luno` skill treat **stg as the recommended default**.

The MCP package is public OSS (`@luno-cms/mcp` on npm). The LUNO access model for a first-time **general user** is:

| Environment | Who can use it | Default URL written by setup |
|---|---|---|
| `dev` | LUNO internal / local Admin API | `http://127.0.0.1:8787/admin` |
| `stg` | Not opened to general users…

[Read the thread](https://github.com/luno-cms/mcp/issues/39) · 2026-09-02 · open · outside contributor · 0 comments

### P1: MCP Tool Annotations Hardening (M8ven / Agent Governance)

## Why

M8ven Trust Index (Code Verified, 74/100) reports **42/42 tools missing MCP tool annotations** (`readOnlyHint`, `destructiveHint`, `idempotentHint`, `openWorldHint`). Code audit confirms **0/49 registered tools** in `src/server.ts` currently set these hints.

This is not a score-chasing exercise. Annotations are part of LUNO's **Agent Governance foundation**: they help MCP clients and agents predict side effects before invoking tools in production backends (BUILD / OPERATE / GOVERN).…

[Read the thread](https://github.com/luno-cms/mcp/issues/13) · 2026-08-25 · closed · outside contributor · 0 comments

The remaining reports are on [the project's issue tracker](https://github.com/luno-cms/mcp/issues).