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

# トークン

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

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

## 連携で受け取る

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

## 手で作る

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

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

```bash theme={null}
export LIVLIVE_TOKEN=lvl_xxxxxxxxxxxxxxxx
export LIVLIVE_BASE=https://backstage.livlive.ai
```

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

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

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

```http theme={null}
Authorization: Bearer lvl_xxxxxxxxxxxxxxxx
```

```bash theme={null}
curl -H "Authorization: Bearer $LIVLIVE_TOKEN" "$LIVLIVE_BASE/api/ops"
```

呼べる入口と、答えの形は[仕組み](https://docs.livlive.ai/developers/how-it-works.md)にあります。リモート MCP では、連携で受け取ったトークンを、クライアントが自分で送ります。

## トークンを止める

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

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

## 安全に使う

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

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


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