> ## 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.

# MCP

> livlive の MCP サーバーは二つです。PC で動かすローカル MCP と、何も入れずにつなぐリモート MCP の選び方と使い方です。

livlive の MCP サーバーは、外からの入口の操作を MCP の道具として、スキルとエンジンのリファレンスをリソースとして出します。あなたの PC で動かすローカル MCP と、何も入れずにつなぐリモート MCP の二つがあります。入れ方は[インストールと連携](https://docs.livlive.ai/developers/install.md)にあります。

## どちらを使うか

| | ローカル MCP | リモート MCP |
| - | - | - |
| 動くところ | あなたの PC。クライアントが `npx -y @livlive/mcp` で起動します | livlive。`https://backstage.livlive.ai/api/mcp` につなぎ、何も入れません |
| 連携のしかた | 道具 `livlive_login` を呼び、ブラウザで「連携する」を押します | クライアントが OAuth でサインインし、ブラウザで「連携する」を押します |
| 道具 | 操作のすべてと、ゲームのルールを PC で組み立てる `stage_rules_build` | 操作のすべて |
| リソース | スキルと、エンジンのリファレンス | 同じ |
| 連携の置き場所 | CLI と同じ設定です。どちらかで連携すれば、両方で使えます | クライアントが持ちます |
| つなげるクライアント | stdio の MCP サーバーを起動できるもの | OAuth でサインインし、`https` のアドレスか、この PC の `http` のアドレスに戻るもの |

ローカル MCP とリモート MCP は、どちらか一つで十分です。ステージを作るなら CLI を使い、MCP もつなぐならローカル MCP にします。番組の準備だけなら、どちらでもかまいません。何も入れたくないときは、リモート MCP です。

## ローカル MCP

* まだ連携していないとき(トークンが無いか、livlive が受け取らないとき)、道具は `livlive_login`(livlive と連携する)の一つだけです。
* エージェントが `livlive_login` を呼ぶと、ブラウザで livlive の頁が開き、道具はすぐに答えます。答えには頁のアドレスが入っているので、ブラウザが開かないときは、そのアドレスをこの PC のブラウザで開きます。
* 「連携する」を押すと、ほかの道具が出てきます。押しても出てこないクライアントでは、MCP サーバーを起動し直すと出ます。
* 押す前にもう一度 `livlive_login` を呼ぶと、まだ待っていることと、頁のアドレスを答えます。
* 連携は、livlive でトークンを無効にしたとき、期限が切れたとき、この PC で `livlive logout` を実行したとき(CLI とローカル MCP は同じ連携を使います)に切れます。切れたあとに道具を呼ぶと、連携が切れたことを答え、道具は `livlive_login` の一つに戻ります。もう一度呼んで、連携し直します。
* 連携してあるのに livlive に届かないときは、起動に失敗します。
* つなぎ先と連携の保存先は、CLI と同じ設定を読みます([CLI](https://docs.livlive.ai/developers/cli.md))。環境変数 `LIVLIVE_TOKEN` があると、連携で保存したトークンより先に使われます。

## リモート MCP

* Claude Code でのつなぎ方は、[インストールと連携](https://docs.livlive.ai/developers/install.md)にあります。
* ほかのクライアントでも、MCP の OAuth でサインインし、連携のあと `https` のアドレスか、この PC のアドレス(`http://127.0.0.1` や `http://localhost`)に戻るものなら、同じアドレスでつなげます。クライアントは、livlive の入口を自分で見つけ、自分を登録してからサインインします。
* `cursor://` のような、アプリ独自のアドレスに戻るクライアントは、つなげません。ローカル MCP を使ってください。
* ゲームのルールを PC で組み立てる道具(`stage_rules_build`)は、リモートにはありません。ステージを作るときは、CLI とローカル MCP を使います。
* 連携はクライアントが持ちます。期限が切れたり無効にしたりすると、クライアントがもう一度サインインを求めます。
* 別のアカウントでサインインし直したときに前の連携がどうなるかは、[インストールと連携](https://docs.livlive.ai/developers/install.md)の「連携でできること」にあります。

## 道具とリソース

| 種類 | 中身 |
| - | - |
| 道具 | `GET /api/ops` の操作です。名前の `.` は `_` になります(`room.read` → `room_read`)。部屋の要る操作は `project` を取ります |
| ローカルだけの道具 | `stage_rules_build`。ゲームのルールを PC で組み立て、livlive の `stage.rules.check` で確かめます。連携の前は `livlive_login` だけです |
| リソース | スキル(`livlive://skills/<スキルの名前>`。スキルを選ぶ画面に出ないものも)と、エンジンのリファレンス(`livlive://reference/engine`) |

道具の答えは、操作の答えの JSON です。`ok` が `false` のときは、MCP のエラー(`isError`)になります。答えの形は[仕組み](https://docs.livlive.ai/developers/how-it-works.md)にあります。


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