SSH 연결을 저장하고,
원격 머신에서 AI 에이전트를 실행하세요

AI 에이전트가 내 SSH 연결에 어떻게 접근하나요?

AgentsRoom MCP를 통해서입니다. 저장한 연결은 다섯 가지 MCP 도구로 모든 에이전트에 노출됩니다. ssh_list는 현재 프로젝트에서 사용할 수 있는 서버(SSH, AWS SSM, WinRM 모두)를 반환하고, ssh_exec는 서버에서 명령 하나를 실행해 출력을 돌려주며(WinRM 호스트에서는 PowerShell 한 줄이고, 쓰기를 허용하지 않는 한 읽기 전용이며 쓰기는 선택에 따라 하나씩 확인하거나, 위험할 때만 확인하거나, 확인하지 않습니다), ssh_transfer는 파일 하나를 서버와 주고받고, ssh_connect는 그중 하나를 실제 터미널 탭으로 열고, ssh_connection_new는 아직 저장하지 않은 서버를 제안합니다. 그래서 에이전트에게 "프로덕션에 접속해서 로그를 읽어"나 "Exchange 송신 커넥터를 나열해"라고 말하면, 호스트명을 추측하거나 명령을 손으로 쓸 필요 없이 연결 목록을 읽고 올바른 머신에서 작업합니다.

이 SSH 접근은 의도적으로 비밀 정보를 포함하지 않습니다. ssh_list는 메타데이터만 반환합니다: 이름, 호스트, 포트, 사용자, 인증 방식, 범위. 비밀번호와 패스프레이즈는 OS 키체인에 암호화된 채로 남고, 개인 키는 디스크에 남으며, 비밀은 앱이 직접 터미널에 주입합니다. 에이전트는 연결을 지목할 뿐, 비밀을 다루지 않습니다.

에이전트가 ssh_connect로 여는 세션은 눈에 보이는 터미널 탭입니다. 읽고, 입력하고, 언제든 닫을 수 있습니다. 그리고 ssh_exec로 실행한 명령은 종료 코드와 함께 대화 안으로 돌아오므로, 무엇이 실행됐고 머신이 무엇을 답했는지 항상 볼 수 있습니다. 파일도 같은 방식으로 오갑니다. ssh_transfer를 쓰면 에이전트가 서버에서 덤프나 로그를 가져오거나 파일을 서버로 보낼 수 있는데, 같은 자격 증명 없는 채널을 거치며 파일이 대화에 붙여넣어지는 대신 내 컴퓨터의 경로가 돌아옵니다. 연결은 한 프로젝트 전용으로도 전역으로도 저장할 수 있어 에이전트는 관련 있는 서버만 봅니다. WatchGuard 방화벽이나 많은 스위치, 라우터처럼 열린 세션 안에서만 명령줄이 동작하는 네트워크 장비도 지원합니다. ssh_exec가 세션을 열고 장비의 프롬프트를 기다린 뒤 명령을 하나씩 입력합니다.

에이전트가 서버에서 작업하는 동안 그 과정을 실시간으로 지켜볼 수 있습니다. ssh_exec로 실행하는 모든 명령은 출력과 함께 오른쪽 패널의 “활동” 탭에 흘러가며, 서버마다 하나의 기록으로 정리됩니다. 에이전트의 아바타가 “서버” 버튼에 표시되고, 서버 목록에도 “에이전트 작업 중” 배지와 함께 표시됩니다. 인코딩되어 전송된 명령은 디코딩되어 표시됩니다. 모바일 앱의 에이전트 카드에서 휴대폰으로도 따라볼 수 있습니다. 이 기록은 내 컴퓨터와 휴대폰 사이에서만 오가며, 종단 간 암호화되고 시크릿은 가려집니다. 내 머신에서 실행된 내용은 어떤 서버에도 저장되지 않습니다.

만드는 일을 에이전트에게 전적으로 맡길 수도 있습니다. ssh_connection_new는 검토를 거치는 경로를 유지합니다. 에이전트가 compose 파일이나 배포 스크립트, 문서에서 찾아낸 내용으로 생성 폼을 미리 채워 열고, 그것을 검토하고 자격 증명을 입력하고 저장하는 것은 사용자입니다. 설정의 “에이전트가 연결을 관리할 수 있음”(기본값 켜짐)을 끄지 않는 한 ssh_connection_save는 연결을 곧바로 기록하며, 그때도 자격 증명은 대화를 오가지 않습니다. 에이전트는 보관소의 시크릿을 이름으로만 말하고 데스크톱이 값을 복사합니다. 끄는 스위치는 프롬프트로 부탁하는 방식이 아니라 설정 자체에 새겨져 있습니다. 에이전트가 아무도 모르게 등록할 수 있는 연결은 백도어가 될 테니까요.