Remote Hosts (Bash)
경로: 하단 툴바 Remote Hosts 원격 호스트(서버·워크스테이션)에 Bash 세션을 WebSocket 으로 연결 하여 Agent Chat 안에서 명령을 실행·관찰합니다. 에이전트가 직접 원격 명령을 실행하거나, 사용자가 수동 터미널로 사용할 수 있습니다.
UI 구성
| 영역 | 설명 |
|---|---|
| 서버 이름 | 등록된 MCP 서버 이름 (예: my-bash-server) |
| 연결 명령 | npx seahorse-bash-client connect --url wss://... 형태의 커맨드 (복사 가능) |
| Token 입력 | 인증 토큰 (선택) — 입력 시 파일 전송 활성 |
| nohup 토글 | Run on the target host — 세션 종료 후에도 명령 유지 |
| Connected Hosts | 현재 연결된 호스트 목록 |
| 빈 상태 | No hosts connected / Use the connection command to connect a bash client + Select a host to open terminal |
연결 흐름
MCP 서버 지정
my-bash-server 같은 서버 이름 선택 — 에이전트의 Tool Management 에 등록된 원격 Bash MCP 도구.클라이언트 실행
npx seahorse-bash-client connect --url wss://{agent-id}.agent.seahorse.dnotitia.ai/ws/remote-mcp/{server-name}위 명령을 원격 호스트 터미널 에서 실행 → 호스트가 Agent Chat 과 WebSocket 으로 연결됩니다.Token 옵션
| 상태 | 가능한 작업 |
|---|---|
| 토큰 없음 | Bash 명령 실행만 |
| 토큰 있음 | + 파일 전송 (업로드/다운로드) |
nohup 토글
Run on the target host — ON 시 명령을 nohup 으로 실행해 WebSocket 연결이 끊겨도 호스트에서 백그라운드로 계속 실행 됩니다.
활용 예:
- 장시간 빌드 / 학습 스크립트 실행
- 원격에서 모니터링 프로세스 기동
- 일회성 배포 후 연결 종료
보안 주의
활용 예시
| 시나리오 | 용도 | |
|---|---|---|
| 로그 분석 | `grep ERROR /var/log/app.log | tail -50` → 에이전트가 원인 요약 |
| 빠른 서버 점검 | df -h · top -bn1 · systemctl status {svc} | |
| CI/CD 보조 | 빌드 로그 실시간 확인, 간단한 배포 스크립트 트리거 | |
| 데이터 전처리 | 로컬 CSV 변환 후 scp 로 서버 업로드 (토큰 있을 때) | |
| 원격 디버깅 | 에이전트가 로그를 읽고 수정안 제시 → 사용자 검토 후 수동 적용 |
관련 문서
- MCP Tools — Remote Bash MCP 서버 등록
- Tool Management — 도구 전역 관리
- Temp Files — 원격에서 받은 파일의 임시 저장 공간
- Storage — 원격에서 받은 산출물의 영구 보관