> ## Documentation Index
> Fetch the complete documentation index at: https://docs.livlive.ai/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> This is livlive's documentation. An agent reaches livlive from outside through the `livlive` CLI or the livlive MCP server (see /developers/install, /developers/cli and /developers/mcp). The person links it to livlive once, in the browser: `livlive login`, the local MCP's `livlive_login` tool, or the remote MCP at https://backstage.livlive.ai/api/mcp signing in by OAuth; a personal token made in livlive's settings is for CI. Pages marked 準備中 describe parts not decided yet: do not guess their behaviour.

# インストールと連携

> スキル・CLI・ローカル MCP・リモート MCP の入れ方と、ブラウザで livlive と連携するしかたです。

あなたの AI エージェントを livlive につなぐ入口は四つです。どれもコマンド一つで入り、livlive との連携は、ブラウザで一度「連携する」を押すだけです。

> [!WARNING]
>
> いまは招待制βの準備中です。CLI と MCP は npm から入れられますが、使うには livlive のアカウント(招待制)が要ります。スキル(`npx skills add`)は、livlive-kit の公開とともに使えるようになります。

| 入口 | 入れ方 | 向いていること |
| - | - | - |
| スキル | `npx skills add livlive-space/livlive-kit` | エージェントに、livlive の決まりごとと仕事の進め方を教える |
| CLI | `npm install -g @livlive/cli` | ターミナルから操作を呼ぶ。ステージを PC で作って登録する。CI |
| ローカル MCP | `npx -y @livlive/mcp`(クライアントが起動します) | 操作をエージェントの道具にする。ゲームのルールも PC で組み立てる |
| リモート MCP | `https://backstage.livlive.ai/api/mcp` | 何も入れずに、操作をエージェントの道具にする |

