> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tokios.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Tokios exposes private local models through https://api.tokios.com using an outbound-only connector tunnel.
> Use 'connector' for the local tokios-connector process.
> Use 'deployment' for the public model name in the API model field.
> Use 'upstream model id' for the model served by Ollama, llama.cpp, vLLM, LM Studio, or another local backend.
> API keys use the prefix sk-tok-. Connector tokens use the prefix ct-tok-.

# エージェントとスクリプト用の自動化トークンを作成する

> スコープを限定した有効期限付きの自動化トークン（at-tok-…）を発行し、コーディングエージェントやスクリプトがパスワードなしで API を通じて Tokios ワークスペースをセットアップ・管理できるようにします。

コンソールでの操作と同じようにワークスペースを操作できる**自動化トークン**を使えば、プログラムがコネクタのペアリング、モデルの公開、API キーの作成、使用状況の参照を行えます。コンソールの **Settings** で発行し、許可する操作を正確に選び、任意の日付に有効期限を設定します。Claude Code や Codex などのコーディングエージェント、CI ジョブ、またはスクリプトに渡せば、そのプログラムがすべてのセットアップを無人で実行できます。

これは API キーとは異なります。API キー（`sk-tok-…`）はクライアントがモデルを呼び出すためのものです。自動化トークン（`at-tok-…`）はプログラムがワークスペースを管理するためのもので、モデルを呼び出すことはできません。この二つが交差することはありません。

> [!NOTE]
>
> 自動化トークンは自分のワークスペースにのみ作用します。パスワードやメールアドレスの変更、API キーの表示や共有、コネクタのトークンのローテーション、保存されたプロンプトの読み取り、リクエストログの変更、他の自動化トークンの作成はできません。これらの操作は、サインインしたコンソールセッションからのみ実行できます。

## トークンを作成する

ワークスペースの管理者のみが自動化トークンの作成、一覧表示、取り消しを行えます。

**1. Settings を開く**

