> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cloud.vessl.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# AI와 함께 사용하기

> vesslctl을 Claude Code, Cursor 등 AI 개발 도구에 연결하는 방법을 알아봐요.

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

## vesslctl 스킬 설치하기

`vesslctl skill` 명령어는 AI 코딩 에이전트(Claude Code, Codex, Gemini CLI, Cursor 등)에게 `vesslctl`로 VESSL Cloud를 조작하는 방법을 알려주는 번들 스킬 파일을 설치해요. 스킬은 [Agent Skills 오픈 표준](https://agentskills.io/home)을 따라요.

대화형으로 실행하고 대상 위치를 선택하세요:

```bash theme={null}
vesslctl skill install
```

**사용 가능한 대상:**

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

비대화형으로 설치:

```bash theme={null}
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`](/ko/cli/commands/skill) 문서에서 확인하세요.

## MCP로 문서 연결하기

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

```text theme={null}
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 서버를 추가하세요:

```json theme={null}
{
  "mcpServers": {
    "vessl-docs": {
      "type": "url",
      "url": "https://docs.cloud.vessl.ai/mcp"
    }
  }
}
```

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

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

```markdown theme={null}
# 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

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`에 추가하세요:

```json theme={null}
{
  "servers": {
    "vessl-docs": {
      "type": "url",
      "url": "https://docs.cloud.vessl.ai/mcp"
    }
  }
}
```

### 다른 도구

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

```text theme={null}
https://docs.cloud.vessl.ai/mcp
```

### 페이지별 MCP 링크

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