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

01  /  3단계 설정

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

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

• 1호스트를 고르세요. Termalin을 설치하고 설정 → 에이전트 액세스 (MCP)에서 공개할 호스트를 선택하세요. 각 호스트는 에이전트 전용 인증으로 기록되므로 디스크에 비밀번호가 남지 않습니다. 그 화면에서 호스트별 에이전트 정책도 정하세요: 전체 액세스, 허용된 명령만, 차단.
• 2서버를 등록하세요. Codex는 ~/.codex/config.toml 파일의 mcp_servers 섹션에서 MCP 서버를 읽습니다. 바이너리를 가리키는 항목을 추가하세요:

[mcp_servers.termalin]
command = "<path>/termalin-mcp"

최신 Codex 빌드에서는 명령줄로도 등록할 수 있습니다(codex mcp add termalin -- <path>/termalin-mcp). 같은 설정이 IDE 안의 Codex에도 그대로 적용됩니다.

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

더 자세한 설명이 필요하신가요? Codex 전체 설정 가이드(영어)를 따라 해 보세요.

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

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

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

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

03  /  키 보관 및 동의

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

Codex는 내 컴퓨터에서 터미널 명령을 실행합니다. 그래서 키가 ~/.ssh에 잠금 해제된 채 있거나 ssh-agent가 실행 중이면 ssh prod가 이미 동작하고, 정한 적도 없이 서버 전체 액세스를 내준 셈이 됩니다. Termalin의 키 커스터디언(사용자 대신 키를 보관하고 서명하는 구성 요소)은 이 구조를 대신합니다. 에이전트는 요청하고, 커스터디언이 인증합니다. 한 번 잠금을 해제하면 Termalin이 에이전트 대신 서명하며, 에이전트가 읽을 키 파일은 없습니다. 유출될 것이 없고, 보호할 가치가 있는 호스트를 위해 디스크에 키를 흩어 둘 필요도 없습니다. 에이전트 액세스는 기본적으로 꺼져 있습니다. 에이전트가 내 라이브 세션에 입력하도록 허용하는 것은 또 별도의 토글입니다. 그리고 설정 → 에이전트 액세스 (MCP)에서 내보낸 호스트만 접근할 수 있으며, 호스트마다 전체 액세스, 허용된 명령만, 차단 중 하나의 액세스 수준을 따로 둡니다.

04  /  감독

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

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

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

05  /  앱 없이

클라우드에서 동작하는 에이전트를 위한 호스팅 MCP 엔드포인트

Connector로 등록한 서버라면, Codex는 데스크톱 앱을 실행하지 않고 Termalin의 호스팅 서버를 쓸 수 있습니다. URL로 추가하세요 — codex mcp add termalin --url https://termal.in/mcp. Codex가 바로 브라우저에서 Termalin 로그인 페이지를 엽니다(이후에는 codex mcp login termalin으로 다시 로그인합니다). 호스팅 쪽은 Pro 또는 14일 체험 계정이 필요합니다.

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