luno-cms/mcp

エントリ 1 件。必須: formSetId, entryId（いずれも UUID）。

1 つの Form Set のスキーマ + save_revision 用 snapshotShape。select/radio/multiselect には masterEntityKey・sampleValues・公開 records URL を付与。保存前に必ず確認する。必須: formSetId（UUID。Form Set の slug ではない。list_form_sets / apply_* の id）。

MCP Private Beta 計測ファネルを再構成。任意: funnelId（省略時は当セッション / LUNO_FUNNEL_ID）。詳細: agent.measurement-funnel

管理画面ログインの見た目設定を取得（認証要・引数なし）。背景=Standard+、WL=Business+。

管理画面ログイン用ブランド取得（認証不要）。任意: projectId（省略時はエージェントキーのプロジェクト）。branding_tier / login_background / hide_* を返す。

マスタエンティティ 1 件。必須: entityId（UUID。list_master_entities の id）。

この MCP パッケージの実行時情報（引数なし・LUNO API は呼ばない）。mcpVersion / toolCount / contract（tool→Admin API）。ツールが載っていてもホスト API が未デプロイのことがある。404 なら API が古い。代替 mutation を発明しない。詳細: luno://mcp/runtime。

サイトのコンテンツ多言語設定を取得（引数なし）。有効/無効・content_locales・content_default_locale。

既存プロジェクト再開時の最初の一手。intentCapabilities（ユーザー意図→プロダクト。お問い合わせは create_contact_form。お知らせ/ブログは purposeLabels で templateSlug）・nextMoves・hints.intent・Form Sets・Contact Forms・Masters・quota・locales・公開 API ベースを返す。空プロジェクトでも Contact を Form Set テンプレに落とさない。権限不足は available:false。MCP パッケージ版と API 契約は get_mcp_runtime（引数なし・LUNO 非呼び出し。ツール一覧 ≠ API デプロイ済み）。詳細: agent.discover。引数なし。

下書き/承認待ちリビジョンのプレビュー URL を取得（POST pub-preview-url）。必須: formSetId, entryId, revisionRowId（= save_revision の id）。任意: target（external=外部サイトテンプレ優先・既定, luno=LUNO ホスト）。返却 url を人間がブラウザで開いて確認。続けて publish_revision（can_publish=false なら pendingHumanApproval で人間承認）。未公開は Standard 以上プラン。詳細: luno://publishing-guide / agent.publish-revision。

エージェントキーのプロジェクト向け公開 API ベース URL を返す。引数なし。ローカルでは /public/p/{projectId}/v1 を使う（Host ベース /public/v1 は DEFAULT_TENANT_ID に落ちる）。

操作中プロジェクトのフォームセット・フィールド定義を一括取得する。引数なし。

LUNO 公式 Form Set スターター一覧（引数なし）。purposeLabels（ja/en。お知らせ・ブログ等）で用途をマッチし、返却 slug を apply_builtin_form_template の templateSlug に使う。slug を暗記しない。お問い合わせはここに無い。create_contact_form / get_project_overview.intentCapabilities を使う。詳細: agent.builtin-form-templates

管理画面ログイン IP 許可リスト一覧（Business+・引数なし）。

Form Set 内のエントリ一覧。必須: formSetId（UUID）。返却 item.id を entryId に使う。

Form Set 一覧を取得する。引数なし。各 item の id（UUID）を他ツールの formSetId に使う（slug ではない）。

マスタエンティティ一覧（引数なし。key / hierarchical / record_count 含む）。item.id を entityId に使う。

マスタレコード一覧（label は locale map。階層時は parent_record_id）。必須: entityId。任意: q（検索）。

アップロード済みメディア（アセット）一覧。任意: limit（1–100、既定 30）。

エントリのリビジョン一覧。必須: formSetId, entryId。各 item の id / revision を publish_revision に渡す。

静的 enum（constraints.enum）を Master Reference（masterEntityKey）へ移行するプレビュー（schema/full）。必須: formSetSlug, fieldKey, masterEntityKey, dryRun（true のみ）。任意: formKey（fieldKey が一意なら省略可）, mapping（enum 値→Master value 文字列。UUID ではない）。このツールは書き込まない。dryRun: false / 省略は拒否し API を呼ばない。実行は propose_change(action: migrate_field_to_master_reference)。apply_form_blueprint / update_field / update_field_type は使わない。mapping 省略時は enum 値と Master value / 一意 label を自動提案。曖昧なら mapping_ambiguous。dryRun が enum 無し / mapping 空なら constraints が JSONB 文字列のことがある。get_form_set_schema で実体を確認（バックエンド修正はホスト側）。成功しても snapshot 値は Master value に変わ…

サイトのコンテンツ多言語設定を更新（tenant_admin JWT のみ。エージェントキー不可）。任意: contentLocalesEnabled, contentDefaultLocale, contentLocales。

