トークン

外からの入口で使う個人のトークンです。ふつうはブラウザでの連携で受け取り、CI などでは手で作ります。

外からの入口は、あなた個人のトークン(lvl_ で始まります)で呼びます。トークンは、あなたのワークスペースの中で、あなたとして働きます。できるのは、お金のかからない操作だけです。

​

連携で受け取る

ふつうは、ブラウザで livlive と連携して受け取ります。livlive の頁で「連携する」を押すと、トークンが CLI や MCP に届きます。トークンを作ったり、見たり、貼り付けたりすることはありません。連携のしかたはインストールと連携にあります。

​

手で作る

CI やスクリプトなど、ブラウザで連携できないところでは、トークンを手で作ります。livlive の 設定 › アクセストークン で名前を入れ、「トークンを作成」を押します。トークンは一度しか表示されないので、そのとき控えてください。

CLI とローカル MCP には、環境変数で渡します。環境変数は、連携で保存したトークンより先に使われます。

export LIVLIVE_TOKEN=lvl_xxxxxxxxxxxxxxxx
export LIVLIVE_BASE=https://backstage.livlive.ai

LIVLIVE_BASE は、指定がなければこのアドレスです。この PC に保存して使うなら、livlive login --paste で貼り付けます。

​

自分のプログラムから呼ぶ

トークンは Authorization ヘッダーで送ります。

Authorization: Bearer lvl_xxxxxxxxxxxxxxxx

curl -H "Authorization: Bearer $LIVLIVE_TOKEN" "$LIVLIVE_BASE/api/ops"

呼べる入口と、答えの形は仕組みにあります。リモート MCP では、連携で受け取ったトークンを、クライアントが自分で送ります。

​

トークンを止める

連携で受け取ったトークンも、手で作ったトークンも、設定 › アクセストークン に名前つきで並びます。「無効にする」を押すと、すぐに使えなくなります。CLI では、livlive logout でこの PC のトークンを止められます。

期限は 90 日です。切れたら、もう一度連携するか、作り直します。

​

安全に使う

トークンはあなたの PC の中だけに置いてください。ブラウザで動くコードや、公開するリポジトリに書かないでください。

• トークンが効くのは、外からの入口(/api/ops と /api/mcp)だけです。
• トークンが無い、正しくない、期限が切れた、または無効にしたときは、401 が返ります。