키는 넘기지 않고, Cursor에 SSH 액세스를

01  /  3단계로 설정

3단계로 Cursor를 내 서버에 연결

Termalin은 진짜 MCP 서버를 제공합니다. 번들된 termalin-mcp 바이너리가 내가 고른 호스트에 대한 SSH와 SFTP 액세스를 에이전트에게 주며, 인증은 앱의 키 에이전트를 거칩니다. MCP 도구 전체 목록(영어)을 참고하세요.

• 1호스트를 고르세요. Termalin을 설치하고 설정 → 에이전트 액세스 (MCP)에서 공개할 호스트를 고르세요. 각 호스트는 에이전트 전용 인증으로 기록되므로 디스크에 비밀번호가 남지 않습니다. 그 자리에서 호스트별 에이전트 정책(전체 액세스, 허용된 명령만, 차단)도 정하세요.
• 2Cursor의 MCP 설정에 서버를 등록하세요. 그 프로젝트에서만 쓰려면 프로젝트 루트의 .cursor/mcp.json, 모든 곳에서 쓰려면 ~/.cursor/mcp.json에 넣습니다(서버 액세스는 저장소별로 나눌 문제가 아니므로 이쪽이 합리적입니다).

{
  "mcpServers": {
    "termalin": {
      "command": "<path>/termalin-mcp",
      "args": []
    }
  }
}

Cursor를 다시 시작하거나 Cursor Settings → MCP에서 MCP 목록을 새로 고친 다음, 서버가 실행 중으로 표시되는지 확인하세요. 그러면 에이전트에게 도구가 나타납니다.

• 3실제 작업을 요청하세요. 에이전트가 호스트 목록을 보고 일을 시작합니다. 로그 따라가기, 서비스 재시작, 디스크 확인, 설정 수정, 배포까지. Cursor는 기본적으로 도구 호출마다 먼저 묻습니다. 처음 몇 세션은 이 설정을 켜 두고, 자동 승인은 도구 하나씩 넓혀 가세요. 자세한 내용은 실습 안내(영어)를 읽어 보세요.

02  /  자기 세션, 또는 내 세션

에이전트는 자기 세션을 열거나, 내 세션에 들어옵니다

대부분의 MCP 서버는 API를 감쌉니다. Termalin이 감싸는 것은 내 서버입니다. 에이전트는 내가 일하는 방식 그대로 진짜 세션, 파일, 터널로 서버를 다룹니다.

• ▸자기 세션: 에이전트가 세션을 열어 백그라운드에서 실행합니다. 빛나는 탭으로 지켜볼 수 있습니다. Free 요금제에 포함됩니다.
• ▸또는 내 세션에: 에이전트가 내 라이브 세션에 그대로 들어옵니다. 이미 열어 둔 세션에서 나와 함께 실행하며, 작업하는 동안 테두리가 빛납니다. 동의가 필요하며, 별도 토글이 있습니다.
• ▸작업 흐름 전체: 일회성 명령, 다시 쓸 수 있는 지속 SSH 세션, SFTP 읽기와 쓰기, 그리고 포트 포워딩(서버 뒤 서비스로 가는 로컬 터널 또는 SOCKS 프록시)까지.

03  /  키 보관 & 동의

키는 내 곁에. 동의 없이는 아무것도 실행되지 않습니다

Cursor 에이전트에 관한 불편한 진실이 있습니다. 에이전트는 내 컴퓨터에서 터미널 명령을 실행하므로, 키가 ~/.ssh나 실행 중인 ssh-agent에 잠금 해제된 채로 있다면 ssh prod는 이미 동작합니다. 결정한 적도 없이 기본값으로 서버 전체 액세스를 내준 셈입니다. Termalin의 키 커스터디언은 이 구조를 바꿉니다. 에이전트는 요청하고, 커스터디언이 인증합니다. 한 번 잠금 해제하면 Termalin이 에이전트를 대신해 서명하며, 에이전트가 읽을 키 파일은 없습니다. 그래서 보호할 가치가 있는 호스트라면 더 이상 디스크에 키를 방치해 둘 필요가 없습니다. 에이전트 액세스는 기본적으로 꺼져 있고, 에이전트가 내 라이브 세션에 입력하도록 허용하는 것은 또 다른 별도 토글입니다. 그리고 설정 → 에이전트 액세스 (MCP)에서 내보낸 호스트에만 접근할 수 있으며, 각 호스트에는 전체 액세스, 허용된 명령만, 차단 중 하나의 액세스 수준이 있습니다.

04  /  감독

모든 동작을 실시간으로 보고, 녹화하고, 로그로 남깁니다

워치 그리드(열린 모든 세션을 한 화면에 보여 줌)는 열린 모든 세션을 라이브 타일로 나란히 미러링하고, 에이전트가 조작 중인 세션은 빛납니다. 그래서 필요하면 서버 여러 대에 걸쳐서도 에이전트의 작업을 실시간으로 봅니다.

• ▸녹화에 표시: 에이전트의 각 명령은 재생 타임라인에 초록색 마커로 표시됩니다. 그래서 “에이전트가 뭘 했지?”라는 질문에 타임라인을 앞뒤로 넘겨 보며 답을 찾습니다. 세션 녹화 자세히 보기 →
• ▸감사 로그에 기록: 모든 로그인, 호스트 연결, 파일 작업, 에이전트 명령을 위치(IP · 국가)와 기기 정보와 함께 기록합니다.

05  /  앱 없이

클라우드에 사는 에이전트를 위한 호스팅 MCP 엔드포인트

데스크톱 앱이 실행 중이지 않나요? Cursor의 mcp.json에서 Termalin의 호스팅 서버를 URL로 지정하고 — "termalin": { "url": "https://termal.in/mcp" } — Cursor가 물으면 한 번 로그인하세요. 또는 웹 캐비닛에서 API 키를 만들고, Authorization: Bearer tk_live_…를 담은 headers 항목과 함께 https://termal.in/api/v1/mcp를 사용하세요. 정확한 스니펫은 캐비닛에 나와 있습니다. 호스팅 쪽은 Pro 또는 14일 체험 계정이 필요합니다. 내 컴퓨터에 아무것도 열려 있지 않아도 터널로 연결된 서버(한 줄 설치 에이전트를 실행 중인 서버. termal.in/account → Connector 추가로 등록하며, 데스크톱 앱의 호스트는 해당되지 않습니다)에서 명령을 실행하고 파일을 읽고 쓰며, 단기 인증서로 인증하므로 키를 내주지 않습니다. 키는 특정 서버로 범위를 제한하고, 명령 정책(전체 / 허용 목록 / 읽기 전용)을 지정하고, 만료 기간(30 / 90 / 365일)을 정하고, 언제든 해지할 수 있습니다. 호스팅 실행에는 속도 제한과 시간 제한이 적용됩니다. 처음이라면 AI 에이전트용 SSH부터 읽거나, 바로 MCP 전체 레퍼런스로 가세요.