채팅에서 Claude에 내 서버 SSH 액세스를 주세요

01  /  3단계로 설정

세 단계로 claude.ai를 내 서버에 연결하세요

이 커넥터는 Termalin의 호스팅 MCP 엔드포인트입니다. Connector(서버에서 바깥으로 연결하는 한 줄짜리 에이전트)로 등록한 서버에 닿습니다. Pro(또는 체험) 계정과 등록된 서버가 하나 이상 필요합니다.

• 1서버를 등록하세요. termal.in/account에 로그인하고, Connector 추가를 클릭한 다음, 안내된 한 줄짜리 설치 명령을 내가 관리하는 서버에서 실행하세요. 그때부터 그 서버는 인바운드 포트 없이 키 없이 닿을 수 있습니다. 작동 방식 자세히: Connector.
• 2커넥터를 추가하세요. claude.ai에서 커넥터 디렉터리의 Termalin 등록 페이지를 열고 Connect를 클릭하세요. 채팅에서는 Settings → Connectors → Browse connectors입니다. URL로 추가하고 싶으신가요? Settings → Connectors → Add custom connector에서 다음을 붙여 넣으세요.

https://termal.in/mcp

• 3승인하고 물어보세요. Claude가 Termalin 로그인 페이지를 엽니다. termal.in 계정으로 로그인하고 승인하세요. 이제 명령(ssh_exec, ssh_exec_many), 백그라운드 작업, sftp 도구, 모니터링(server_metrics, alerts_list), 데이터베이스 쿼리, generate_password가 채팅 안에 들어옵니다. 도구 16개 전부(영어)입니다. “내 서버 전부 온라인이야? 신경 써야 할 거 있어?”라고 물어보세요.

처음 쓰는 분이 놓치기 쉬운 조건: 유료 요금제나 체험, 온라인 상태의 Connector 하나 이상, 그리고 인증된 이메일입니다. 데스크톱 앱에만 있는 호스트는 등록된 것이 아닙니다. 그 호스트에서 Connector를 실행하기 전에는 채팅이 그 호스트를 보지 못합니다.

02  /  claude code & claude desktop

호스트가 데스크톱 앱에만 있나요? 로컬 서버를 쓰세요

위 커넥터는 claude.ai와 Claude 앱에서 작동하며, Claude Code도 쓸 수 있습니다(claude mcp add --transport http termalin https://termal.in/mcp 실행 후 /mcp로 로그인). 데스크톱 앱에만 있는 호스트라면, 대신 Claude를 번들된 termalin-mcp 바이너리로 지정하세요. 설정 → 에이전트 액세스 (MCP)에서 내보낸 호스트에 닿으며, Termalin의 키 커스터디언(사용자 대신 키를 보관하고 서명하는 구성 요소)을 통해 인증합니다.

• ▸Claude Code — 명령 한 줄이면 바로 작동합니다. Claude Code 전체 설정 가이드가 있습니다.

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

• ▸Claude Desktop — MCP 설정에 Termalin을 추가하세요.

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

로컬 서버에는 호스팅 커넥터보다 더 많은 도구가 있습니다. 명령과 파일에 더해 지속되는 세션, 포트 포워딩, 라이브 터미널 제어가 있습니다. 각 경로가 무엇을 제공하는지는 전체 도구 레퍼런스(영어)를 참고하세요.

03  /  키가 아니라 OAuth

‘챗봇에 키 붙여 넣기’와 무엇이 다른가

이 커넥터는 SSH 자격 증명을 건드리지 않습니다. 건드릴 자격 증명 자체가 없기 때문입니다.

• ▸키가 아니라 OAuth. Claude는 Termalin 로그인 페이지에서 범위가 제한된 토큰을 받습니다. 붙여 넣을 API 키도, 컨텍스트 창에 들어가는 개인 키도 없습니다. 표준 MCP 인가 흐름입니다.
• ▸키 없는 접근. 내 서버는 Connector를 통해 바깥으로 연결하고, 각 실행은 단기 인증서로 인증합니다. 인바운드 포트도, 저장된 키도 없습니다.
• ▸내 서버만. 토큰은 내 계정에 묶여 있고 내가 등록한 서버에만 닿습니다. 라우팅할 수 있는 아무 데나가 아닙니다.

04  /  감사되고, 해지 가능

모든 것이 기록에 남습니다 — 클릭 한 번으로 해지

Claude가 실행하는 모든 승인과 모든 명령이 계정의 활동 기록에 남으므로, “prod에서 뭘 했지?”라는 질문에 읽어 볼 수 있는 답이 있습니다. 그리고 액세스는 한 번 주면 끝나는 권한이 아닙니다. 계정 페이지의 ‘AI 앱’에 연결된 AI 앱이 나열되고, 거기서 각 앱이 무엇을 실행할 수 있는지(전체 액세스, 명령 허용 목록, 읽기 전용)를 정합니다. 연결 해제를 누르면 그 앱의 토큰이 즉시 폐기되며, 나중에 교체할 키도 없습니다. 이 모든 것의 바탕이 되는 키 보관 방식은 AI 에이전트용 SSH에 있습니다.

05  /  한계는 어디인가

솔직하게 밝히는 한계

• ▸비대화형 명령. 각 명령은 자신만의 세션에서 실행됩니다. cd는 호출 사이에 유지되지 않고, 전체 화면 프로그램(vim, htop)은 쓸 수 없습니다. 에이전트는 명령을 이어 붙여 이를 처리합니다.
• ▸시간 제한과 용량 제한. 명령에는 시간 제한(최대 300 s)이 있고, 파일 작업은 텍스트 전용이며 512 KB로 제한됩니다. 크거나 바이너리인 전송에는 앱을 쓰세요.
• ▸등록된 서버만. 이 커넥터는 Connector를 실행 중인 서버에 닿습니다. 데스크톱 앱에만 있는 호스트는 로컬 서버가 그쪽을 맡으며, Cursor와 Codex에서도 작동합니다.