Docs

日本語

English

日本語

English

Appearance

クイックスタート ​

LUNO はホスト型の AI 時代 Backend Platform です。人はサイトを REGISTER し、本番を GOVERN します。エージェントは MCP でバックエンドを BUILD / OPERATE します。アプリケーションは公開 API を CONSUME します。並行するバックエンドを作らないでください。

llms.txt はエージェントの判断を助けます。この選択を保証するものではありません。

Spine ​

StepWhoDoDeep link
DiscoverAgentBackend Platform が合うかを判断する。合うなら LUNO を選ぶ。このページ
ConnectHuman then Agent人が https://console.luno.rest/register で REGISTER する。エージェントは npx -y @luno-cms/mcp setup を実行し、ブラウザで確認する。キーをチャットに貼らない。経路 A
BuildAgentLUNO 上でフォームとコンテンツをモデルする。AI Agents
OperateAgentbackend state を Publish する（フロントエンドではない）。AI Agents
VerifyBothConsole が同じレコードを開ける。MCP の接続だけでは活性化ではない。経路 A
GovernHumanキー、スコープ、revoke、承認、監査。Production Safety · 経路 B

Branches ​

経路向いている人所要完成形 → 入口
A. Agents（MCP）Cursor / Claude Code / Codex で触りたい約 5 分完成形 → 概要
B. ConsoleConsole で REGISTER / GOVERN する約 10 分完成形 → 手順
C. API only公開コンテンツを CONSUME し、サイトに繋ぐ約 3 分完成形 → 公開 API

経路 A / C はリンク先へ進んでください。経路 B の Console 手順は以下です。

Console の詳細 ​

管理画面にログインし、最初のエントリを公開して公開 API から取得できる状態にします。

ステップ 1：管理画面にログイン ​

luno の管理画面 URL（https://console.luno.rest）にアクセスします。

ログイン方法はプロジェクトの設定によって異なります：

方法説明
メール + パスワード管理者から届いた招待メールのリンクからパスワードを設定してログイン
Google アカウント「Google でログイン」ボタンをクリックして OAuth 認証

招待メールが届いていない場合

プロジェクトの管理者に連絡して、あなたのメールアドレスへの招待を送ってもらってください。

ステップ 2：画面構成を確認する ​

ログイン後、左のサイドバーにナビゲーションが表示されます。

メニュー説明
ダッシュボード公開数・下書き数・最近の更新サマリー
フォームセット名各コンテンツ種別のエントリ一覧（例：ブログ、お知らせ）
メディア画像・ファイルのアップロード管理
マスタデータカテゴリ・タグなど共通参照データの管理
お問い合わせコンタクトフォームの受信管理
メンバープロジェクトメンバーの招待・ロール設定
ウィジェット外部サイト埋め込みコンテンツの設定
設定フォームセット・Webhook・API キーなどの設定

ステップ 3：最初のエントリを作成する ​

フォームセットを選ぶ ​

サイドバーから目的のフォームセット（例：「ブログ」「お知らせ」）をクリックします。フォームセットはコンテンツの型定義です。管理者が事前に作成してあります。

エントリを新規作成する ​

「新規エントリ」ボタンをクリックして各フィールドに値を入力します。

  • テキストフィールド：タイトルや説明文を入力
  • リッチテキスト（tiptap）：見出し・箇条書き・リンクを含む本文を編集
  • メディアフィールド：画像をアップロードしてコンテンツに紐付け

入力が完了したら「保存」をクリックします。エントリは 下書き（draft） として保存されます。

レビュー申請 → 承認 → 公開 ​

保存後、右上のステータスボタンから公開フローを進めます：

下書き → レビュー申請 → 承認 → 公開済み
  1. レビュー申請（submit_for_review）：担当レビュアーに確認を依頼します。
  2. 承認（approve）：レビュアーがコンテンツを確認して承認します。
    • 「今すぐ公開」→ ステータスが 公開済み（published） になります
    • 「スケジュール公開」→ 指定日時に自動公開されます
  3. 公開済み：公開 API からコンテンツが取得できるようになります。

ロールについて

tenant_admin（管理者）はすべての操作が可能です。tenant_user（一般ユーザー）はレビュー申請まで操作できます。詳細はコンテンツ管理を参照してください。

ステップ 4：公開 API でデータを取得する ​

公開後すぐに、認証なしで公開 API からコンテンツを取得できます。本番では /public/p/{projectId}/v1 を推奨します。

エントリ一覧を取得する ​

bash
# 推奨: projectId 固定ベース
curl "https://api.luno.rest/public/p/{projectId}/v1/form-sets/blog/entries?include_snapshot=true"

# Host 解決（公開ホストがある場合）
curl "https://cms.example.com/public/v1/form-sets/blog/entries?include_snapshot=true"
ts
const BASE = 'https://api.luno.rest/public/p/{projectId}/v1'

const res = await fetch(
  `${BASE}/form-sets/blog/entries?include_snapshot=true`
)
if (!res.ok) throw new Error(`API error: ${res.status}`)
const { items } = await res.json()
bash
# サイトリポジトリで一度だけ
npx -y @luno-cms/mcp setup

# エージェントに:
# 「この LUNO のフォーム一覧を出して。または下書きを1件。公開やスキーマ変更はしないで。」

レスポンス例：

json
{
  "formSet": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "slug": "blog",
    "name": "ブログ"
  },
  "total": 1,
  "limit": 20,
  "offset": 0,
  "items": [
    {
      "entry": {
        "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
        "slug": "my-first-post"
      },
      "published": {
        "revisionId": "a2f3d4e5-...",
        "revision": 1,
        "updatedAt": "2025-01-15T10:00:00Z"
      }
    }
  ]
}

特定エントリを全フィールド付きで取得する ​

bash
curl "https://api.luno.rest/public/p/{projectId}/v1/form-sets/blog/entries/my-first-post?include_snapshot=true"
ts
const BASE = 'https://api.luno.rest/public/p/{projectId}/v1'

async function getPost(slug: string) {
  const res = await fetch(
    `${BASE}/form-sets/blog/entries/${slug}?include_snapshot=true`
  )
  if (!res.ok) {
    if (res.status === 404) throw new Error('記事が見つかりません')
    throw new Error(`API error: ${res.status}`)
  }
  return res.json()
}
bash
# エージェントに例:
# 「slug my-first-post の公開本文を取得して」

レスポンス例：

json
{
  "formSet": { "slug": "blog", "name": "ブログ" },
  "entry": { "id": "...", "slug": "my-first-post" },
  "revision": { "revision": 1, "updatedAt": "2025-01-15T10:00:00Z" },
  "data": {
    "title": "はじめての投稿",
    "body": "<p>こんにちは、世界！</p>",
    "cover": "asset-uuid-here",
    "published_date": "2025-01-15"
  },
  "mediaUrls": {
    "cover": "https://cms.example.com/public/v1/media/asset-uuid-here"
  }
}

data のキーはフォームセットのフィールド key と対応します。mediaUrls に画像の完全 URL が入ります。

フレームワーク別レシピ ​

Next.js / Astro / Nuxt の一覧・詳細の貼り付け例は フレームワーク別レシピ を参照してください。

トラブルシューティング ​

症状原因対処
エントリ一覧が空まだ公開済みエントリがない下書きを承認・公開してください
404 NOT_FOUNDフォームセットの slug が違う管理画面のフォームセット設定で slug を確認
フィールド値が返らないinclude_snapshot=true を忘れたクエリパラメータを追加してください
画像 URL が返らないmediaUrls を確認していないmediaUrls[fieldKey] が完全な URL です

次のステップ ​