# 문제 해결

> AI 답변이 멈추거나, 생성 버튼이 안 눌리거나, 파일이 읽히지 않거나, 연결이 끊길 때 증상별로 고치는 방법이에요.

무언가 생각대로 되지 않을 때 증상을 찾아 순서대로 확인하세요. 화면에 뜨는 안내 문구는 굵게, 화면에 보이는 그대로 적었어요. 짧은 질문과 답은 [자주 묻는 질문](https://manyfast.io/docs/help/faq)에 있어요.

## AI와 크레딧

### AI 답변이 멈추거나 실패할 때

채팅 답변이 끊기거나 오류 카드가 뜨면, 카드 제목을 보고 아래처럼 해요.

| 카드 제목 | 할 일 |
|---|---|
| **인터넷 연결이 끊겼어요** | 연결을 확인하고 **다시 시도**를 눌러요. 쓰던 내용은 남아 있어요. |
| **서버에 일시적인 문제가 있어요** | **새 채팅에서 다시 시도**를 눌러요. 마지막으로 보낸 질문이 새 채팅 입력창에 채워져요. |
| **응답 시간이 초과되었어요** | **새 채팅에서 다시 시도**를 누르거나, 요청을 더 짧게 나눠 보내요. |
| **다른 AI 작업이 진행 중이에요** | 유저플로우 생성이나 문서 분석이 끝난 뒤 다시 시도해요. |
| **요청을 완료하지 못했어요** | **다시 시도**를 누르거나 요청을 작게 나눠 보내요. |
| **문제가 발생했어요** | **새 채팅에서 다시 시도**를 눌러요. 계속되면 페이지를 새로고침해요. |

큰 작업이 한도에 닿아 멈추면 입력창 위에 **작업이 한도에 도달해 잠시 멈췄어요**라는 안내와 함께 **이어서 작업하기**가 떠요. 누르면 남은 작업을 이어서 해요.

답변을 직접 멈추려면 답변 중에 보내기 버튼 자리에 생기는 정지 버튼(**생성 중지**)을 눌러요. 멈춘 자리에 **답변을 멈췄어요**가 남아요. 같은 질문을 다시 하려면 입력창에 적어 다시 보내요.

> [!TIP]
> 답변 도중 AI가 기획서를 고치기 시작했다면, 다시 요청하기 전에 승인 대기 중인 제안부터 확인하세요. 같은 수정이 두 번 들어가는 것을 막을 수 있어요. 제안을 처리하는 방법은 [AI 제안 승인하기](https://manyfast.io/docs/ai/suggestions)에 있어요.

### 크레딧이 부족할 때

크레딧을 다 쓰면 채팅 입력창 위에 안내가 떠요.

- **오늘 쓸 수 있는 크레딧을 모두 썼어요**: 일일 크레딧은 매일 자정(한국 시간)에 다시 채워져요. 바로 이어서 쓰려면 **플랜 업그레이드** 또는 **크레딧 추가 구매**를 눌러요.
- **크레딧을 모두 썼어요**: **크레딧 추가 구매**를 누르면 바로 이어서 쓸 수 있어요.

남은 크레딧은 상단바의 플랜 배지 버튼을 누르면 열리는 크레딧 창에서, 어디에 썼는지는 **그룹 관리** > **크레딧**의 **크레딧 사용 내역**에서 볼 수 있어요.

> [!IMPORTANT]
> 크레딧 추가 구매와 요금제 변경은 그룹 오너만 할 수 있어요. 오너가 아니라면 오너에게 요청하세요. 크레딧 규칙은 [크레딧](https://manyfast.io/docs/account/credits)에 있어요.

### AI를 쓸 수 없다는 안내가 뜰 때

**AI 사용 권한이 없어요**가 뜨면 아래 문구로 원인을 구분해요.

- **열람 권한만 있는 프로젝트에서는 AI를 사용할 수 없어요**: 이 프로젝트를 볼 권한만 있어요. AI를 쓰려면 편집 권한이 필요해요. 그룹에서 뷰어라면 그룹 오너나 관리자에게 역할을 멤버 이상으로 바꿔 달라고 요청하고, 보기 권한으로 공유받았다면 프로젝트 소유자에게 편집 권한을 요청해요. 역할별로 할 수 있는 일은 [역할과 권한](https://manyfast.io/docs/team/roles)에 있어요.
- **이 프로젝트에서 AI 크레딧을 사용할 권한이 없어요**: 그룹 밖에서 이 프로젝트를 공유받은 외부 편집자예요. 프로젝트 소유자에게 **AI 크레딧 사용 허용**을 켜 달라고 요청해요. 자세한 내용은 [외부 편집자 초대하기](https://manyfast.io/docs/team/external-editors)에 있어요.

휴대폰에서 에디터를 열면 채팅 자리에 **채팅은 PC에서 할 수 있어요.**가 보여요. **PC로 링크 받기**를 눌러 컴퓨터에서 같은 계정으로 이어서 하세요.

## 생성과 검토

### 유저플로우·와이어프레임 생성 버튼이 안 눌릴 때

**유저플로우**는 아래 조건을 모두 채워야 만들 수 있어요.

1. PRD 개요와 기능명세서가 있어야 해요. 비어 있으면 **PRD와 기능명세서를 먼저 작성해 주세요**가 뜨고, **PRD 작성**과 **기능명세서 작성** 버튼으로 그 탭에 갈 수 있어요.
2. 컴퓨터 화면에서 만들어요. 휴대폰에서는 **생성은 데스크톱에서 할 수 있어요.**가 보여요.
3. 그 프로젝트의 편집 권한이 있어야 해요. 뷰어나 공유 링크로 보는 중이면 만들 수 없어요.
4. 크레딧이 남아 있어야 해요. 부족하면 **크레딧이 부족합니다.**가 떠요.
5. 다른 AI 작업이 끝나 있어야 해요. 진행 중이면 **다른 AI 작업이 진행 중입니다. 완료 후 다시 시도해주세요.**가 떠요.

**와이어프레임**은 유저플로우를 바탕으로 만들어요.

1. 유저플로우가 없으면 **유저플로우를 먼저 만들어 주세요**가 떠요. **유저플로우로 이동**을 눌러 먼저 만들어요.
2. 컴퓨터 화면에서 만들고, 편집 권한이 있어야 해요. 권한이 없으면 **읽기 전용으로 보고 있어요.**가 보여요.
3. 생성 창에서 버튼이 잠겨 있으면 요약 줄 오른쪽에 이유가 보여요. **무료 생성을 다 썼어요**는 무료로 만들 수 있는 장 수를 다 쓴 상태예요. 크레딧이 모자라면 모자란 양이, 무료로 만들 수 있는 장 수를 넘겼다면 넘긴 장 수가 보여요. 고를 페이지를 줄이거나, 크레딧을 채우거나, 요금제를 올려요.

자세한 만드는 법은 [유저플로우](https://manyfast.io/docs/plan/user-flow)와 [와이어프레임](https://manyfast.io/docs/plan/wireframe)에 있어요.

### 기획 검토가 안 될 때

레일의 **검토**가 흐리거나 검토가 시작되지 않으면 확인해요.

1. **PRD** 또는 **기능명세서** 탭에 있어야 해요. 다른 탭에서는 **PRD와 기능명세서 탭에서만 검토할 수 있어요**가 떠요.
2. 기획 항목이 3개 이상 있어야 해요. 모자라면 **검토하려면 기획 항목이 3개 이상 필요해요**가 떠요. PRD, 요구사항, 기능을 조금 더 써요.
3. 편집 권한이 있어야 하고, 새 프로젝트의 첫 초안 만들기가 끝난 뒤에 열 수 있어요.
4. 크레딧이 남아 있어야 해요. 부족하면 **크레딧이 부족해 검토를 시작할 수 없어요.**와 함께 **크레딧 충전·플랜 보기**가 떠요.
5. 이미 검토가 돌고 있으면 **이미 검토가 진행 중이에요. 잠시 후 다시 시도해 주세요.**가 떠요. 끝날 때까지 기다려요.

> [!IMPORTANT]
> Starter 요금제는 개발 관점만 검토해요. 사업, UX, 디자인, QA, 보안 관점은 Pro 요금제부터 받을 수 있어요.

자세한 내용은 [기획 검토 받기](https://manyfast.io/docs/ai/plan-review)에 있어요.

## 파일과 연결

### 파일이 읽히지 않을 때

프로젝트 자료는 에디터 레일의 **문서함** > **자료** 탭에서 올리고 상태를 봐요. 카드의 상태 표시로 원인을 좁혀요.

![문서함 패널의 자료 탭. 일부 읽힘 표시가 붙은 자료 카드에 읽은 비율, 못 읽은 페이지, AI로 읽기 버튼이 있고, 다 읽은 자료 카드에는 따로 표시가 없다.](https://manyfast.io/content-assets/docs-panel.files-C7hPTh9G.webp)

**올리자마자 거절될 때**

- **이 형식은 올릴 수 없어요**: 안내에 적힌 형식의 파일만 올릴 수 있어요.
- **파일이 50MB를 넘어요**: 50MB 이하로 나눠 올려요.
- **빈 파일이에요**: 내용이 있는 파일을 골라요.
- **자료를 올릴 권한이 없어요**: 편집 권한이 있는 멤버에게 올려 달라고 요청해요.

**카드가 실패로 바뀔 때**는 카드 아래 적힌 이유를 따라요.

- 암호가 걸린 파일은 암호를 푼 뒤 다시 올려요.
- 손상됐거나 형식이 맞지 않으면 원래 프로그램에서 다시 저장해 올려요.
- 구형 xls, doc, ppt 파일은 xlsx, docx, pptx로 다시 저장해 올려요.
- 너무 크거나 읽는 데 오래 걸리면 파일을 나눠 올려요. 파일 하나는 500쪽까지 읽어요.

**일부 읽힘이거나 이미지로 된 페이지일 때**

1. 카드의 **AI로 읽기**를 눌러요.
2. **AI로 읽기 견적**에서 대상 페이지와 크레딧을 확인해요.
3. **AI로 읽기 시작**을 눌러요. 끝나면 카드의 읽은 비율이 바뀌어요.

AI로 읽기는 카드에 **AI로 읽기**가 보이는 자료에서만 쓸 수 있고 크레딧이 들어요. 실제로 읽은 페이지만큼만 빠지고 남은 크레딧은 돌려받아요.

**한도에 닿았을 때**

- **자료 해석 한도를 모두 썼어요**: 요금제를 올리면 더 많이 읽을 수 있어요. 매달 채워지는 요금제는 다음 달 1일에 다시 채워져요. 올린 자료는 그대로 남아요. 요금제별 한도는 [요금제 비교하기](https://manyfast.io/docs/account/plans#files)에서 확인해요.
- **보관 한도를 넘어요**: 쓰지 않는 자료를 지우거나, 그룹 오너나 관리자에게 휴지통의 프로젝트를 영구 삭제해 달라고 요청한 뒤 다시 올려요.

채팅에 바로 붙이는 파일은 한 번에 하나만 붙일 수 있어요. 붙일 수 있는 형식은 [파일과 자료 붙이기](https://manyfast.io/docs/ai/chat#attach)에 있어요. 자세한 내용은 [프로젝트 자료 올리기](https://manyfast.io/docs/sources/project-files)에 있어요.

### AI 도구 연결이 만료되거나 인증 오류가 날 때

ChatGPT, Claude, Cursor 같은 AI 도구에서 매니패스트에 로그인하는 창이 오류를 보여 주면, 문구에 따라 해요.

- **AI 도구에 저장된 매니패스트 연결 정보가 만료됐거나 더 이상 쓸 수 없어요.**
  1. 이 창을 닫아요.
  2. 쓰는 AI 도구에서 매니패스트 연결의 로그인 정보를 지워요.
  3. 다시 연결해요.

  Claude Code라면 창에 보이는 명령을 **명령 복사**로 복사해 터미널에서 실행한 뒤 다시 연결해요. 기본 연결 이름이면 명령은 `claude mcp logout manyfast`예요. 연결 이름을 바꿔 추가했다면 `manyfast` 대신 그 이름을 넣어요.
- **유효하지 않은 인증 요청입니다**: 이 창을 닫고 AI 도구에서 새로 연결을 시작해요.
- **연결을 거부했어요**: 승인하지 않은 상태예요. 준비되면 AI 도구에서 새로 연결을 시작하고 **이 계정으로 연결**을 눌러요.

다른 계정으로 연결하려면 로그인 창에서 **이 계정으로 계속** 대신 **다른 계정으로 로그인**을 눌러요.

> [!IMPORTANT]
> 연결해도 내 계정의 권한이 넓어지지 않아요. 그룹에서 뷰어라면 AI 도구로 읽기만 할 수 있어요. AI 도구로 직접 쓸 수 있는 범위는 그룹의 요금제에 따라 달라요. [요금제 비교](https://manyfast.io/docs/account/plans#planning)를 참고해요.

도구별 연결 방법은 [AI 도구 연결하기](https://manyfast.io/docs/connect/mcp)에 있어요.

### 앱 안 브라우저에서 Google 로그인이 안 될 때

카카오톡, 네이버, 인스타그램 같은 앱 안의 브라우저에서 로그인 화면을 열면 **외부 브라우저에서 열어주세요**와 **현재 앱 내 브라우저에서는 Google 로그인이 지원되지 않습니다.**가 떠요. 아래 중 하나로 해요.

1. 안내에 적힌 방법대로 앱 메뉴에서 다른 브라우저로 열어요. 예를 들어 카카오톡은 오른쪽 위 ··· 메뉴의 '다른 브라우저로 열기'를 골라요.
2. **외부 브라우저로 열기** 버튼이 보이면 눌러요.
3. **링크 복사**를 눌러 Chrome이나 Safari 주소창에 붙여 넣어요.
4. 이메일로 가입했다면 그 화면에서 바로 이메일로 로그인해요.

가입과 로그인 방법은 [가입하고 로그인하기](https://manyfast.io/docs/start/sign-up)에 있어요.

### 휴대폰에서 튜토리얼이 열리지 않을 때

튜토리얼은 컴퓨터 화면에서 직접 따라 하도록 만들었어요. 휴대폰에서는 홈에서 튜토리얼을 미리 볼 수 있어요.

휴대폰에서 **튜토리얼은 PC에서 열어 주세요**가 뜨면:

1. **내 메일로 링크 받기**를 눌러 링크를 메일로 받거나, **링크 복사**를 눌러 메모에 붙여 둬요. **내 메일로 링크 받기**는 로그인해 있을 때만 보여요.
2. 컴퓨터에서 링크를 열고 같은 계정으로 로그인해요.

휴대폰에서 미리 보려면 **홈으로**를 눌러요. 튜토리얼 내용은 [튜토리얼로 둘러보기](https://manyfast.io/docs/start/tutorial)에 있어요.

## 그래도 해결되지 않으면

1. 홈이나 모든 프로젝트 화면 상단바의 **피드백**을 눌러요.
2. **피드백/문의 보내기** 창에서 피드백 유형을 **버그 제보**로 골라요.
3. **제목**과 **내용**을 채워요. 무엇을 하다가 어떤 문제가 생겼는지, 화면에 뜬 문구를 함께 적어요.
4. **보내기**를 눌러요.

회신은 알림함과 메일로 와요.

## 다음 단계

- [자주 묻는 질문](https://manyfast.io/docs/help/faq)
- [AI와 채팅하기](https://manyfast.io/docs/ai/chat)
- [크레딧](https://manyfast.io/docs/account/credits)
- [역할과 권한](https://manyfast.io/docs/team/roles)

원문: https://manyfast.io/docs/help/troubleshooting
