AI 어시스턴트, 이미지 전송 & Webhook

MTerm은 기본적인 터미널 에뮬레이션을 넘어 내장 AI 지원, 원격 서버로의 원활한 이미지 전송, Webhook 기반 푸시 알림을 제공해요. 이 기능들은 AI 코딩 도구를 사용하고 워크플로우와 연결을 유지해야 하는 개발자를 위해 설계되었어요.

AI 어시스턴트

AI 어시스턴트는 터미널을 오버레이하는 플로팅 패널로, 워크스페이스를 떠나지 않고 AI 기반 도움에 즉시 접근할 수 있어요.

작동 방식

소프트 키 바의 AI 버튼을 탭하거나 Command Palette를 사용해서 플로팅 어시스턴트 패널을 열 수 있어요. AI는 터미널 출력을 보고 응답의 컨텍스트로 사용할 수 있어요.

주요 기능

터미널 컨텍스트 인식 — 어시스턴트가 터미널에서 일어나는 일을 읽을 수 있어서, 아무것도 붙여넣지 않고도 “이 에러가 무슨 뜻이야?” 또는 “이것을 어떻게 고칠 수 있어?”라고 물을 수 있어요
텍스트 선택 통합 — 터미널에서 텍스트를 선택한 후 분석, 설명, 또는 문제 해결을 위해 AI에 직접 전송
안전 경고가 있는 명령어 제안 — AI가 명령어를 제안할 때 잠재적으로 위험한 작업 (rm -rf나 DROP TABLE 같은)에 플래그를 표시해서 정보에 기반한 결정을 내릴 수 있어요
SSE 스트리밍 — 응답이 단어별로 실시간 스트리밍되어서 전체 응답을 기다리지 않아도 돼요
다국어 지원 — AI가 기기 로케일에 맞는 언어로 응답해요

Claude Code 모드

MTerm에는 Claude Code와의 작업을 위해 특별히 설계된 전용 입력 모드가 포함되어 있어요:

플로팅 입력 패널 — 긴 Prompt를 작성하기에 최적화된 전용 텍스트 입력 영역
이미지 및 파일 첨부 — Prompt와 함께 보낼 사진, 스크린샷, 또는 파일을 첨부해요. UI 목업, 에러 스크린샷, 디자인 레퍼런스를 Claude Code와 공유할 때 특히 유용해요
iPad의 모든 입력 기능 활용 — iPad 전체 키보드, 받아쓰기, 클립보드 기능을 사용해서 Prompt를 편안하게 작성하세요

AI 어시스턴트는 Pro 플랜 + Subscription이 필요해요

이미지 전송

iPad나 iPhone에서 SFTP를 통해 원격 서버로 이미지를 직접 업로드하세요. 이미지를 서버에 빠르게 올려야 하는 워크플로우를 위해 설계되었어요 — 버그 리포트에 스크린샷 첨부, 웹 프로젝트용 에셋 업로드, AI 도구에 참조 이미지 공유 등.

작동 방식

Cmd + I를 누르거나 이미지 전송 버튼을 탭
기기의 사진 라이브러리에서 사진 선택
원격 서버의 대상 디렉토리 선택
압축 및 이름 지정 옵션 설정
업로드

설정 옵션

옵션	설명
압축 품질	파일 크기와 이미지 품질의 균형을 위한 JPEG 압축 조정
최대 크기	업로드 이미지의 최대 치수(너비/높이) 설정
파일 이름 지정	타임스탬프 기반 이름, UUID, 또는 순차 번호 중 선택
대상 디렉토리	서버의 대상 폴더 선택. 존재하지 않으면 MTerm이 자동으로 생성

스마트 기능

경로 자동 삽입 — 업로드가 완료되면 원격 파일 경로가 자동으로 터미널에 삽입돼요. 경로를 수동으로 타이핑하지 않고도 업로드한 파일을 명령어에서 바로 참조할 수 있어요.
병렬 업로드 — 여러 이미지가 동시에 업로드되어서 느린 연결에서도 배치 업로드가 빨라요.

이미지 전송은 Pro 플랜이 필요해요

Webhook 알림

Webhook 알림을 사용하면 원격 서버의 이벤트에 의해 트리거되는 푸시 알림을 기기에서 받을 수 있어요. 장시간 실행되는 작업이 진행 중일 때 MTerm을 떠나도 안심할 수 있게 해주는 기능이에요.

일반적인 활용 사례

시나리오	작동 방식
Claude Code 작업 완료	Claude Code가 코드 생성을 완료할 때 트리거되는 Webhook을 설정하세요. 푸시 알림을 받고 돌아가서 결과를 검토할 수 있어요.
CI/CD 파이프라인 알림	빌드가 완료되거나, 테스트가 통과/실패하거나, 배포가 완료될 때 알림을 받아요.
서버 모니터링	서버가 다운되거나, 디스크 공간이 부족하거나, 에러 급증이 감지될 때 알림을 받아요.
커스텀 자동화	HTTP 요청을 만들 수 있는 모든 시스템이 기기에 푸시 알림을 트리거할 수 있어요.

작동 방식

MTerm은 생성한 각 Webhook에 대해 REST API 엔드포인트를 제공해요. HTTP POST 요청을 만들 수 있는 모든 시스템이 푸시 알림을 트리거할 수 있어요. API는 알림 제목과 본문이 포함된 JSON 페이로드를 받아요.

Webhook 설정

커스텀 Webhook — 커스텀 이름과 설명으로 Webhook을 생성
전송 히스토리 — 수신된 모든 Webhook 이벤트의 로그 확인
일일 할당량 — 남용 방지를 위한 Webhook 사용량 측정

Webhook 제한

플랜	일일 Webhook
Free	10
Pro	100
Subscribe	무제한

통합 예시

장시간 실행되는 스크립트가 완료될 때 알림을 트리거하려면:

# 스크립트 끝에 추가
curl -X POST https://api.mterm.app/webhook/YOUR_WEBHOOK_ID \
  -H "Content-Type: application/json" \
  -d '{"title": "Build Complete", "body": "Your project finished building successfully."}'

CI/CD 파이프라인, 크론 작업, 모니터링 스크립트 또는 기타 자동화 프로세스에 유사한 호출을 추가할 수 있어요.

Webhook 알림은 Subscription이 필요해요