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

# 서버에 Vetox 추가하기

> Vetox를 초대하고 역할을 올바르게 배치한 뒤, 몇 분 안에 초기 설정을 완료하세요.

<Steps>
  <Step title="봇 초대하기">
    <Card title="Discord에 Vetox 추가하기" icon="discord" horizontal href="https://discord.com/oauth2/authorize?client_id=707333425685856316&permissions=8&integration_type=0&scope=bot">
      Discord의 인증 화면이 열립니다.
    </Card>

    추가할 서버에서 **서버 관리(Manage Server)** 권한이 필요합니다. 드롭다운에서 서버를 선택하고 확인하세요.

    초대는 **관리자(Administrator)** 권한을 요청합니다. Vetox는 모더레이션, 역할, 채널, 웹훅, 이모지 전반에 걸쳐 동작하므로, 하나의 권한으로 이 모든 것을 한꺼번에 부여합니다. 좀 더 좁은 권한을 원한다면, 초대 후 **서버 설정 → 역할**에서 Vetox 역할을 편집할 수 있습니다. 다만 제거한 권한에 해당하는 기능은 작동을 멈춥니다.
  </Step>

  <Step title="Vetox 역할 위로 올리기">
    **서버 설정 → 역할**로 이동하여 **Vetox**를 목록 상단 근처로 드래그하세요.

    Discord는 최상위 역할이 봇의 역할보다 **위에 있는** 멤버에게 봇이 어떤 조치도 취하지 못하도록 합니다. Vetox가 모더레이터 역할보다 아래에 있으면, 해당 모더레이터를 차단하거나 뮤트하거나 역할을 부여할 수 없으며, 이 문제는 권한 문제라기보다 버그처럼 보입니다. 이는 가장 흔한 설정 실수입니다.
  </Step>

  <Step title="대시보드 열기">
    [vetox.io/dashboard](https://vetox.io/dashboard)로 이동하여 Discord로 로그인하세요. 참여 중인 서버가 자동으로 표시됩니다. 방금 Vetox를 추가한 서버를 선택하세요.
  </Step>

  <Step title="원하는 기능 켜기">
    **Setup** 페이지를 여세요. 모든 기능이 각각의 스위치와 함께 나열되어 있으며 **대부분 기본적으로 꺼져 있습니다**. 여기서 켜기 전까지는 아무 일도 일어나지 않습니다.

    [서버 설정](/ko/server-management/setup)을 참고하세요.
  </Step>

  <Step title="켠 기능 설정하기">
    활성화된 각 기능은 사이드바에 자체 페이지를 가집니다. 켠 기능들을 하나씩 살펴보세요. 모든 옵션이 이 사이트에 문서화되어 있습니다.
  </Step>
</Steps>

<Warning>
  Vetox 역할을 역할 목록에서 너무 낮게 두는 것은 "봇이 작동하지 않아요"의 가장 흔한 원인입니다. Discord는 봇보다 상위에 있는 멤버에 대한 조치를 조용히 거부합니다.
</Warning>

## 먼저 설정할 것들

모든 것을 설정할 필요는 없습니다. 새 서버라면 다음 순서가 합리적입니다.

<CardGroup cols={2}>
  <Card title="1. Logs" icon="scroll" href="/ko/moderation/logs">
    무료이며, 나중에 확인해야 할 상황이 오기 전에 미리 기록해 둡니다.
  </Card>

  <Card title="2. Auto-Mod" icon="filter" href="/ko/moderation/auto-mod">
    무료입니다. 커뮤니티의 문제에 맞는 규칙을 활성화하세요.
  </Card>

  <Card title="3. Welcomer" icon="door-open" href="/ko/utility/welcomer">
    새 멤버를 환영하여 첫 순간부터 서버가 살아있음을 느끼게 하세요.
  </Card>

  <Card title="4. Leveling" icon="chart-line" href="/ko/engagement/leveling">
    활동에 보상하고 멤버가 다시 돌아올 이유를 제공합니다.
  </Card>
</CardGroup>

## 작동 확인

아무 채널에서 `/ping`을 실행해 보세요. Vetox가 응답한다면 연결되어 정상 동작 중입니다.

<AccordionGroup>
  <Accordion title="명령어가 나타나지 않아요">
    Discord가 새로 추가된 봇의 명령어를 동기화하는 데 몇 분이 걸릴 수 있습니다. Discord를 완전히 종료했다가 다시 열면 대개 새로 고쳐집니다.

    또한 테스트 중인 채널에서 Vetox가 **애플리케이션 명령어 사용(Use Application Commands)** 권한을 가지고 있는지 확인하세요.
  </Accordion>

  <Accordion title="Vetox가 오프라인이에요">
    [vetox.io/status](https://vetox.io/status)를 확인하세요. 그곳에서 모든 것이 정상이라면 봇을 제거하고 다시 초대해 보세요.
  </Accordion>

  <Accordion title="명령어가 권한이 없다고 응답해요">
    Vetox는 Discord의 명령어 표시 기능에 의존하지 않고 스스로 권한을 확인합니다. 따라서 모든 명령어가 모두에게 보이지만, 허용된 사람만 실행할 수 있습니다.

    서버 소유자와 관리자(Administrator) 권한을 가진 멤버는 항상 통과합니다. 명령어별로 특정 역할에 접근 권한을 부여할 수도 있습니다. [명령어 관리](/ko/server-management/command-management)를 참고하세요.
  </Accordion>
</AccordionGroup>

<Note>
  모든 Vetox 명령어는 **서버 전용**입니다. DM(개인 메시지)에서는 작동하지 않습니다.
</Note>

## 다음 단계

<CardGroup cols={2}>
  <Card title="대시보드 개요" icon="gauge" href="/ko/dashboard">
    대시보드의 구성과 각 항목의 위치를 안내합니다.
  </Card>

  <Card title="권한" icon="user-lock" href="/ko/permissions">
    누가 명령어를 실행하고 설정을 변경할 수 있는지 설명합니다.
  </Card>
</CardGroup>