API キーで接続する
ブラウザを開けない環境があります。サーバー、定期的に動くジョブ、固定のヘッダーしか設定できないクライアントなどです。その場合は、API キーで接続します。アカウント設定 > API キーで作成して(CLI のページの「API キー」を参照)、サーバー URL への呼び出しごとに、Authorization ヘッダーで送ります。- キーで読めるのは、ブラウザでのサインインと同じ、あなたが見られる内容です。読み取りのみ(content:read)です。作成できるのは Author だけです。
- キーが失敗したときは、サーバーが理由つきの 401 または 403 を返します。代わりにブラウザでのサインイン(OAuth)に切り替わることはありません。キーを直してください。
- ブラウザでのサインインが使えるときは、そちらを使います。キーは、同意の画面、SSO、MFA を通らないので、パスワードと同じように扱ってください。
オンプレミス環境や Hosted 環境では、管理者が、API キーをオフにしたり、使える IP アドレスを限定したりできます。上の 403 の 2 つのメッセージが、その場合です。データと権限の、公開した人の設定は、キーにも同じように効きます。
- API キー - キーの作成、有効期限、取り消し、安全な扱い方です。
通信と認証
人がブラウザで使うときは、ブラウザでのサインインを使います。ブラウザがないとき、または自動で実行するときは、API キーを使います。
すべての呼び出しに、Authorization: Bearer <アクセストークンまたは API キー> が必要です。ブラウザのセッションの Cookie では、MCP の呼び出しを認証できません。同意画面、メタデータの URL、失敗した呼び出しの詳細は、データと権限 にあります。
