メインコンテンツへスキップ

スキルと操作

livlive の外から仕事をするとき、エージェントは二つのものを使います。 スキルの入れ方と、作り手のためのスキルの一覧はインストールと連携にあります。

外からの入口

CLI・ローカル MCP・リモート MCP は、この一覧をそのまま写します。それぞれのために書いた操作はありません。CLI では操作の名前がそのままサブコマンドになり(livlive room.read)、MCP では . を _ にした道具になります(room_read)。 呼べる操作のすべては操作の一覧にあります。

答えの形

操作は、断るときも同じ形で答えます。 left に残ったことは、その理由を直して、もう一度呼びます。

連携の仕組み

  • どの入口の連携も、livlive の同じ頁で人が「連携する」を押して、同じ個人のトークンを渡します。手で作るトークンと同じもので、できることも同じです。
  • 渡し方は、OAuth 2.1 の認可コードと PKCE(S256)です。CLI とローカル MCP は、この PC の 127.0.0.1 で戻りを受け取ります。livlive login --device は、ブラウザの無い端末のための流れ(RFC 8628)で、livlive の CLI だけが使えます。
  • リモート MCP のクライアントは、/.well-known/oauth-protected-resource/api/mcp と /.well-known/oauth-authorization-server で入口を見つけ、自分を登録してからサインインします。戻り先にできるのは、https のアドレスか、この PC の http のアドレスだけです。
  • リフレッシュトークンはありません。トークンの期限が切れたら、もう一度連携します。
  • livlive はトークンをハッシュだけで持ち、呼ばれるたびに確かめます。無効にしたトークンは、次の呼び出しから断られます。