インストールと連携

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

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

いまは招待制βの準備中です。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 にあります。

​

スキル

npx skills add livlive-space/livlive-kit

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

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

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

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

​

CLI

npm install -g @livlive/cli
livlive login

Node.js 22.18 以上で動きます。livlive login を実行するとブラウザで livlive の頁が開くので、「連携する」を押します。この PC でブラウザを使えないときや CI での連携は、CLI にあります。

​

ローカル MCP

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

ローカル MCP とリモート MCP は、どちらか一つで十分です。違いは MCP にあります。

Claude Code

claude mcp add livlive -- npx -y @livlive/mcp

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

連携のしかたは下の「連携する」に、つないだあとのことは MCP にあります。

​

リモート MCP

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

claude mcp add --transport http livlive https://backstage.livlive.ai/api/mcp

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

​

連携する

どの入口でも、連携は 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 のように、ブラウザで連携できないところでは、手で作ったトークンを使います(トークン)。