どちらを使うか
ローカル 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)。環境変数
LIVLIVE_TOKENがあると、連携で保存したトークンより先に使われます。
リモート MCP
- Claude Code でのつなぎ方は、インストールと連携にあります。
- ほかのクライアントでも、MCP の OAuth でサインインし、連携のあと
httpsのアドレスか、この PC のアドレス(http://127.0.0.1やhttp://localhost)に戻るものなら、同じアドレスでつなげます。クライアントは、livlive の入口を自分で見つけ、自分を登録してからサインインします。 cursor://のような、アプリ独自のアドレスに戻るクライアントは、つなげません。ローカル MCP を使ってください。- ゲームのルールを PC で組み立てる道具(
stage_rules_build)は、リモートにはありません。ステージを作るときは、CLI とローカル MCP を使います。 - 連携はクライアントが持ちます。期限が切れたり無効にしたりすると、クライアントがもう一度サインインを求めます。
- 別のアカウントでサインインし直したときに前の連携がどうなるかは、インストールと連携の「連携でできること」にあります。
道具とリソース
道具の答えは、操作の答えの JSON です。
ok が false のときは、MCP のエラー(isError)になります。答えの形は仕組みにあります。