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

01  /  3단계 설정

3단계로 Claude Code를 내 서버에 연결

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

• 1호스트를 고르세요. Termalin을 설치하고 설정 → 에이전트 액세스 (MCP)에서 공개할 호스트를 선택하세요. 각 호스트는 에이전트 전용 인증으로 기록되므로 디스크에 비밀번호가 남지 않습니다.
• 2서버를 등록하세요. Claude Code에서 명령 하나면 됩니다:

claude mcp add termalin -- <path>/termalin-mcp

Cursor나 다른 MCP 클라이언트를 쓰시나요? 그 클라이언트의 MCP 설정을 같은 바이너리로 지정하세요:

{
  "mcpServers": {
    "termalin": { "command": "<path>/termalin-mcp" }
  }
}

• 3실제 작업을 맡기세요. 에이전트가 호스트 목록을 확인하고 바로 일을 시작합니다. 로그 tail, 서비스 재시작, 디스크 확인, 설정 편집, 배포까지.

자세한 설명이 필요하신가요? Claude Code 단계별 안내(영어)를 따라 해 보세요.

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

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

대부분의 MCP 서버는 API를 감쌉니다. Termalin의 MCP 서버는 내 서버를 감쌉니다. 에이전트는 진짜 세션, 파일, 터널로 내가 하듯이 서버를 다룹니다:

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

03  /  키 보관 및 동의

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

에이전트는 자격 증명을 보지 못합니다. Termalin의 키 커스터디언(사용자 대신 키를 보관하고 서명하는 구성 요소)이 대신 서명합니다. 한 번 잠금을 해제하면 세션이 인증되며, ssh-add도, 에이전트가 읽을 키 파일도 없고, 모델에 개인 키가 넘어가지도 않습니다. 에이전트 액세스는 기본적으로 꺼져 있습니다. 에이전트가 내 라이브 세션에 입력하도록 허용하는 것은 또 별도의 토글입니다. 그리고 설정 → 에이전트 액세스 (MCP)에서 내보낸 호스트만 접근할 수 있으며, 호스트마다 전체 액세스, 허용된 명령만, 차단 중 하나의 액세스 수준을 따로 둡니다.

04  /  감독

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

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

• ▸녹화에 표시 — 에이전트의 명령마다 재생 타임라인에 초록색 마커가 붙으므로, “에이전트가 무엇을 했나?”라는 질문에 타임라인을 앞뒤로 넘겨 보며 답할 수 있습니다. 세션 녹화 자세히 보기 →
• ▸감사 로그에 기록 — 모든 로그인, 호스트 연결, 파일 작업, 에이전트 명령을 위치(IP · 국가) 및 기기와 함께 기록합니다.

05  /  앱 없이

데스크톱 앱이 없나요? Claude Code를 호스팅 MCP 서버에 연결하세요

호스팅 MCP 서버는 Connector로 등록한 서버에 접근합니다. Connector는 서버에서 바깥쪽으로 연결하는, 한 줄로 설치하는 에이전트입니다. 데스크톱 앱에만 있는 호스트는 등록된 것이 아니므로, 그 호스트에서 Connector가 실행되기 전까지 호스팅 MCP 서버에는 보이지 않습니다. 호스팅 쪽은 Pro 또는 14일 체험 계정이 필요합니다.

• 1서버를 등록하세요. termal.in/account에 로그인해 Connector 추가를 클릭하고, 표시되는 한 줄 설치 명령을 복사하세요. 그 명령을 내가 관리하는 서버에서 실행합니다. 처음에는 중요도가 낮은 서버를 고르세요. 그다음부터는 인바운드 포트 없이, 키 없이 접근할 수 있습니다.
• 2Claude Code에 Termalin을 추가하세요. 원격 MCP 서버로 등록합니다:

claude mcp add --transport http termalin https://termal.in/mcp

• 3한 번 로그인하세요. Claude Code에서 /mcp를 실행하고 termalin을 선택한 다음 인증을 고르세요. 브라우저에 Termalin 로그인 페이지가 열리고, 한 번만 승인하면 됩니다. 요청에 “no enrolled servers”라는 응답이 오면 아직 1단계를 하지 않은 것입니다. 그다음 이 연결은 계정의 AI 앱 카드에 표시되며, 거기서 명령을 허용 목록으로 제한하거나 읽기 전용으로 두거나, 연결을 해제할 수 있습니다.

Claude Code 대신 claude.ai나 Claude 앱을 쓰시나요? Termalin은 Claude 커넥터 디렉터리에 있습니다. 목록을 열고 Connect를 클릭하세요. claude.ai 가이드도 참고하세요.

로그인할 사람이 없는 스크립트와 CI에서는 웹 캐비닛에서 API 키를 만들고, Authorization: Bearer tk_live_… 헤더와 함께 https://termal.in/api/v1/mcp 주소로 지정하세요. 내 컴퓨터에 아무것도 열려 있지 않아도 터널로 연결된 서버, 즉 한 줄 설치 에이전트가 실행 중인 서버(termal.in/account → Connector 추가로 등록하며, 데스크톱 앱의 호스트는 해당되지 않습니다)에서 명령을 실행하고 파일을 읽고 씁니다. 인증에는 단기 인증서를 쓰므로 키가 밖으로 나가지 않습니다. 키는 특정 서버로 범위를 제한하고, 명령 정책(전체, 허용 목록, 읽기 전용)을 정하고, 만료 기간(30 / 90 / 365일)을 두고, 언제든 해지할 수 있습니다. 호스팅 실행에는 속도 제한과 시간 제한이 있습니다. 두 경로가 닿는 호스트는 서로 다릅니다. 로컬 서버는 앱에서 내보낸 인벤토리를, 호스팅 엔드포인트는 등록된 터널 서버를 다룹니다. 처음이신가요? AI 에이전트용 SSH부터 시작하거나, 곧바로 MCP 전체 레퍼런스로 가세요.