> For the complete documentation index, see [llms.txt](https://wiki.craftopia.work/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.craftopia.work/undefined/account-linking.md).

# 계정 연동

서버를 온전히 이용하려면 **마인크래프트 정품 계정**과 **Discord**를 연동하는 것이 좋습니다. 연동은 모두 대시보드의 **\[연결(Connections)]** 메뉴 또는 연동 허브(`auth.craftopia.work`)에서 진행합니다.

## 마인크래프트 정품 인증

두 가지 경로가 있습니다.

### 1. Microsoft 로그인 (권장)

대시보드에서 **Microsoft 정품 로그인**을 진행하면 UUID·닉네임이 자동으로 확인되어 연동됩니다.

{% hint style="info" %}
인증 과정의 Microsoft·Xbox·Minecraft 토큰은 **검증에만 일시 사용하고 저장하지 않습니다.**
{% endhint %}

### 2. 인게임 코드 (폴백)

1. 게임에 접속해 `/웹연동` 명령어를 입력합니다.
2. 발급된 **코드**를 대시보드에 입력해 연동합니다.

## Discord 연동

Discord 로그인(OAuth)으로 연결하거나, 인게임 봇 명령어로 연동할 수 있습니다.

{% hint style="success" %}
연동하면 Discord 역할(creator·official 등)이 웹·게임 권한과 **자동으로 동기화**됩니다.
{% endhint %}

***

다음: [**서버 접속**](/undefined/connecting.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://wiki.craftopia.work/undefined/account-linking.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.