메인 콘텐츠로 건너뛰기
VESSL Cloud 문서는 MCP(Model Context Protocol) 서버로 제공돼요. AI 코딩 어시스턴트가 docs를 직접 검색하고 읽을 수 있어서, vesslctl 명령어와 플래그, 워크플로우에 대한 정확한 컨텍스트를 제공받을 수 있어요.

MCP 서버

MCP를 지원하는 모든 AI 도구에 이 URL을 연결하세요:
https://docs.cloud.vessl.ai/mcp
서버에서 제공하는 도구:
도구설명
search_vessl_aiVESSL Cloud 문서 전체에서 관련 콘텐츠를 검색해요
query_docs_filesystem_vessl_aiVESSL 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`

AI IDE에서 설정하기

MCP 설정 방법은 IDE마다 달라요. 주요 IDE별 안내를 확인하세요:

Cursor

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

Windsurf

  1. Settings를 열어요
  2. Cascade > MCP로 이동해요
  3. 새 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 도구에 공유할 때 유용해요.