AgentOS Admin

사용자 · 도구 관리

사용자 추가

에이전트 설정은 두 단계입니다. ① 사용권한 — 이 사용자가 쓸 수 있는 에이전트를 정합니다. alfred·mc·envoy 는 모든 사용자에게 기본으로 주어집니다. ② main 배치 — 사용권한이 있는 에이전트 중 이 사용자의 main 방에 앉힐 직무를 고릅니다. 음영 은 배치한 직무가 toml 연동으로 함께 데려오는 직무입니다 (자동으로 따라오며, 직접 배치한 것은 아닙니다).

사용자 목록

username	uid	상태	agents

관리자 비밀번호 변경

아웃바운드 연동 (우리가 클라이언트) — 외부 SaaS 를 향한 자격 — 사용자 위임 준비(템플릿)와 도구 운영 키

사용자 서비스 템플릿 (site-presets)

사용자 Settings 의 "+ 서비스 등록" 폼에 뜨는 템플릿. OAuth 서비스는 준비(디스커버리+앱등록) 버튼이 상대 서버의 .well-known 을 실측해 endpoint 를 채우고, 동적 등록(RFC 7591) 지원 시 client_id 까지 자동 발급합니다 (redirect 는 이 배포의 공개 URL — 배포 환경당 1회).

id	표시	방식	client_id

+ 템플릿 등록

ai_op 자격증명 (site-providers — 도구 운영 키)

web 검색 (serp) 같은 조직/도구 운영 키 의 자리. secret 값 은 표시 하지 않음 (존재 여부 만). key 는 plain 보다 key_env (agentos.env 의 변수 명 참조) 권장.

id	type	api_base	secret	주입 방식

+ provider 추가/수정

bearer

에이전트 도구 (MCP) — 에이전트가 mcp_mode 로 소비하는 외부 도구 서버

MCP 카탈로그 (admin 허용 목록)

여기 등록 된 서버 만 사용자 에게 허용 가능. stdio + org provider 조합 은 등록 시 거부 (credential 유출 차단).

name	transport	command / url	auth

+ 서버 등록 (raw TOML)

사용자별 MCP 허용

체크 = 사용자 자리 에 toml 배포 (허용, {home}/{user} 치환). 해제 = 회수. custom = 카탈로그 밖 toml — runtime 차단 됨 (mcp_store 필터), ✕ 로 파일 정리.

username	허용 서버

인바운드 연동 (우리가 서버) — 외부 앱이 우리 사용자의 위임을 받아가는 현관 — Claude 커넥터 등

OAuth 앱 등록부 (인바운드 — 외부 앱의 사용자 위임)

등록된 앱만 사용자에게 동의(/oauth/authorize)를 요청할 수 있습니다. secret 은 등록 응답에 1회만 표시 (서버는 hash 보관). redirect URI 는 정확 일치 검증. 1st-party (Slack 브리지 등)는 배포 seed 소관 — 여기서 삭제 불가.

client_id	name	redirect_uris	scopes

+ 앱 등록

chat approvals public (PKCE — secret 없음, Claude 커넥터 등)

AgentOS Admin

임시 — 개발 편의 (접속처·서버 정보 — config_URL 파생)

사용자 안내문 (복사해서 그대로 전달)

Approval ledger stats (월별 무손실 아카이브 — map/<user>/approvals/)

에이전트 인스펙터

커널 mode 레지스트리