Managed Agents자체 호스팅 Managed Agents

서버에서 콘솔 사용하기

Copy page



자체 호스팅 Claude Managed Agents 서버에서 콘솔 로그인을 설정한 다음, 브라우저에서 에이전트를 만들고 세션을 실행하세요.

서버의 콘솔은 자체 호스팅 Claude Managed Agents 서버가 API와 동일한 주소에서 제공하는 웹페이지입니다. 콘솔에서는 SDK나 CLI 없이 에이전트를 만들고, 세션을 실행하고, 환경, 자격 증명 볼트, 메모리 저장소, 스킬을 관리할 수 있습니다.

platform.claude.com에 있는 Claude Console은 아닙니다. 콘솔에는 서버에 있는 내용만 표시됩니다.

로그인 설정하기

관리자가 로그인을 한 번 설정합니다. 대신 한 대의 머신에서 콘솔을 사용해 보려면 릴리스의 모의 로그인 공급자를 사용하는 서버에서 콘솔 사용해 보기를 따르세요.

1. 1

   싱글 사인온과 터미널 로그인 설정하기

   싱글 사인온을 따르세요. 여기에는 개발자가 터미널에서 로그인하도록 허용도 포함됩니다. 콘솔은 터미널 로그인용으로 등록한 애플리케이션을 통해 사용자를 로그인시킵니다. 콘솔은 각 토큰을 발급자 항목에 있는 audiences의 첫 번째 항목과 대조하여 확인하므로, 해당 애플리케이션의 audience를 맨 앞에 나열하세요.

2. 2

   HTTPS로 콘솔 제공하기

   포트 8400 앞에 TLS를 종료하는 프록시를 두세요. 서버 앞에 TLS 배치하기에 프록시가 수행해야 하는 작업이 나열되어 있습니다. 일반 HTTP에서는 localhost 또는 127.0.0.1에서만 로그인이 작동합니다.

3. 3

   애플리케이션에 콘솔 주소 추가하기

   ID 공급자에서 서버의 HTTPS 주소를 끝에 슬래시를 붙여 해당 애플리케이션의 두 번째 리디렉션 URI로 추가하세요: https://cma.example.com/. 또한 교차 출처(CORS) 요청에 대해 해당 출처인 https://cma.example.com을 허용하세요.

설정을 확인하려면 콘솔을 열고 로그인하세요.

콘솔 열기

애플리케이션이 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의 데이터 및 액세스: 서버와 콘솔에 누가 접근할 수 있는지 확인하세요.