エージェントにはスキルを読ませ、CLI か MCP で livlive を操作させます。ステージを作るときは CLI を使います。ローカル MCP とリモート MCP の違いは [MCP](https://docs.livlive.ai/developers/mcp.md) にあります。

## スキル

```bash theme={null}
npx skills add livlive-space/livlive-kit
```

いまは livlive-kit を公開する前なので、このコマンドが動くのは、livlive-kit を見られる GitHub のアカウントだけです。

スキルを選ぶ画面には、作り手のための六つが並びます。最初に読むのは livlive です。

| スキル | 読むとき |
| - | - |
| [livlive](https://docs.livlive.ai/developers/skills/livlive.md) | 最初に。livlive の仕事を、どのスタッフのスキルと、どの操作で進めるかを案内します |
| `livlive-core` | コンテンツを書く前と、確かめる前に。構成表の形、言葉、スタッフと肩書き、あなたのエージェントと livlive の受け持ちの境目です |
| [livlive-cli](https://docs.livlive.ai/developers/skills/livlive-cli.md) | livlive を外から操作するときに。CLI と MCP の使い方を、連携から構成表の保存まで |
| [stage-lead](https://docs.livlive.ai/developers/skills/stage-lead.md) | ステージやゲームを作りたい人がいるときに。望みから、キャラクターが過ごしたステージまで導きます |
| [stage-package](https://docs.livlive.ai/developers/skills/stage-package.md) | ステージを PC で作り、エンジンのリファレンスに照らして確かめ、登録するときに |
| [stage-art](https://docs.livlive.ai/developers/skills/stage-art.md) | ステージの参考の絵(gpt-image)と模型(Tripo)を、本人のキーで作り、Blender でステージに合わせるときに |

ほかのスキル(スタッフの仕事と技のスキル)は、選ぶ画面には出ません。MCP をつなげば、どのスキルも MCP のリソース(`livlive://skills/<スキルの名前>`)として読めます。

## CLI

```bash theme={null}
npm install -g @livlive/cli
livlive login
```

Node.js 22.18 以上で動きます。`livlive login` を実行するとブラウザで livlive の頁が開くので、「連携する」を押します。この PC でブラウザを使えないときや CI での連携は、[CLI](https://docs.livlive.ai/developers/cli.md) にあります。

## ローカル MCP

あなたの PC で動く MCP サーバーです。クライアントが `npx` で起動するので、Node.js が要ります。

ローカル MCP とリモート MCP は、どちらか一つで十分です。違いは [MCP](https://docs.livlive.ai/developers/mcp.md) にあります。

```bash Claude Code theme={null}
claude mcp add livlive -- npx -y @livlive/mcp
```

```bash Codex theme={null}
codex mcp add livlive -- npx -y @livlive/mcp
```

```json Cursor など theme={null}
{
  "mcpServers": {
    "livlive": {
      "command": "npx",
      "args": ["-y", "@livlive/mcp"]
    }
  }
}
```

* Claude Code では、コマンドを実行したフォルダでだけ使えます。どのフォルダでも使うなら、`claude mcp add --scope user livlive -- npx -y @livlive/mcp` とします。
* Cursor では、この設定を `.cursor/mcp.json`(そのフォルダ)か `~/.cursor/mcp.json`(どのフォルダでも)に書きます。

連携のしかたは下の「連携する」に、つないだあとのことは [MCP](https://docs.livlive.ai/developers/mcp.md) にあります。

## リモート MCP

何も入れずに、livlive の MCP サーバーにつなぎます。

```bash theme={null}
claude mcp add --transport http livlive https://backstage.livlive.ai/api/mcp
```

Claude Code で `/mcp` を開き、livlive を選んで「Authenticate」を選びます。ブラウザで livlive の頁が開くので、「連携する」を押します。ほかのクライアントでつなげるかどうかと、リモートにない道具は [MCP](https://docs.livlive.ai/developers/mcp.md) にあります。

## 連携する

どの入口でも、連携は livlive の同じ頁で行います。連携には、livlive のアカウント(招待制)が要ります。

| 入口 | 連携の始め方 |
| - | - |
| CLI | `livlive login` |
| ローカル MCP | エージェントが道具 `livlive_login` を呼ぶ |
| リモート MCP | クライアントが OAuth で始める |

1. ブラウザで livlive の頁が開きます。ログインしていなければ、先に Google アカウントでログインします。招待コードの入力や規約への同意がまだなら、その頁が先に出ます。済むと、連携の頁に戻ります。
2. 頁に出る、連携するアプリの名前と戻り先(この PC の中のアプリか、連携先のアドレスか)を確かめます。`livlive login --device` のときは、アプリの名前のかわりにコードを入れる欄が出るので、ターミナルに出たコードを入れます。「連携する」のすぐ上に、いま入っているアカウントが出ます。違うアカウントなら、その横の「別のアカウントにする」を押して、入り直します。
3. 「連携する」を押します。やめるときは「やめる」を押します。
4. CLI とローカル MCP では「連携しました」と出るので、タブを閉じて、もとの画面に戻ってください。リモート MCP では、そのあとをクライアントが続けます。

CLI とローカル MCP は、押されるまで 5 分待ちます(`livlive login --device` は 10 分)。過ぎたら、もう一度始めてください。

### 連携でできること

* できるのは、お金のかからない操作だけです。頁にも「ステージやコンテンツの準備と確認ができます」「クレジットを使う操作はできません」と出ます。
* 連携は、するたびに一つずつ、livlive の 設定 › アクセストークン に名前つきで並びます。CLI とローカル MCP は `livlive CLI・MCP — <PC の名前>`、リモート MCP はクライアントが名乗る名前です。「無効にする」を押すと、すぐに使えなくなります。
* 別のアカウントで連携し直しても、前のアカウントの連携は残ります。止めるときは、前のアカウントで入り、その 設定 › アクセストークン で「無効にする」を押します。
* 期限は 90 日です。切れたら、もう一度連携してください。
* CI のように、ブラウザで連携できないところでは、手で作ったトークンを使います([トークン](https://docs.livlive.ai/developers/authentication.md))。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.