# 2단계 인증

2단계 인증을 켜면 Mocco에 로그인할 때 비밀번호 다음에 휴대폰 인증 앱의 6자리 코드도 입력합니다. 누가 비밀번호를 알아내도 휴대폰 없이는 로그인할 수 없습니다. 직접 켜기 전에는 꺼져 있고, 켜면 내가 속한 모든 워크스페이스에서 내 로그인에 적용됩니다.

## 켜기

1. 오른쪽 위의 계정 메뉴(이름 첫 글자)에서 **계정 설정**을 열고 **2단계 인증**을 찾습니다.
2. **켜기**를 누르고 비밀번호를 입력합니다.
3. 1Password, Google Authenticator, Authy 같은 인증 앱으로 QR 코드를 스캔합니다. 스캔할 수 없으면 아래에 표시된 설정 키를 대신 입력합니다.
4. 앱에 표시된 6자리 코드를 입력하고 **확인하고 켜기**를 누릅니다. 이 코드가 확인되기 전에는 로그인이 바뀌지 않습니다.
5. **백업 코드**를 저장합니다. 복사하거나 텍스트 파일로 다운로드한 뒤 **저장했어요**를 누릅니다. 백업 코드는 이때 한 번만 보여 줍니다.

## 로그인

비밀번호를 입력하면 인증 앱의 코드를 묻습니다. 휴대폰이 없으면 **백업 코드**로 바꿔 백업 코드 하나를 입력합니다. 코드마다 한 번만 쓸 수 있습니다.

**이 브라우저는 30일 동안 묻지 않기**를 체크하면 이 브라우저에서는 30일 동안 코드를 묻지 않습니다. 내 컴퓨터에서만 쓰세요.

MCP로 연결하는 AI 에이전트나 Mocco Notes처럼 앱을 연결하려고 로그인하던 중이었다면, 코드를 입력한 뒤 비밀번호만 입력했을 때와 똑같이 연결이 이어집니다.

틀린 코드를 입력할 수 있는 횟수는 제한됩니다. 여러 번 연달아 틀리면 다시 로그인해야 하고, 더 틀리면 코드 단계가 잠시 잠깁니다.

## 백업 코드

백업 코드는 10개입니다. 몇 개를 썼거나 누가 봤다고 생각되면 계정 설정 페이지에서 **백업 코드 새로 받기**를 누르고 비밀번호를 입력해 바꿉니다. 기존 코드는 바로 쓸 수 없게 됩니다.

## 끄기

계정 설정 페이지에서 **끄기**를 누르고 비밀번호를 입력합니다. 다음 로그인부터는 비밀번호만 묻습니다.

## 워크스페이스에 필수로 하기

소유자는 워크스페이스의 모든 멤버에게 2단계 인증을 필수로 할 수 있어요. **설정**에서 **2단계 인증**을 찾아 **2단계 인증 필수로 하기**를 누르세요. 먼저 내 계정의 2단계 인증을 켜야 해요. 켜기 전에는 버튼이 꺼져 있고 계정 설정으로 가는 링크가 보여요. 관리자와 멤버는 필수인지 볼 수만 있고 바꿀 수는 없어요.

필수로 하면 2단계 인증을 켜지 않은 멤버도 로그인은 할 수 있지만, 이 워크스페이스에서는 **계속하려면 2단계 인증을 켜 주세요** 화면과 계정 설정 링크가 보여요. AI 에이전트(MCP)와 Mocco Work도 이 워크스페이스에서는 거절돼요. 계정에서 켜고 돌아오면 다시 모두 쓸 수 있어요. 다른 워크스페이스에는 영향이 없고, API 키는 그대로 동작해요.

소유자와 관리자는 **멤버**에서 사람마다 **2단계 인증 켬** 또는 **2단계 인증 끔**으로 누가 켰는지 볼 수 있어요. 필수 설정을 켜고 끄면 워크스페이스 [감사 로그](https://www.mocco.club/docs/ko/articles/2yiscf-audit-log)에 남아요.

필수를 해제하려면 같은 곳에서 **필수 해제**를 누르세요.

## 워크스페이스에 남는 기록

켜기, 끄기, 백업 코드 새로 받기, 백업 코드로 로그인하기는 내가 속한 모든 워크스페이스의 [감사 로그](https://www.mocco.club/docs/ko/articles/2yiscf-audit-log)에 항목을 하나씩 남깁니다(`account.two_factor.*`). 항목에는 누가 무엇을 했는지만 남고 코드는 남지 않습니다.

에이전트는 내 2단계 인증이 켜져 있는지 읽을 수 있지만(`mocco_account_get`), 켜거나 끄거나 코드를 볼 수는 없습니다. 이 작업은 계정 설정 페이지에서만 할 수 있습니다.