로그인5초 가입
CLI · MCP 서버

터미널에서도,
AI 앱 안에서도 onpod.

명령 한 줄(CLI)로도, AI 앱에 붙이는 도구(MCP)로도 써요. Claude·Cursor·VS Code 에 한 번 연결해 두면 채팅창에서 「이 폴더 인터넷에 올려줘」 한 마디로 배포·로그·DB까지.

AI 앱에 연결하기CLI 설치

같은 로그인 · 같은 기능 · CLI·MCP 자체는 무료(쓴 서버·DB만 지금 요금 그대로)

AI 앱 · onpod 연결됨
이 폴더 인터넷에 올려줘. 회원가입이랑 글 저장 되게.
onpod · deploy_planNext.js 앱 · DB 필요 · 무료 절전형 ₩0/월
onpod · deploy서버에서 빌드 → 배포 → 주소 확인
onpod · job1분 12초 · HTTP 200
올렸어요 → myapp.onpod.ai. DB 도 만들어 연결했고, 30분 쉬면 잠들었다가 다음 방문에 깨어나요(월 ₩0).

어떤 걸 쓰나요

둘은 같은 프로그램이에요.

MCP 서버는 CLI 안에 들어 있어요(onpod mcp). 로그인도, 할 수 있는 일도, 요금도 같아요 — 쓰는 AI 앱에 맞춰 고르면 돼요.

CLI

터미널이 있는 코딩 에이전트 · 개발자

에이전트가 셸에서 onpod 명령을 바로 실행해요. 설치 한 줄이면 끝이고, 배포 판단(정적·서버·봇·DB·디스크)은 onpod 이 폴더를 보고 대신 해요.

  • Claude Code
  • Codex
  • Cursor 터미널
  • Gemini CLI
  • Cline
CLI 시작하기 →

MCP

채팅형 AI 앱 · IDE 의 AI 패널

터미널이 없는 앱도 onpod 을 직접 다뤄요. 쓸 수 있는 도구가 정해져 있어 AI 가 헤매지 않고, 배포·명령 실행 같은 변경은 앱이 실행 전에 확인을 받아요.

  • Claude Desktop
  • Claude Code
  • Cursor
  • VS Code
  • Windsurf
  • Codex
  • Gemini CLI
MCP 시작하기 →

CLI

설치 한 줄, 배포도 한 줄.

코딩 에이전트에게 「onpod 에 올려줘」라고만 하면 아래 순서로 알아서 해요. 사람이 직접 쳐도 똑같아요.

macOS · Linux
$ curl -fsSL https://onpod.ai/install.sh | sh
Windows (PowerShell)
$ irm https://onpod.ai/install.ps1 | iex
npm · Homebrew
$ npm i -g onpod
# 또는
$ brew install onpod/onpod/onpod
로그인 → 제안 → 배포
$ onpod login --token <콘솔 › API 키>
$ onpod deploy
📦 Next.js 서버 앱 · DB 필요 → 무료 절전형 · 월 ₩0
$ onpod deploy --yes
✅ https://myapp.onpod.ai (HTTP 200)

자주 쓰는 명령

  • onpod app ls
  • onpod app status <앱>
  • onpod logs <앱>
  • onpod exec <앱> -- <명령>
  • onpod db create --name <이름>
  • onpod app domain add <앱> <도메인>

모든 명령은 --help 로 한국어 설명을 볼 수 있어요.

MCP

AI 앱에 한 번만 연결하세요.

MCP 는 AI 앱이 바깥 도구를 쓰는 표준이에요. 아래에서 쓰는 앱을 골라 설정을 붙여 넣으면 끝 — 그 다음부턴 채팅으로 시키면 돼요.

설치 없이 URL 하나로 — claude.ai·Claude 데스크톱은 아래 첫 탭(「Claude 커넥터」)처럼 https://api.onpod.ai/mcp 를 커넥터에 붙여 넣고 onpod 로그인만 하면 돼요. 이 방식은 웹사이트 올리기 전용이고, 서버·DB 까지 다 쓰려면 아래 1~2단계(CLI)로 연결하세요.
1

CLI 설치 + 로그인 (한 번)

위 CLI 설치 한 줄과 onpod login. CLI 를 깔기 싫으면 마지막 탭(npx)처럼 설정에 API 키를 넣어도 돼요.

2

쓰는 AI 앱 고르기

설정을 붙여 넣고 앱을 다시 시작하세요. 앱이 onpod 를 못 찾으면 터미널에서 onpod mcp config 를 실행하세요 — 이 컴퓨터의 정확한 경로를 넣은 설정을 출력해 줘요.

Claude › 설정 › 커넥터 › 사용자 지정 커넥터 추가 — 이 주소를 붙여 넣고 onpod 로그인
https://api.onpod.ai/mcp
3

말로 시키기

배포는 지금처럼 「제안 → 확인 → 실행」 순서예요. AI 가 무엇을 만들지와 월 요금을 먼저 보여 주고, 한 번 묻고 올려요.

이렇게 말하면 돼요

  • “이 폴더 onpod 에 올려줘”
  • “내 앱들 지금 상태 어때?”
  • “blog 앱 왜 안 떠? 로그 봐줘”
  • “이 앱에 DB 붙이고 DATABASE_URL 넣어줘”
  • “mypod 에서 nvidia-smi 돌려봐”
  • “brand.com 을 내 앱에 연결해줘”

Claude Code 에서는 /mcp__onpod__deploy · /mcp__onpod__status 바로가기도 생겨요.

교육·워크숍