コンソールで **[Settings](https://tokios.com/console/settings)** を開き、**Automation tokens** までスクロールします。**Create token** をクリックします。

**2. 保持するものにちなんで名前を付ける**

トークン一覧とそれが作成する行で認識できる名前を付けてください。たとえば `claude-code on my laptop` や `ci-deploy` です。

**3. プリセットを選ぶかスコープを選択する**

**Setup** は、コネクタをインストールしてモデルを呼び出せるようにするエージェントに適したプリセットです。**Read-only** はモニタリングに向いています。**Full** はすべてのスコープを付与します。その他の場合は個別にスコープをチェックしてください。下の[スコープ](#scopes)を参照してください。

**4. 有効期限を選ぶ**

すべてのトークンには有効期限があります。一度限りのセットアップ実行には 1 時間を選び、常時ジョブにはより長い期間を選びます。最大は 1 年です。

**5. トークンを一度だけコピーする**

トークンは一度だけ表示されます。プログラムのシークレットストアまたはシェル変数にコピーしてください。紛失した場合は、一覧から **Regenerate** できます。古い値は直ちに機能しなくなります。

## スコープ

スコープは `resource:verb` です。`write` スコープには対応する `read` が含まれます。どのスコープにも `keys:rotate` と `models:reroute` は含まれません。

| スコープ | 許可される操作 |
| - | - |
| `connectors:read` | コネクタの一覧表示とライブステータスおよびホスト統計の読み取り |
| `connectors:write` | ペアリングの開始、承認、名前変更、取り消し、コネクタの削除。モデルをまだ提供しているコネクタを削除する場合に追加で必要なスコープ: `models:reroute` |
| `models:read` | モデル、デプロイメント、モデルグループ、価格、制限、接続情報の一覧表示 |
| `models:write` | モデルの作成、編集、一時停止、再開。モデルグループの作成、編集、削除。価格の設定と自動公開 |
| `models:reroute` | 既存のモデルを別のコネクタへ移動、名前変更、または削除する。いずれもそのモデルのトラフィックを受け取るマシンが変わるため、`models:write` も必要。含まれる唯一のプリセット: **Full** |
| `keys:read` | API キーの一覧表示（フィンガープリントと設定のみ、シークレットは含まない） |
| `keys:write` | API キーの作成、編集、取り消し、削除（新規作成されたキーのシークレットは一度だけ返される） |
| `keys:rotate` | 既存の API キーをローテーションして新しいシークレットを受け取る。キーの保持者が切り替わるため、含まれるプリセットは **Full** |
| `usage:read` | 使用状況、支出、リクエストログの読み取り（カウントとメタデータのみ） |
| `playground:run` | Playground とモデルヘルスチェックの実行（モデルにプロンプトを送信する） |

| プリセット | スコープ |
| - | - |
| **Setup** | `connectors:read`、`connectors:write`、`models:read`、`models:write`、`keys:read`、`keys:write`、`playground:run` |
| **Read-only** | `connectors:read`、`models:read`、`keys:read`、`usage:read` |
| **Full** | 上記のすべてのスコープ |

トークンのスコープ外の呼び出しは `403` を返し、不足しているスコープがエラーに名前付きで表示されるため、プログラムがどの権限が不足しているかを正確に伝えられます。

## トークンを使用する

Bearer トークンとして API ホストではなくコンソールホストに送信します。すべての管理呼び出しは `https://tokios.com/account/` 配下に存在します。

**macOS & Linux**

```bash theme={"theme":{"light":"github-light","dark":"css-variables"}}
curl -s https://tokios.com/account/connectors \
  -H "Authorization: Bearer at-tok-YOUR_TOKEN"
```

**Windows CMD**

```cmd theme={"theme":{"light":"github-light","dark":"css-variables"}}
curl -s "https://tokios.com/account/connectors" -H "Authorization: Bearer at-tok-YOUR_TOKEN"
```

| レスポンス | 意味 |
| - | - |
| `401` | トークンが無効、有効期限切れ、または取り消し済み、作成した管理者がパスワードを変更またはリセットした、またはワークスペースもしくはその管理者が停止中。 |
| `403` かつ `"scope"` | トークンにそのスコープがない。 |
| `403` "only available from the console" | この操作はサインインしたコンソールセッション専用。どのスコープでも許可されない。 |
| `429` | このトークンからの呼び出しが毎分 240 回を超えた、またはこのアドレスからのトークンの失敗試行が多すぎる。ロックアウトは有効なトークンも含め、そのアドレスからのすべてのトークンに及ぶ。待機して再試行。 |

完全な呼び出し一覧と無人セットアップが呼び出す順序については、[コーディングエージェントに Tokios をセットアップしてもらう](/ja/guides/agent-setup.md) を参照してください。

## エージェントに渡す

トークンを **Setup** プリセット、1 時間の有効期限で作成し、モデルを実行しているマシンでエージェントを起動して、次のプロンプトを送信します。

```text theme={"theme":{"light":"github-light","dark":"css-variables"}}
Read https://docs.tokios.com/guides/agent-setup and follow it. The console base URL is https://tokios.com and the automation token is in the TOKIOS_TOKEN environment variable. Never print the token. My model server is Ollama on this machine. When you are done, give me the final report described on that page.
```

エージェントを起動する前にシェルで `TOKIOS_TOKEN` を設定し、会話にシークレットが現れないようにします。ガイドページにエージェントが必要とするすべての情報が記載されています。

## トークンを管理する

コンソールの **Settings** の各行に、トークンのスコープ、フィンガープリント、有効期限、最後に使用された日時と IP アドレスが表示されます。

* **Regenerate** はシークレットを置き換えます。古い値は直ちに機能しなくなり、新しい値は一度だけ表示されます。
* **Revoke** はトークンを永久に停止します。置き換えるには新しいトークンを作成してください。
* **Delete** は取り消し済みまたは有効期限切れのトークンを一覧から削除します。

パスワードを変更またはリセットすると、作成したすべてのトークンが取り消されます。盗まれたセッションから発行されたトークンはアカウントを回復した時点で機能しなくなり、常時ジョブにはその後、新しいトークンが必要になります。

自動化トークンが作成した行には、**via token** バッジが **Connectors**、**Models**、**Keys** タブで表示されるため、プログラムが何を行ったかを常に確認できます。バッジはトークンが削除された後も残ります。

## トークンを安全に保つ

* **スコープは最小限に絞ってください。** 作業を終えた Setup トークンは保持せず、取り消しすべきです。
* **有効期限は短くしてください。** インタラクティブなエージェントセッションには 1 時間を使用します。長い有効期限はシークレットストア内の常時ジョブのみに使用します。
* **トランスクリプトに残さないでください。** シェル変数から読み取らせ、エージェントとのチャットに貼り付けないでください。
* **バッジと最終使用の列を確認してください。** 知らないアドレスからトークンが使用された場合は、取り消してください。
* **発行されたキーが何を意味するかを理解してください。** `keys:write` を持つトークンは API キーを作成でき、そのキーはトークンの有効期限が切れた後も機能し続けます。1 時間の Setup トークンを盗んだ人は、有効期限のないキーを発行して気づかれるまでモデルを呼び出せます。エージェントの実行後は、**Keys** タブを開き、**via token** とマークされた行を探し、予期しないものを取り消してください。
* **必要なときだけ `models:reroute` を付与してください。** 既存のモデルを移動、名前変更、または削除すると、そのトラフィックを受け取るマシンが変わります。コネクタのペアリングもできるトークンは、保持者が管理するマシンをペアリングし、そこへモデルを移動できます。Setup では決して必要ありません。Setup はモデルを作成しますが、移動はしません。
* **共有アドレスではロックアウトも共有されます。** 同じ IP アドレスからトークンの試行に 8 回失敗すると、そのアドレスからのすべてのトークンが、有効なものも含めて `429` で 6 分間拒否されます。同じオフィスネットワーク、NAT ゲートウェイ、または CI ランナープールの背後にあるエージェントは、そのロックアウトを共有します。あるクライアントが無効なトークンを送り続ける場合は、ループで再試行させずに、停止するか修正してください。

> **[エージェントによるセットアップ](/ja/guides/agent-setup.md)**
>
> Setup トークンを使ってエージェントが実行する手順。

> **[API キー](/ja/setup/api-keys.md)**
>
> クライアントがモデルを呼び出すために使用するキー。


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