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

# Discord 서버에 봇 초대하기

> 어떤 서버를 고를 수 있고, 목록이 비어 있을 때는 무엇을 확인해야 하는지 설명합니다.

연결의 첫 단계는 관리할 Discord 서버를 고르고, 그 서버에 Route One 봇을 넣는 것입니다.

## 어떤 서버를 고를 수 있나요

로그인한 Discord 계정이 다음 중 하나에 해당하는 서버만 목록에 나타납니다.

* 서버 **소유자**인 경우
* **서버 관리하기(Manage Server)** 권한을 가진 역할을 받은 경우

<Note>
  이 판단은 Discord 가 직접 합니다. Route One 은 「관리할 수 있는 서버 목록」만 전달받을 뿐, 서버의 대화 내용을 읽지 않습니다.
</Note>

## 순서

<Steps>
  <Step title="기존 서버 연결을 누릅니다">
    대시보드에서 **기존 서버 연결** 을 누르면 Discord 로그인과 동의 화면이 열립니다.
  </Step>

  <Step title="연결할 서버를 고릅니다">
    목록에서 서버 하나를 고릅니다. 고르면 Route One 이 권한을 한 번 더 확인한 뒤 연결 기록을 만듭니다.
  </Step>

  <Step title="봇을 설치합니다">
    **봇 설치** 를 누르면 Discord 의 봇 초대 화면이 열립니다. 안내대로 허용하면 됩니다.

    대시보드는 설치 상태를 자동으로 확인하므로, 화면을 새로고침할 필요는 없습니다.
  </Step>
</Steps>

## 봇이 어떤 권한을 가져야 하나요

초대 화면에 표시되는 권한을 그대로 허용하면 됩니다. 각 권한이 쓰이는 곳은 다음과 같습니다.

| 권한       | 쓰이는 곳              |
| -------- | ------------------ |
| 메시지 보내기  | 인증 패널 게시, 명령어 응답   |
| 역할 관리하기  | 인증 상태에 따른 역할 자동 부여 |
| 닉네임 관리하기 | 인증한 멤버의 닉네임 자동 변경  |

<Warning>
  역할과 닉네임 자동화를 쓰려면, Discord 서버 설정에서 **Route One 봇의 역할을 대상 멤버보다 위로** 올려야 합니다. Discord 는 자기보다 높은 역할을 가진 사람을 봇이 건드리지 못하게 막습니다. 서버 소유자는 구조상 변경할 수 없습니다.
</Warning>

## 서버 목록이 비어 있다면

「관리 가능한 서버가 없습니다」가 나오는 경우는 거의 다음 중 하나입니다.

<AccordionGroup>
  <Accordion title="권한이 없는 Discord 계정으로 로그인했습니다">
    브라우저에 다른 Discord 계정이 로그인되어 있을 수 있습니다. Discord 에서 로그아웃한 뒤 올바른 계정으로 다시 시도하세요.
  </Accordion>

  <Accordion title="역할은 있지만 「서버 관리하기」 권한이 꺼져 있습니다">
    서버 소유자에게 요청해 해당 역할에 「서버 관리하기」 를 켜달라고 하세요. 관리자(Administrator) 권한이 있으면 이 권한도 포함됩니다.
  </Accordion>

  <Accordion title="방금 권한을 받았는데 목록에 안 나옵니다">
    Discord 가 서버 목록을 잠시 캐시합니다. 잠시 뒤에 다시 시도하거나, Discord 연결을 다시 한 번 승인해 보세요.
  </Accordion>
</AccordionGroup>

## 다음 단계

<Card title="로블록스 경험 연결하기" icon="gamepad-2" href="/connect/roblox">
  봇이 들어갔다면 경험을 연결합니다.
</Card>