AWR은 여러 사람 — 과 그들이 함께 일하는 에이전트 — 이 하나의 공유 프로젝트에서 조율할 수 있게 합니다: 모두가 같은 태스크를 보고, 자신이 하는 작업을 클레임하고, 진행하면서 진행 상황을 보고하고, 완성된 작업을 독립적인 리뷰어에게 넘깁니다. 이 모든 것을 평소의 에이전트 대화에서 수행하며, 브라우저에서 태스크 ID를 복사해 다닐 필요가 없습니다.
가용성: 이 문서는 아직 개발 중인 Team 서비스를 설명합니다. 공개된 0.5.0 personal MCP 서버의 일부가 아닙니다. 아래의 기능들은 프로젝트 관리자가 호스팅하는 팀 프로젝트에 적용되며, 개인 로컬 설정에는 적용되지 않습니다.
근본 아이디어(작업 항목, 계약, 증적, 세션)는 먼저 개념을 읽으세요. 단일 사용자의 일상 루프는 일상 워크플로를 참조하세요.
한눈에 보는 협업 모델
네 가지 아이디어가 전체 모델을 떠받칩니다:
- 워크스트림과 공유 작업. 원격 프로젝트가 공유 작업의 권위 있는 원본입니다 — 태스크, 의존성, 진행 상황, 결과가 존재하는 유일한 장소. 로컬 체크아웃은 코드와 테스트만을 위한 것입니다; 원격 프로젝트를 대체할 두 번째 로컬 태스크 레저를 초기화하지 마세요.
- 클레임. 에이전트가 실행 작업을 시작하기 전에, 자신의 세션 아래에서 태스크에 대한 라이브 클레임을 획득합니다. 다른 사람의 라이브 클레임은 대체되어서는 안 되므로, 두 에이전트가 몰래 같은 것을 작업할 수 없습니다.
- 리뷰. 딜리버리와 인수는 별개의 사실입니다. 인가된 독립적인 사람이 제출된 작업을 인수되기 전에 리뷰합니다. 여러분에게 속한 두 번째 에이전트는 독립적인 리뷰어가 아닙니다.
- 핸드오프. 세션은 영구적입니다: MCP 재연결에서 살아남고, 체크포인트와 복구 상태를 담고 있으며, 컨텍스트 손실 없이 다시 이어받을 수 있습니다 — 휴식 후의 여러분에 의해서든, 팀원의 검사에 의해서든.
한 번만 연결
프로젝트 관리자에게 프로젝트 MCP URL과 개인 자격 증명을 요청하세요. 모든 참가자는 자신의 자격 증명을 사용하며, 리포지터리 권한은 AWR 권한과 분리되어 유지됩니다 — AWR 프로젝트에 참여한다고 Git 접근이 부여되지 않고, 그 반대도 마찬가지입니다.
내부적으로는 인가된 관리자가 Inspector에서 Members를 열고, 여러분을 추가하고, 프로젝트 역할과 워크스트림을 선택하고, 엔드포인트와 자격 증명이 담긴 일회성 개인 연결 지시를 복사합니다. 여러분은 비공개 채널로 이것을 받습니다. 관리자는 발급 패널을 지운 후에는 평문을 복구할 수 없습니다; 자격 증명을 잃어버리면 명시적으로 교체할 수 있습니다.
Streamable HTTP와 Bearer 인증으로 원격 MCP를 지원하는 어떤 에이전트 클라이언트에서든 원격 MCP 서버를 추가합니다:
| 설정 | 값 |
|---|---|
| 전송 방식 | Streamable HTTP |
| 서버 URL | 프로젝트 엔드포인트, 예: https://team.example/v1/projects/example/mcp |
| 인증 | HTTP Authorization 헤더의 Bearer 토큰 |
| 자격 증명 | 관리자가 제공한 개인 자격 증명 |
이것들은 구성 파일 형식이나 셸 명령이 아니라 연결 설정입니다; 각 클라이언트는 자체 설정과 버전 요구 사항이 있습니다. 클라이언트가 로컬 stdio MCP만 지원한다면 이 URL을 직접 사용할 수 없습니다 — 원격 전송을 지원하는 클라이언트 버전이나 통합을 사용하세요.
자격 증명에 대한 몇 가지 안전 규칙:
- 클라이언트가 지원하는 시크릿 설정이나 신뢰할 수 있는 비공개 에이전트 입력을 사용하세요.
- 자격 증명을 URL, 공유 대화, 리포지터리에 절대 넣지 마세요.
- 구성 변경 후 재연결한 다음, 에이전트에서 로컬 코드 체크아웃을 여세요.
에이전트에게 결과물 알려주기
개발에 사용하는 것과 같은 대화에서 작업합니다. 결과물을 기술하고 에이전트가 조율하게 하세요, 예를 들어:
연결된 AWR Team 프로젝트를 사용해 issue API를 구현해 주세요. 현재 태스크를 새로 고치고 기존 작업을 재개하거나, 이 요청에 맞는 적격 태스크를 클레임해 주세요. 편집 전에 계약, 의존성, 최신 체크포인트를 읽어 주세요. 진행 상황과 증적은 AWR에 유지하고, 테스트된 변경을 PR로 제출하고, 독립 리뷰를 요청해 주세요.
에이전트는 공유 작업을 읽고, 적격 태스크를 클레임하고, 로컬에서 개발하는 동안 프로젝트를 최신으로 유지합니다. 실제 권한, 의존성, 소유권 충돌에 부딪히면 우회하는 대신 여러분에게 보고합니다.
에이전트가 해주는 일
에이전트는 발견된 두 MCP 도구 — 읽기용 awr_team_query와 쓰기용 awr_team_command — 를 통해 Team 서비스와 통신합니다. 모든 쿼리와 명령은 현재 권한을 재확인하므로, 역할 변경은 아무도 로컬 구성을 편집하지 않고도 적용됩니다.
일반적인 세션은 이렇게 흘러갑니다:
- 시작 또는 재연결. 에이전트는
capabilities를 쿼리해 신원과 권한을 확인한 다음,work.next로 여러분의 세션을 재개하거나 보이는 미완료 작업을 발견하며, 반환된next_query를 따릅니다. (work.next가 없는 오래된 서버에서는workstreams.list와 범위 지정된work.list/work.search로 폴백합니다.) - 준비. 선택된 태스크에 대해
work.prepare는 현재 계약, 필수 명세, 의존성, 복구 상태, 컨텍스트 해시를 반환합니다 — 에이전트가 편집 전에 실제로 소비해야 하는 하나의 스냅샷.work.prepare와work.observe는 짧은guidance항목 하나(조건, 사실 근거, 다음 액션, 재평가 트리거)를 반환할 수도 있습니다; 이것은 실행 권한이 아니라 조언입니다. - 클레임. 에이전트는
claim.inspect로 기존 클레임을 검사한 다음, 자신의 세션 아래에서 라이브 클레임을 획득하거나 갱신합니다. - 실행.
execution.prepare와execution_authorized=true를 담은 새execution.start응답으로, 에이전트는 선언된 범위 내에서 한 번의 실행을 수행할 수 있습니다. 여러분의 머신이 코드와 도구를 실행합니다 — 서비스는 절대 아무것도 직접 실행하지 않습니다. 클레임만으로는 실행 승인이 아닙니다. - 진행 상황 보고. 에이전트는 소비된 컨텍스트 해시, 다음 액션, 열린 루프, 짧은
progress요약을 담아session.checkpoint를 보냅니다 — 단계나 테스트가 완료되거나, 블로커가 변경되거나, 여러분의 입력이 필요하거나, 딜리버리가 준비되었을 때 배치로 업데이트하며, 매 도구 호출마다 하지 않습니다. 체크포인트 요약은 인가된 작업 읽기자와 공유된다는 점을 기억하세요 — 민감한 원시 로그는 여기에 속하지 않습니다. - 완료 또는 중단.
execution.report는 버전에 바인딩된 증적과 함께 종료 결과를 기록합니다. 클레임은 활성 작업과 알 수 없는 결과가 정리된 후에만 해제되고 세션은 종료됩니다.
리뷰와 인수
작업이 준비되면 에이전트는 delivery.submit_and_request_review 또는 review.open을 통해 증적을 제출하고 리뷰를 요청합니다. 인가된 독립적인 사람이 딜리버리를 리뷰하고, 인가된 최종 확정은 프로젝트의 인수 정책을 따릅니다.
이것들을 별개의 사실로 유지하세요: 구현, 검증, GitHub 머지, AWR 인수. PR을 머지하는 것은 AWR이 태스크를 인수하는 것과 다르며, 여러분 자신의 두 번째 에이전트는 독립적인 리뷰어로 계산되지 않습니다.
핸드오프와 복구
핸드오프가 작동하는 이유는 세션과 체크포인트가 한 사람의 채팅 이력이 아니라 공유 프로젝트에 존재하기 때문입니다:
- MCP를 재연결해도 영구 작업 세션이 종료되거나 리스가 갱신되지 않습니다.
- 복구 상태와 등록된 딜리버리는 오래된 체크포인트 지시보다 우선하므로, 돌아온 에이전트는 실제로 일어난 일을 신뢰합니다.
- 쓰기가 타임아웃되면, 에이전트는 정확히 재시도하기 전에 원래 명령 결과를 검사합니다; 재생된 영수증은 역사적 사실이지 효과를 다시 실행할 권한이 아닙니다.
- 실행 효과를 알 수 없는 경우(태스크 중간 중단), 검사와 인가된 조정이 필요합니다. 새 세션을 만드는 것은 그 요구 사항을 우회하지 않습니다.
알아둘 두 가지 실용적 한계: AWR은 유휴 에이전트를 깨울 수 없습니다(리스 갱신은 체크포인트와 별개로 호스트의 스케줄링을 사용), 그리고 차단되거나 대기 중인 단계는 보고일 뿐입니다 — 그 자체로 대기 항목을 만들거나 클레임을 갱신하지 않습니다.
Inspector: 선택적 워크스페이스 뷰
Inspector는 같은 프로젝트 위의 웹 뷰입니다. 웹사이트를 통한 로그인이나 클레임은 위의 어떤 것에도 전제 조건이 아닙니다 — 에이전트가 조율 표면으로 남습니다. 다음을 원할 때 Inspector를 사용하세요:
- 태스크 관계, 소유권, 진행 상황, 기록된 결과 검사.
- Connect Agent에서 클라이언트 중립적인 MCP 설정과 프로젝트 지시, 또는 태스크별 브리프 복사(텍스트 복사는 세션이나 클레임을 만들지 않음).
- 관리자로서 Members에서 멤버와 프로젝트 범위 자격 증명 관리.
- Activity 리뷰 — 인증된 접근 기록과 커밋된 개발 이력을 구분합니다. 일반 멤버는 자신의 인가된 활동을 보고, 프로젝트 감사자는 멤버나 태스크로 필터링할 수 있습니다. 감사 기록은 자격 증명 값, 대화, 임의의 도구 입력/출력을 제외하고, 요청 메타데이터는 제한된 보존 기간을 가집니다 — 영구적인 컴플라이언스 아카이브가 아닙니다.
관리자 및 리뷰 권한은 어떤 클라이언트를 사용하든 중앙 서비스에 의해 적용되므로, 누군가 에이전트, Inspector 또는 둘 다를 통해 작업하든 규칙은 유지됩니다.