MCP 에이전트

MCP를 사용하면 Codex, Claude Code, 또는 Antigravity CLI가 DR-Terminal 도구를 사용할 수 있습니다. 에이전트는 세션과 저장된 연결을 확인하고, 연결을 열고, 터미널 출력을 읽고, 명령을 입력하고, 파일을 전송하고, 앱을 탐색할 수 있습니다. MCP 모드는 활성 체험 기간 동안과 Pro에서 사용할 수 있습니다.

에이전트에 DR-Terminal 추가

  1. DR-Terminal 제목 표시줄에서 MCP를 클릭합니다.
  2. Add to Codex, Add to Claude, 또는 Add to Antigravity를 선택합니다. 그러면 패키지에 포함된 DR-Terminal 브리지를 실행하는 사용자 수준 dr-terminal 항목이 만들어집니다. 클라이언트 구성에는 토큰이나 엔드포인트가 저장되지 않습니다. Antigravity 2.0, Antigravity IDE, agy는 ~/.gemini/config/mcp_config.json에서 이 항목을 공유합니다.
  3. 열기를 선택하거나 클라이언트를 평소처럼 엽니다. 첫 연결 시 DR-Terminal 창이 앞으로 나오며 Allow 또는 거부를 묻습니다.
  4. 연결을 허용한 후 첫 프롬프트를 붙여넣고 보냅니다.
내 활성 DR-Terminal 세션을 보여 줘.

선택한 CLI가 설치되어 있고 PATH에서 사용할 수 있어야 합니다. 설치는 설치된 DR-Terminal 패키지에서만 지원됩니다. Gradle이나 IDE에서의 개발 실행은 의도적으로 영구 항목을 만들지 않습니다. Remove는 정확히 DR-Terminal이 소유한 항목만 삭제하며 확인을 요청합니다. 다른 기존 dr-terminal 항목은 충돌로 보고되며 절대 덮어쓰지 않습니다.

유용한 프롬프트

두 개 이상의 세션이 열려 있을 때는 세션 이름이나 식별자를 사용하세요. 에이전트가 세션이 없다고 보고하면 DR-Terminal에서 연결을 열거나, 먼저 저장된 연결 목록을 보여 달라고 에이전트에 요청하세요.

승인 및 표시기

세션 메타데이터와 터미널 출력을 읽는 것은 보통 작업을 방해하지 않습니다. 입력, 키 누르기, 파일 전송, 연결 해제 같은 민감한 작업에는 사용자의 승인이 필요합니다.

승인이 필요하면 MCP 칩이 깜박이며 확인 대화 상자가 키보드 포커스를 받습니다. 대상 세션과 페이로드를 검토한 다음 한 번 허용, 이 세션에서 허용, 또는 거부를 선택합니다. 작업이 실행되는 동안 해당 세션 탭에는 정적 MCP 마커가 표시되며, 칩 색상은 전역 MCP 상태를 나타냅니다.

에이전트는 DR-Terminal에 저장된 비밀번호나 개인 키를 절대 받지 않습니다. 세션에 대한 승인은 현재 MCP 서버 실행이 활성 상태인 동안에만 적용됩니다.

로컬 연결 보안

MCP 서버는 루프백 인터페이스에서만 수신 대기하므로 네트워크에 노출되지 않습니다. 그래도 모든 요청에는 소유자만 접근할 수 있는 로컬 파일에 저장된 베어러 토큰이 필요합니다. 제목 표시줄 팝오버는 그 토큰을 절대 표시하거나 복사하지 않습니다.

엔드포인트는 진단을 위해 엔드포인트 및 최근 작업 아래에만 표시됩니다. 토큰 파일을 공유하거나 그 내용을 프롬프트, 채팅 메시지, 로그, 스크린샷에 복사하지 마세요.

MCP 중지

MCP 팝오버에서 중지를 선택하면 대기 중인 승인이 거부되고, 도구 호출 수락이 중단되며, 현재 MCP 실행에서 시작된 클라이언트가 닫힙니다. MCP를 다시 시작하면 새 실행이 만들어지며 이전 세션 승인은 이어지지 않습니다.

MCP 배지를 클릭하면 팝오버만 열립니다. 서버가 암묵적으로 시작되는 일은 절대 없습니다. 수동 실행에는 명시적인 Start MCP 작업을 사용하세요. 등록된 클라이언트도 눈에 보이는 연결 승인 절차를 거쳐 서버를 시작할 수 있습니다.

문제 해결

CLI를 찾을 수 없음

선택한 Codex, Claude Code, 또는 Antigravity CLI(agy)를 설치하고 그 실행 파일이 PATH에서 사용 가능한지 확인하세요. 셸 환경을 변경한 후에는 DR-Terminal을 다시 시작한 다음 다시 확인을 선택하세요.

포트가 이미 사용 중

다른 프로세스가 구성된 MCP 포트를 사용하고 있습니다. 그 프로세스를 중지하거나 설정 → MCP 모드에서 다른 포트를 선택한 다음 MCP를 다시 시작하세요.

활성 세션 없음

먼저 SSH, Telnet, 시리얼 또는 로컬 터미널 세션을 여세요. 에이전트에 저장된 연결을 보여 달라고 요청한 뒤, 작업을 승인하고 나서 하나를 열게 할 수도 있습니다.

클라이언트는 실행 중이지만 MCP가 확인되지 않음

CLI 프로세스는 시작되었지만 DR-Terminal이 아직 MCP 도구 호출을 받지 못했습니다. 새 터미널 탭에서 로그인, 구성, 핸드셰이크 오류를 확인하세요. 그런 다음 예시 프롬프트를 다시 보내세요. 실행 중은 로컬 프로세스를 설명할 뿐, 확인된 MCP 연결을 의미하지 않습니다.

승인 대화 상자가 대기 중

DR-Terminal로 돌아가 포커스된 대화 상자를 검토하세요. 허용하거나 거부할 때까지 에이전트는 그 민감한 작업을 계속할 수 없습니다. MCP를 중지하면 대기 중인 요청이 거부됩니다.

Previous
Telnet