터미널에 사는 코딩 에이전트는 명령 실행에 능숙합니다. 대개 없는 것은 그 명령을 돌릴 자기만의 서버입니다. EQVPS MCP 서버를 연결하면 이 문제가 해결됩니다. 에이전트는 요금제 조회, VPS 주문, SSH 정보 확인, 재부팅, 샌드박스 실행 등 약 40개의 도구를 얻습니다.
이 가이드는 Claude Code와 Codex CLI를 다룹니다. Claude Desktop, Cursor, Cline은 EQVPS를 MCP 클라이언트에 연결하기를 참고하세요. 아래 명령은 모두 게시 전에 Claude Code 2.1과 Codex CLI 0.164에서 실행했습니다.
서버 주소는 어디서나 같습니다.
https://mcp.eqvps.com/mcp
Streamable HTTP로 통신하며 Authorization 헤더로 bearer 토큰을 받습니다. OAuth 로그인은 아직 없으므로 토큰은 직접 추가합니다.
1. 토큰 받기
이미 EQVPS 계정이 있다면 대시보드의 Settings → API tokens에서 만드세요. 없다면 요청 한 번으로 계정이 생기고 토큰이 반환됩니다.
curl -s -X POST https://api.eqvps.com/api/v1/eqvps/auth/register \
-H "Content-Type: application/json" \
-d '{"first_name":"Ada","last_name":"Lovelace","email":"you@example.com"}'
token 필드는 약 1,000자로 깁니다. 다시 입력하지 마세요. 에이전트가 우연히 열지 않을 파일에 저장하고 거기서 불러오세요.
umask 077; printf '%s' 'PASTE-TOKEN' > ~/.eqvps_token
export EQVPS_TOKEN=$(cat ~/.eqvps_token)
에이전트가 직접 가입하게 할 수도 있습니다. 토큰 없이 연결하고 register_account를 호출하게 한 뒤, 받은 토큰으로 서버를 다시 추가하세요.
2. Claude Code
claude mcp add --transport http eqvps https://mcp.eqvps.com/mcp \
--header "Authorization: Bearer $EQVPS_TOKEN"
기본적으로 서버는 현재 프로젝트에만 추가됩니다. 모든 프로젝트에서 쓰려면 -s user를 붙이세요. Claude Code가 서버에 닿는지 확인합니다.
claude mcp list
eqvps: https://mcp.eqvps.com/mcp (HTTP) - ✔ Connected
그 초록색 체크 표시를 너무 믿지 마세요. 요금제, 가격, 가입은 계정 없이 동작하므로 토큰을 잘못 입력해도 서버는 연결을 받아들입니다. 토큰은 에이전트가 계정에 접근할 때만 확인됩니다. 빠른 확인 방법은 Claude Code에 "call the eqvps whoami tool"이라고 요청하는 것입니다. 유효한 토큰이면 이메일이, 잘못된 토큰이면 401 오류가 반환됩니다.
claude mcp get eqvps는 세부 정보를 보여 줍니다. 토큰도 함께 출력되므로 그 결과를 채팅이나 티켓에 붙여 넣지 마세요.
피해야 할 것: -s project는 서버를 저장소 안의 .mcp.json에 기록합니다. 헤더에 토큰이 그대로 있으면 그 파일이 git에 들어갑니다. 자격 증명이 담긴 것에는 scope local 또는 user를 쓰세요.
3. Codex CLI
Codex는 환경 변수에서 토큰을 읽을 수 있어 설정 파일에 토큰이 전혀 남지 않습니다.
codex mcp add eqvps --url https://mcp.eqvps.com/mcp --bearer-token-env-var EQVPS_TOKEN
codex mcp list
Name Url Bearer Token Env Var Status Auth
eqvps https://mcp.eqvps.com/mcp EQVPS_TOKEN enabled Bearer token
이 명령은 ~/.codex/config.toml에 세 줄을 기록합니다.
[mcp_servers.eqvps]
url = "https://mcp.eqvps.com/mcp"
bearer_token_env_var = "EQVPS_TOKEN"
주의할 점: codex mcp list는 저장된 설정만 보여 줄 뿐 연결하지 않습니다. 연결은 세션이 시작될 때, 그리고 그 셸에 EQVPS_TOKEN이 설정된 경우에만 이루어집니다. 그렇지 않으면 Codex는 조용히 서버를 건너뛰고, 에이전트에는 EQVPS 도구가 없을 뿐입니다. 셸 프로필에 export 줄을 추가하거나 EQVPS_TOKEN=$(cat ~/.eqvps_token) codex로 Codex를 실행하세요.
4. 처음 요청할 것
도구가 동작하는지 보려면 읽기만 하는 것부터 시작하세요.
Call the eqvps whoami tool and tell me which account I'm signed in as.
List the EQVPS plans with a dedicated IPv4 and their monthly prices.
Show my EQVPS balance and my servers.
그다음 실제 작업입니다.
Order the cheapest EQVPS plan with Ubuntu 24.04, use my key from ~/.ssh/id_ed25519.pub, wait until it's active and give me the SSH command.
잔액이 요금제를 충당하면 주문은 바로 결제되고 서버는 보통 1분 정도면 준비됩니다. 부족하면 에이전트는 미결제 청구서와 topup_balance 링크를 받으며, 이를 Base, Ethereum, Polygon의 USDT, USDC, ETH로 결제합니다. 충전 후에는 같은 주문을 다시 하라고 요청하거나(미결제 주문을 이어받아 잔액으로 결제하며 두 번째 주문을 만들지 않습니다) pay_invoice를 호출해 그 청구서를 잔액으로 결제하게 하세요.
에이전트는 파괴적인 작업 전에도 물어봅니다. 서버 재설치나 삭제에는 호스트 이름을 입력해 확인해야 하며, 저희 도구 설명은 에이전트에게 먼저 사용자에게 확인하라고 안내합니다.
연결되지 않을 때
| 증상 | 가능한 원인 |
|---|---|
claude mcp list에서 ✘ Failed to connect | 주소가 틀렸거나 머신에 나가는 HTTPS가 없습니다. 토큰이 원인은 아닙니다. 잘못된 토큰도 연결은 됩니다. |
whoami나 get_balance가 401 반환 | 토큰이 틀렸거나, 잘렸거나, 취소됐거나, 만료됐습니다. 직접 입력하지 말고 파일에서 다시 붙여 넣으세요. |
| Codex에 EQVPS 도구가 없음 | codex를 실행한 셸에 EQVPS_TOKEN이 설정되지 않음 |
얼마 후 도구가 401로 응답 | 토큰이 만료됐거나(기본 1년) 다른 곳에서 갱신됐습니다. refresh_token을 실행하고 헤더나 변수를 업데이트하세요. |
| 주문이 미결제 청구서와 함께 돌아옴 | 잔액이 부족했습니다. 충전 후 같은 주문을 반복하거나 그 청구서로 pay_invoice를 호출하세요. |
다음: 서버가 생긴 뒤 에이전트가 할 수 있는 일 — AI 에이전트가 MCP로 자기 VPS를 관리하는 방법. 코드를 1분만 실행하면 된다면 샌드박스가 VPS보다 저렴합니다. 전체 도구 목록은 MCP 문서에 있습니다.
댓글
아직 댓글이 없습니다. 첫 번째가 되세요.