サインインする
人がブラウザを使える環境で expl を使うときは、ブラウザでサインインします。ブラウザがないとき、またはスクリプトや CI で自動実行するときは、API キーを使います。「Logged in to exploratory.io as …」と表示されていれば、サインインは完了しています。
API キーでサインインする
API キーを使うと、ブラウザなしでサインインできます。アカウント設定 > API キーで作成して(API キーを参照)、次のコマンドを実行します。--with-token は --no-browser と一緒には使えません。接続先を選ぶときは、--url を付けます。
キーは、ブラウザでのサインインと同じ場所に保存されます(「保存先と使われ方」を参照)。保存した API キーは更新されず、ブラウザも開きません。もう一度サインインすると、置き換わります。
保存する代わりに、環境変数 EXPL_SERVER_TOKEN に設定することもできます。保存したログイン情報より先に使われます。
環境変数のキーから保存したログイン情報に切り替えるときは、先に unset EXPL_SERVER_TOKEN を実行してください。設定されている間は、保存したログイン情報より先に使われます。
ブラウザを開けない環境で
リモートのサーバーなど、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 日)。
- サーバーのログ: 操作の呼び出しごとの記録(メールアドレス、クライアント、結果、行数、処理時間)と、トークンの作成・削除。
- 失敗した呼び出しのエラー: 時刻、呼び出した操作、エラーの内容を、製品の改善のために収集します。
