Managed Agentsセルフホスト型Managed Agents

サーバー上でコンソールを使用する

Copy page



セルフホスト型Claude Managed Agentsサーバー上のコンソールのサインインを設定し、ブラウザでエージェントを作成してセッションを実行します。

サーバー上のコンソールは、セルフホスト型Claude Managed Agentsサーバーが、そのAPIと同じアドレスで提供するウェブページです。コンソールでは、SDKやCLIを使わずに、エージェントの作成、セッションの実行、環境、認証情報ボールト、メモリストア、スキルの管理を行えます。

platform.claude.comにあるClaude Consoleではありません。表示されるのは、あなたのサーバー上にあるものだけです。

サインインを設定する

サインインの設定は、管理者が一度だけ行います。代わりに1台のマシンでコンソールを試すには、リリースのモックサインインプロバイダーを使用するサーバー上でコンソールを試すの手順に従ってください。

1. 1

   シングルサインオンとターミナルログインを設定する

   シングルサインオンの手順に従ってください。開発者がターミナルからログインできるようにするも含まれます。コンソールは、ターミナルログイン用に登録したアプリケーションを通じてユーザーをサインインさせます。コンソールは各トークンを発行者エントリのaudiencesの最初のエントリと照合するため、そのアプリケーションのオーディエンスを最初に記載してください。

2. 2

   HTTPS経由でコンソールを提供する

   ポート8400の前段に、TLSを終端するプロキシを配置します。プロキシが行う必要のある処理は、サーバーの前段にTLSを配置するに記載されています。プレーンなHTTP経由では、サインインはlocalhostまたは127.0.0.1でのみ機能します。

3. 3

   コンソールのアドレスをアプリケーションに追加する

   IDプロバイダーで、サーバーのHTTPSアドレスを末尾のスラッシュ付きで、そのアプリケーションの2つ目のリダイレクトURIとして追加します: https://cma.example.com/。また、そのオリジンであるhttps://cma.example.comを、オリジン間（CORS）リクエストに対して許可します。

セットアップを確認するには、コンソールを開いてサインインします。

コンソールを開く

アプリケーションがhttps://cma.example.comを呼び出している場合は、ブラウザでhttps://cma.example.com/を開き、Continue with SSOをクリックします。

サインインはIDプロバイダーを通じて行います。コンソールはサーバーのAPIキーを受け付けません。このサーバーではログインが設定されていないとコンソールに表示された場合は、管理者がサインインを設定する必要があります。

コンソールからエージェントを実行する

空のエージェントのbashなどの組み込みツールはワーカー上で実行されるため、ワーカーがポーリングしている環境を選択してください。ワーカーとは何かについては、何がどこで実行されるかで説明しています。ワーカーがない場合、最初のツール呼び出しは、ワーカーがそれを実行するまで待機します。環境は管理者が作成し、管理者は環境のWorkersタブでその環境のワーカーを確認できます。

1. 1

   エージェントを作成する

   サイドバーでAgentsを選択し、Create agentをクリックします。Blank agentなどの開始点を選択し、名前を入力します。

   Create agentをクリックします。エージェントのページが開きます。

2. 2

   セッションを開始する

   エージェントのページでStart sessionをクリックします。環境を選択し、Create sessionをクリックします。セッションのページが開きます。

3. 3

   メッセージを送信する

   ページ下部のボックスにメッセージを入力して送信します。エージェントの作業に合わせてページが更新されます。ツール呼び出しがあなたの操作を待つ場合、そのカードにはApproveとDenyが表示されます。

ツール呼び出しがあなたの操作を待っている間、セッションのバッジにはIdleと表示されます。

アプリケーションがAPI経由で開始したセッションなど、他のセッションを開くには、サイドバーでSessionsを選択し、そのセッションを選択します。

誰が何を見られるか

コンソールに表示される内容は、APIと同様にロールによって決まります:

• 管理者は、サーバー上のすべてを表示および変更できます。
• developerまたはuserロールを持つユーザーは、すべての環境を表示できます。エージェント、セッション、ボールト、メモリストア、スキルについては、自分のサインインで作成したものだけを表示できます。

クイックスタートのものなど、サーバーのAPIキーで作成されたエージェントやセッションは、管理者にのみ表示されます。完全な表については、各ロールでできることを参照してください。

コンソールをオフにする

サーバーはデフォルトでコンソールを提供します。オフにするには、設定ファイルでconsole.serve: falseを設定し、サーバーを再起動します。これにより、サーバーはコンソールの提供を停止します。エージェントとセッションは引き続きAPI経由で動作します。

次のステップ

• セルフホスト型サーバーでAPIを呼び出す: 同じ作業をコードやant CLIから行います。
• セルフホスト型Claude Managed Agentsにおけるデータとアクセス: サーバーとそのコンソールに誰がアクセスできるかを確認します。