VESSL Cloud Documentation

VESSL Cloud를 AI 코딩 도구에 연결하는 두 가지 방법이 있어요. vesslctl 스킬을 설치하면 에이전트가 Workspace를 만들고, Batch Job을 제출하고, 볼륨을 관리하는 일까지 직접 수행할 수 있어요. MCP 서버를 연결하면 에이전트가 작업 중에 docs에서 명령어와 플래그, 워크플로우를 바로 찾아볼 수 있어요. 두 방식은 서로 보완적이에요.

vesslctl 스킬 설치하기

vesslctl skill 명령어는 AI 코딩 에이전트(Claude Code, Codex, Gemini CLI, Cursor 등)에게 vesslctl로 VESSL Cloud를 조작하는 방법을 알려주는 번들 스킬 파일을 설치해요. 스킬은 Agent Skills 오픈 표준을 따라요. 대화형으로 실행하고 대상 위치를 선택하세요:

vesslctl skill install

사용 가능한 대상:

대상	기본 디렉터리	호환 도구
`cross-client`	`~/.agents/skills`	Codex, Gemini CLI, Cursor, 그 밖에 Agent Skills를 지원하는 에이전트
`claude-code`	`~/.claude/skills`	Claude Code(네이티브)

비대화형으로 설치:

vesslctl skill install --target claude-code
vesslctl skill install --target cross-client
vesslctl skill install --dir ~/my-skills

이 명령어는 멱등(idempotent)이에요. 다시 실행하면 이미 최신인 파일은 건너뛰어요. 스킬을 설치하면 에이전트가 별도 설정 없이 VESSL Cloud를 바로 조작할 수 있어요. 이렇게 시도해 보세요:

Create a GPU workspace on VESSL Cloud

전체 플래그 레퍼런스와 skill show 서브커맨드는 vesslctl skill 문서에서 확인하세요.

MCP로 문서 연결하기

AI 도구가 VESSL Cloud docs에 실시간으로 접근해서 작업 중에 명령어, 플래그, 워크플로우를 바로 찾아볼 수 있도록 해요. MCP를 지원하는 모든 AI 도구에 이 URL을 연결하세요:

https://docs.cloud.vessl.ai/mcp

서버에서 제공하는 도구:

도구	설명
`search_vessl_ai`	VESSL Cloud 문서 전체에서 관련 콘텐츠를 검색해요.
`query_docs_filesystem_vessl_ai`	VESSL Cloud 문서의 가상 파일시스템에 대해 `rg`, `grep`, `cat`, `head`, `tree`, `ls` 같은 셸 명령을 실행해서 구조를 탐색하고 특정 페이지를 읽어요.

Claude Code

프로젝트의 CLAUDE.md 또는 Claude Code 설정에 MCP 서버를 추가하세요:

{
  "mcpServers": {
    "vessl-docs": {
      "type": "url",
      "url": "https://docs.cloud.vessl.ai/mcp"
    }
  }
}

연결하면 Claude Code가 vesslctl 명령어를 조회하고, 사용 가능한 플래그를 확인하고, 자주 쓰는 워크플로우를 참조하면서 스크립트 작성이나 디버깅을 도와줄 수 있어요.

`vesslctl` 프로젝트용 CLAUDE.md 예시

# Project Setup

이 프로젝트는 GPU 워크로드에 VESSL Cloud를 사용해요.

## Tools
- `vesslctl` CLI로 Workspace와 Batch Job 관리
- VESSL docs MCP: https://docs.cloud.vessl.ai/mcp

## Common tasks
- Workspace 생성: `vesslctl workspace create --name <name> --resource-spec <spec> --image <image>`
- Batch Job 제출: `vesslctl job create --name <name> --resource-spec <spec> --image <image> --cmd "<command>"`
- Job 로그 확인: `vesslctl job logs <slug> --follow`

Cursor

Settings를 열어요.
MCP Servers로 이동해요.
새 서버를 추가하고 URL에 https://docs.cloud.vessl.ai/mcp를 입력해요.

Windsurf

Settings를 열어요.
Cascade > MCP로 이동해요.
새 MCP 서버를 추가하고 URL에 https://docs.cloud.vessl.ai/mcp를 입력해요.

VS Code(Copilot 또는 Continue 사용 시)

.vscode/mcp.json에 추가하세요:

{
  "servers": {
    "vessl-docs": {
      "type": "url",
      "url": "https://docs.cloud.vessl.ai/mcp"
    }
  }
}

다른 도구

MCP를 지원하는 모든 도구에서 서버 URL로 연결할 수 있어요. 사용 중인 도구의 문서에서 MCP 서버 추가 방법을 확인한 후 아래 URL을 사용하세요:

https://docs.cloud.vessl.ai/mcp

페이지별 MCP 링크

VESSL Cloud docs의 각 페이지에는 컨텍스트 메뉴에서 Copy MCP link 옵션을 사용할 수 있어요. 특정 페이지에 대한 직접 MCP 참조를 AI 도구에 공유할 때 유용해요.

시작하기

예제

vesslctl CLI

VESSL Cloud 사용하기

조직 운영하기

VM Clusters

용어집

서포트

AI와 함께 사용하기

vesslctl 스킬 설치하기

MCP로 문서 연결하기

Claude Code

`vesslctl` 프로젝트용 CLAUDE.md 예시

Cursor

Windsurf

VS Code(Copilot 또는 Continue 사용 시)

다른 도구

페이지별 MCP 링크

​vesslctl 스킬 설치하기

​MCP로 문서 연결하기

​Claude Code

​vesslctl 프로젝트용 CLAUDE.md 예시

​Cursor

​Windsurf

​VS Code(Copilot 또는 Continue 사용 시)

​다른 도구

​페이지별 MCP 링크

vesslctl 스킬 설치하기

MCP로 문서 연결하기

Claude Code

`vesslctl` 프로젝트용 CLAUDE.md 예시

Cursor

Windsurf

VS Code(Copilot 또는 Continue 사용 시)

다른 도구

페이지별 MCP 링크