# Computer Control API
SUMMARY: 등록된 컴퓨터의 원격 제어 — 명령 큐잉, 스크린샷 캡처, 원격 머신에서 스크립트 실행.

KEY CONTEXT:
Two sides: user-facing (Mind Key/JWT) and agent-facing (Computer Token)
Register agent: POST /computers/register { install_code } → returns computer_token
List: GET /computers/list (Mind Key or JWT)
Queue command: POST /computers/:id/commands { type, payload }
Command types: screenshot, click, move, type, key, scroll, drag
Agent poll: GET /computers/me/poll?wait=5 (Computer Token)
Agent result: POST /computers/me/commands/:cid/result (Computer Token)
One-shot screenshot: GET /computers/:id/screenshot (waits 30s for result)
Pattern: register agent on remote machine → user queues commands → agent polls and executes

Computer Control API
Computer Control API를 사용하면 등록된 컴퓨터를 원격으로 제어할 수 있습니다.
대상 머신에서 소형 에이전트()가 실행되어 명령을
폴링하고, 실행하고, 결과를 다시 게시합니다. 이를 통해 LLM 기반 GUI
자동화가 가능해집니다.
아키텍처
[CODE BLOCK]
사용자 측 엔드포인트 (Mind Key 또는 JWT)
GET /computers/list
등록된 모든 컴퓨터를 나열합니다.
[CODE BLOCK]
GET /computers/:id
단일 컴퓨터의 상세 정보를 가져옵니다.
[CODE BLOCK]
POST /computers/install-code
새 컴퓨터 등록용 설치 코드를 생성합니다.
[CODE BLOCK]
응답: 
POST /computers/:id/commands
원격 에이전트가 실행할 명령을 큐에 추가합니다.
[CODE BLOCK]
응답: 
GET /computers/:id/command (쿼리 경유)
GET 요청으로 명령을 큐에 추가합니다 (단순한 경우용).
[CODE BLOCK]
GET /computers/:id/commands
컴퓨터의 최근 명령을 나열합니다.
[CODE BLOCK]
GET /computers/:id/commands/:cid
특정 명령의 상태 및 결과를 가져옵니다.
[CODE BLOCK]
GET /computers/:id/screenshot
원샷: 스크린샷 명령을 큐에 추가하고 최대 30초 동안 결과를 기다립니다.
[CODE BLOCK]
POST /computers/:id/disable
컴퓨터를 비활성화합니다 (토큰을 취소하고, 감사를 위해 기록은 유지).
[CODE BLOCK]
DELETE /computers/:id
컴퓨터를 영구적으로 삭제합니다.
[CODE BLOCK]
에이전트 측 엔드포인트 (Computer Token)
이 엔드포인트들은 대상 머신에서 실행되는 가
사용합니다. Mind Key가 아닌 Computer Token(가 반환)을
사용합니다.
POST /computers/register
설치 코드를 상환하고 Computer Token을 받습니다.
[CODE BLOCK]
응답: 
> [!CRITICAL]
> 을 저장하십시오 — 한 번만 표시되며 모든 에이전트 측
> 엔드포인트에 필요합니다.
GET /computers/me/poll
새 명령을 롱 폴링합니다. 에이전트는 이것을 루프에서 호출합니다.
[CODE BLOCK]
대기 중인 명령이 있으면 즉시 반환되거나, 없으면 초 후에 반환됩니다.
POST /computers/me/commands/:cid/result
명령 실행 결과를 게시합니다.
[CODE BLOCK]
명령 유형
| 유형 | 페이로드 | 설명 |
|------|---------|-------------|
|  |  | 화면을 PNG로 캡처 (base64) |
|  |  | 좌표 클릭 |
|  |  | 좌표로 마우스 이동 |
|  |  | 커서 위치에 텍스트 입력 |
|  |  | 키 조합 누름 |
|  |  | 스크롤 휠 |
|  |  | 드래그 앤 드롭 |
일반적인 패턴: LLM 기반 GUI 자동화
[CODE BLOCK]
다음 단계
- Browser Proxy — 브라우저 자동화용 별도 서비스
- Self-Hosted Agents Guide