メインコンテンツへスキップ
ブラウザで、または API キー(ブラウザなしで、あなたとして Exploratory を読むための文字列)でサインインして、ログイン情報をこのコンピューターに保存します。状態の確認とサインアウトも、ここで行います。

サインインする

人がブラウザを使える環境で expl を使うときは、ブラウザでサインインします。ブラウザがないとき、またはスクリプトや CI で自動実行するときは、API キーを使います。
ブラウザが開きます。Exploratory にサインインして、アクセスを許可してください。対話的でないターミナルでは、ブラウザを開かずに URL を表示します。
「Logged in to exploratory.io as …」と表示されていれば、サインインは完了しています。
サーバー、ユーザー、サインインの方法を表示します。
保存したログイン情報を削除します。環境変数 EXPL_SERVER_TOKEN で API キーを渡していない場合、次の呼び出しにはサインインが必要です。API キーでサインインしていた場合に消えるのは保存したコピーだけで、キー自体は、取り消すまで使えます。

API キーでサインインする

API キーを使うと、ブラウザなしでサインインできます。アカウント設定 > API キーで作成して(API キーを参照)、次のコマンドを実行します。
ターミナルでは「API key:」と聞かれます。貼り付けたキーは画面に表示されません。パイプでキーを渡すと、標準入力から読み取ります。 実行結果
key-file は、キーだけを書いたファイルです。キーをコマンドラインに書かないでください。 expl はまず、サーバーでキーを確かめます。サーバーが拒否した場合は、何も保存しません。キーは exp_pat_ で始まります。--with-token は --no-browser と一緒には使えません。接続先を選ぶときは、--url を付けます。 キーは、ブラウザでのサインインと同じ場所に保存されます(「保存先と使われ方」を参照)。保存した API キーは更新されず、ブラウザも開きません。もう一度サインインすると、置き換わります。 保存する代わりに、環境変数 EXPL_SERVER_TOKEN に設定することもできます。保存したログイン情報より先に使われます。 環境変数のキーから保存したログイン情報に切り替えるときは、先に unset EXPL_SERVER_TOKEN を実行してください。設定されている間は、保存したログイン情報より先に使われます。
サインインの方法が表示されます。EXPL_SERVER_TOKEN を使っているときは、API key “ci-nightly” from EXPL_SERVER_TOKEN, expires 2026-12-13 のように表示されます。有効期限のないキーは never expires と表示されます。ブラウザでサインインしたときは、login (refresh token saved …, access token valid until …) と表示されます。 実行結果
キーの作り方と安全な扱い方は、API キーを参照してください。

ブラウザを開けない環境で

リモートのサーバーなど、expl がブラウザを開けない環境で使います。

1. URL を開く

コマンドを実行すると、https://exploratory.io/oauth/authorize? で始まる URL が表示され、入力待ちになります。その URL を、ブラウザで開きます。

2. 許可する

Exploratory にサインインして、アクセスを許可します。

3. エラーの画面を確認する

ブラウザは「このサイトにアクセスできません」のような画面に移ります。これで正しい動きです。

4. 移動先の URL をコピーする

そのときのアドレス欄の URL をコピーします。http://127.0.0.1/callback?code= で始まるものです。最初に表示された URL ではありません。

5. 貼り付ける

ターミナルに貼り付けて Enter キーを押します。
「Logged in to … as …」と表示されていれば、サインインは完了しています。
この URL に含まれるコードは、一度しか使用できません。ブラウザがその画面に移ってから 60 秒で無効になるため、すぐに貼り付けてください。失敗した場合は、最初からやり直します。

保存先と使われ方

ログイン情報は、~/.exploratory/expl/server/ に、ホストごとのファイルとして保存されます。権限は 0600(本人だけが読める)です。ブラウザでのログインも、--with-token で保存した API キーも、同じ場所です。Windows では %USERPROFILE%\.exploratory\expl\server\ です。 保存したログイン情報は、同じオリジン(スキーム、ホスト、ポート)でだけ使われます。標準のポートでは、同じホストへ後からサインインすると、保存内容が置き換わります。 ブラウザでのログインをサーバー側で失効させると(「接続中のAIアプリ」など)、次の呼び出しは終了コード 4 で終了し、expl server login の実行を案内します。API キーは、アカウント設定 > API キーで取り消します。

接続先の URL

既定の接続先は https://exploratory.io です。ほかのサーバーを使うときは、--url か、環境変数 EXPL_SERVER_URL で指定します。優先順位は次のとおりです。

サーバーが記録するもの

expl server が呼び出す操作について、Exploratory Server は次のものを記録します。AI ツールが MCP で Exploratory に接続した場合も同様です。
  • トークンと API キー: 平文ではなくハッシュで保存し、作成日時、有効期限、最終使用日時を記録します。ブラウザでのログインのトークンは「接続中のAIアプリ」で、API キーはアカウント設定 > API キーで、確認・失効できます。
  • データアクセスログ: アイテム、ユーザー ID とメールアドレス、経路(cli)、サインインの方法(ブラウザまたは API キー)と API キーの名前、操作、クライアント名、IP アドレス、結果とエラーコード、処理時間。保持期間は既定で 90 日です(サーバーの設定で 1〜400 日)。
  • サーバーのログ: 操作の呼び出しごとの記録(メールアドレス、クライアント、結果、行数、処理時間)と、トークンの作成・削除。
  • 失敗した呼び出しのエラー: 時刻、呼び出した操作、エラーの内容を、製品の改善のために収集します。
同じ内容は、MCP Server のデータと権限のページでも説明しています。

トラブルシューティング