複数ステップの構造変更を Change Plan として提案（schema/full）。必須: goal, risk, steps（各 step に dry_run + mutation.body）。本ツールは mutations を実行しない。Human が Console で承認するまで pending_approval。先に apply_* / migrate_field_to_master_reference / rename_master_record_slug を dryRun: true で呼び、返却を steps[].dry_run.raw に格納し、本実行用 body を mutation.body に入れる。action は apply_form_blueprint / apply_builtin_form_template / apply_master_blueprint / migrate_field_to_master_reference / rename_master_record_slug。詳細: agent.change-plans / agent.mcp-security-permissions

リビジョンを公開（1 回で draft→submit→approve。サーバー /publish が中間 revision +1 を吸収）。必須: formSetId, entryId, revisionRowId（= save_revision の id）, revision（= save_revision の revision。save 直後の番号で可）。任意: publishAt（予約公開 ISO8601）。can_publish=false のキーは submit までで止まり pendingHumanApproval: true を返す（人間が Console で承認）。詳細: agent.publish-revision / agent.mcp-security-permissions

Master Record の公開 identifier（slug。互換キー value）をリネームするプレビュー（schema/full）。必須: masterEntityKey, dryRun（true のみ）, slug または value, recordId または currentSlug/currentValue。このツールは書き込まない。dryRun: false / 省略は拒否し API を呼ばない。実行は propose_change(action: rename_master_record_slug)。update_master_record の value PATCH は使わない（snapshot が切れ、エージェントキーは 401）。承認後は master_records.value と参照 Field の snapshot を同時に書き換える。execute（Change Plan 承認後）は対象以外の Master Record の sort_order を正規化することがある。dryRun preview を確認。意図しない並び替えなら人間に止めてもらう（ホスト側の仕様確認）。詳細: agent.change-plans / agent.snapshot-field-values。

エントリ本文を新しい下書きリビジョンとして保存。必須: formSetId, entryId, snapshot。snapshot は { [formKey]: { [fieldKey]: value } }（フォームキー配下にネスト）。フラットな field_key トップレベルは 400。任意: idempotencyKey。返却の id → publish_revision の revisionRowId、revision → publish_revision の revision。形は get_form_set_schema または luno://content/schema-guide。

ヘルプ KB 検索。必須: q。任意: locale（ja|en）, limit（既定 20）。category agent（snapshot / Form Blueprint / 公開 API / publish_revision）もヒット。

エージェントタスクの Run を開始（schema/full）。必須: goal。任意: clientLabel（cursor / claude-code / mcp 等）。返却 agentRun.id を以降のツール呼び出しに X-Agent-Run-Id として自動付与（本 MCP セッション内）。詳細: settings.agent-activity / agent.mcp-security-permissions

指定リビジョンを承認申請する（公開まで一括したい場合は publish_revision を優先）。必須: formSetId, entryId, revisionRowId（= save_revision の id）, revision（= save_revision の revision）。

text/textarea/tiptap をソース言語から他ロケールへ AI 翻訳（Standard+・AI チケット 1/回）。必須: sourceLocale, targetLocales（1–3）, fields（各 formKey/fieldKey/type/sourceText）。返却 items を snapshot にマージして save_revision。

Contact Form を更新（PUT・schema/full。GET した全フィールドを body に含める）。必須: formId（Contact Form UUID）, slug, name, recipient_email, fields。任意: autoreply_*, email_signature。fields は { key, type, label:{ja,en}, required }[]（Form Set の fieldKey ではない）。詳細: agent.contact-form-mcp。

エントリの slug を更新。必須: formSetId, entryId, slug。

管理画面ログインの見た目を更新。任意（1 つ以上推奨）: adminLoginBackground（cosmic|gradient|plain|none・Standard+）, adminLoginHideLunoLogo, adminLoginHidePoweredBy（Business+）。

マスタレコードを更新。必須: entityId, recordId。任意: label, value, sortOrder, parentRecordId, data, color（#RRGGBB。null で消す）。**エージェント API キーでは不可**（401 — ユーザ JWT + 編集権限が必要）。identifier（slug / value）の変更は rename_master_record_slug → propose_change。並び替え・色の一括は apply_master_blueprint を使う。

階層マスタの親子・並び順を一括更新。必須: entityId, updates（全レコードを含める配列。各要素に id, parent_record_id, sort_order）。エージェントキーでは 403。

メディアライブラリへ画像/ファイルをアップロード（POST /v1/media）。必須（いずれか一方）: sourceUrl / base64 / filePath（ローカルパス推奨）。任意: filename, mimeType, folderId。返却 id（UUID）を image / image_gallery に入れる（luno://content/schema-guide）。外部 URL を snapshot に直書きしない。stg/prod へローカル画像を上げるときは filePath（sourceUrl の 127.0.0.1 は届かない）。

Master Blueprint を検証（schema/full）。必須: entities（1 件以上の配列）。各 entity: key, name, records[{ value, label, sort_order }]。適用はしない。詳細: agent.master-blueprint-mcp, luno://content/schema-guide。