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

# 自動処理

人がブラウザでサインインしなくても、API キーを使って、スクリプトや CI で expl server を実行します。

## API キーを作る

CI は、変更のたびに自動で処理を流す仕組みです。人がブラウザでサインインできないので、API キーを渡します。作り方は、[API キー](https://docs.exploratory.io/ja/cli/server/token.md#create)のページにあります。

作ったキーは、CI のシークレット（値を隠して保管する機能）に登録します。スクリプトには書かず、画面やログにも出さないでください。キーには有効期限があります。それまでに新しいキーを作って、シークレットを入れ替えます。

キーの作り方と安全な扱い方は、[API キー](https://docs.exploratory.io/ja/cli/server/token.md)を参照してください。

## キーを渡す

キーは、環境変数 EXPL\_SERVER\_TOKEN で渡します。保存したログイン情報との順は、[サインイン](https://docs.exploratory.io/ja/cli/server/login.md#apikey)を参照してください。接続先を変えるときは、EXPL\_SERVER\_URL を設定します。

## 実行例: GitHub Actions

GitHub Actions の例です。\<id> は、読みたいコンテンツの id に置き換えます。\<version> は、使うバージョン番号に置き換え、必ず固定します。

```text theme={null}
- uses: actions/setup-node@v4
  with:
    node-version: 22
- run: npx -y @exploratory/cli@<version> server fetch <id> --json
  env:
    EXPL_SERVER_TOKEN: ${{ secrets.EXPL_SERVER_TOKEN }}
    EXPL_SERVER_URL: https://exploratory.io
```

## 終了コード

スクリプトでは、終了コードによって成功か失敗かを判断できます。CI で特に多いのは、次の 2 つです。

| コード | 意味 | 対処 |
| - | - | - |
| 3 | サーバーに接続できません（ネットワーク、HTML のエラーページなど） | 通信を確認して、もう一度実行します。 |
| 4 | サインインしていないか、API キーが拒否されました | キーが正しいか、期限切れや取り消しになっていないかを確認します。 |

すべての終了コードは、[終了コードとエラー](https://docs.exploratory.io/ja/cli/server/exit-codes.md)で説明しています。

## API キーを取り消す

漏れたキーや使わなくなったキーは、[API キー](https://docs.exploratory.io/ja/cli/server/token.md#revoke)の手順で取り消します。

取り消した、または期限切れのキーでの呼び出しは、終了コード 4 で終了します。


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