강의장 전원이 말로 배포하게.

바이브코딩 교육에서 「MCP 가 뭐냐」 설명할 필요 없이, 커넥터 연결 한 번으로 모두가 자기 사이트를 인터넷에 올려요.

1

프로젝트 만들고 초대

콘솔에서 프로젝트를 만들고 참가자 이메일을 붙여 넣거나 CSV(최대 500명)로 한 번에 초대해요. 참가자는 그 프로젝트만 봐요.

2

커넥터 연결

참가자는 초대 메일로 가입·수락한 뒤 Claude 커넥터에 주소를 붙여 넣고 onpod 로그인 → 교육 프로젝트를 골라요. 회사 Claude 는 관리자가 커넥터를 미리 추가해 두면 「연결」만 누르면 돼요.

3

말로 배포

「우리 팀 소개 페이지 만들어서 올려줘」 — 사이트가 프로젝트에 쌓이고 비용은 진행자 팀이 내요(웹사이트는 무료). 끝나면 일괄 해제로 커넥터까지 한 번에 끊어요.

자세한 순서(스크린샷 포함): Claude 에 연결해서 말로 배포하기

도구

AI 가 쓰는 도구 10개

조회 도구는 바로, 변경 도구(배포·명령 실행)는 AI 앱이 실행 전에 확인을 받아요. 몇 분 걸리는 배포도 AI 앱의 시간 제한에 끊기지 않고 뒤에서 끝까지 가요.

manual

onpod 사용법 — 필요한 주제만 골라 읽어요

조회
whoami

연결된 계정·회사 확인

조회
apps

내 앱 목록·상태·주소 (이름으로 거르기)

조회
app_status

앱 하나의 자세한 상태·실패 원인

조회
logs

앱·서버 로그 마지막 N줄

조회
deploy_plan

폴더를 보고 배포 제안·월 요금 (아무것도 안 만들어요)

조회
deploy

제안대로 배포 → 공개 주소 확인

변경 · 확인 후 실행
exec

서버 안에서 명령 한 번 실행

변경 · 확인 후 실행
onpod

그 밖의 모든 CLI 명령 (DB·도메인·GPU·파일 저장소…)

변경 · 확인 후 실행
job

몇 분 걸리는 작업 기다리기·취소

조회

안전

AI 에게 맡겨도 선은 지켜요

토큰은 대화에 안 남아요

로그인은 MCP 로 받지 않아요. CLI 로그인이나 설정의 환경변수로만 — 채팅 기록에 키가 찍히지 않게.

비밀 폴더는 못 건드려요

~/.ssh·~/.aws 같은 비밀 위치, 홈 폴더 통째 업로드는 거절해요. 경로는 프로젝트 폴더만.

결제·운영자 명령은 막혀 있어요

결제 카드·자동 충전 설정과 운영자 명령은 사람이 직접. 충전 링크 발급 같은 건 돼요.

읽기 전용 모드

args 를 ["mcp", "--read-only"] 로 두면 조회 도구만 보여요 — 상태 확인용으로 안심하고 연결.

긴 작업도 끝까지

45초 넘게 걸리면 작업 번호를 먼저 주고 뒤에서 계속 돌아요. AI 가 이어서 결과를 받아요.

필요한 권한만 주기

콘솔 › API 키에서 필요한 권한·만료일만 고른 키를 만들어 MCP 설정에 넣을 수 있어요.

자주 묻는 질문

Q.요금이 따로 있나요?

CLI 와 MCP 는 무료예요. 올린 앱·DB·GPU 같은 자원만 지금 요금 그대로 쓴 만큼 나가요. 웹사이트·작은 앱은 무료로도 올라가요.

Q.어떤 AI 앱에서 되나요?

내 컴퓨터에서 MCP 서버를 띄우는 앱(stdio 방식)이면 돼요 — Claude Desktop·Claude Code·Cursor·VS Code·Windsurf·Codex·Gemini CLI 등. 앱 목록에 없어도 MCP 설정 화면이 있으면 위 JSON 을 그대로 쓰면 돼요.

Q.설치 없이 Claude 에서 바로 쓸 수 있나요?

네. claude.ai·Claude 데스크톱의 「커넥터」에 https://api.onpod.ai/mcp 를 붙여 넣고 onpod 에 로그인하면 돼요. 이 방식은 웹사이트 올리기·고치기·지우기 전용이고, 서버·DB 까지는 CLI 로 연결해요.

Q.CLI 를 이미 쓰고 있는데 MCP 도 필요할까요?

터미널을 쓰는 코딩 에이전트라면 CLI 로 충분해요. 터미널이 없는 앱(Claude Desktop 등)에서 쓰거나, AI 가 쓸 수 있는 일을 도구 목록으로 정해 두고 싶을 때 MCP 를 붙이세요.

Q.회사(기업 계정)에서도 되나요?

회사 API 키로 로그인하면 회사 자산으로 배포되고 회사 지갑으로 결제돼요. 회사 서버에 직접 설치한 onpod(온프렘)도 같은 CLI 라 그대로 써요.

Q.MCP 를 쓰려면 CLI 버전이 몇이어야 하나요?

0.7.137 이상이에요. 이미 깔려 있으면 brew upgrade onpod 또는 npm i -g onpod 로 올리세요.

쓰던 AI 그대로, 서버는 onpod 이.

가입하고 API 키를 받으면 CLI 든 MCP 든 바로 써요. 웹사이트·작은 앱은 무료로 올라가요.

5초 가입 → API 키 받기REST API 보기