メインコンテンツへスキップ
サーバーが呼び出しをどう認証するかの説明です。ブラウザでのサインインと、ブラウザがない環境で使う API キーを扱います。

API キーで接続する

ブラウザを開けない環境があります。サーバー、定期的に動くジョブ、固定のヘッダーしか設定できないクライアントなどです。その場合は、API キーで接続します。アカウント設定 > API キーで作成して(CLI のページの「API キー」を参照)、サーバー URL への呼び出しごとに、Authorization ヘッダーで送ります。
exp_pat_… は、作成したキーに置き換えます。 キーは環境変数に入れて、クライアントにそこから読ませます。EXPLORATORY_API_KEY は、秘密情報を管理する仕組みで設定します。シェルの設定ファイルではなく、OS の資格情報の保管庫や CI のシークレットなどを使います。キーそのものをコマンドラインや設定ファイルに書かないでください。シェルの履歴やファイルに残ります。以下は、この環境変数が設定済みであることを前提にします。たとえば、固定のヘッダーを設定できる Claude Code では、.mcp.json から環境変数を参照します。
ほかのクライアントは、Codex、Cursor、そのほかのアプリの手順を参照してください。
  • キーで読めるのは、ブラウザでのサインインと同じ、あなたが見られる内容です。読み取りのみ(content:read)です。作成できるのは Author だけです。
  • キーが失敗したときは、サーバーが理由つきの 401 または 403 を返します。代わりにブラウザでのサインイン(OAuth)に切り替わることはありません。キーを直してください。
  • ブラウザでのサインインが使えるときは、そちらを使います。キーは、同意の画面、SSO、MFA を通らないので、パスワードと同じように扱ってください。
オンプレミス環境や Hosted 環境では、管理者が、API キーをオフにしたり、使える IP アドレスを限定したりできます。上の 403 の 2 つのメッセージが、その場合です。データと権限の、公開した人の設定は、キーにも同じように効きます。
  • API キー - キーの作成、有効期限、取り消し、安全な扱い方です。

通信と認証

人がブラウザで使うときは、ブラウザでのサインインを使います。ブラウザがないとき、または自動で実行するときは、API キーを使います。 すべての呼び出しに、Authorization: Bearer <アクセストークンまたは API キー> が必要です。ブラウザのセッションの Cookie では、MCP の呼び出しを認証できません。同意画面、メタデータの URL、失敗した呼び出しの詳細は、データと権限 にあります。