Gitbook

GitBook Import 설정 가이드

개요

AiTalk.ch의 GitBook Import 기능을 사용하면 GitBook에 작성된 문서를 AI 에이전트의 지식 베이스로 가져올 수 있습니다.

---

1. Access Token 발급 방법

GitBook Developer Settings에서 Access Token을 발급받아야 합니다.

발급 절차:

1. GitBook에 로그인합니다

2. 좌측 하단의 Settings 아이콘(⚙️)을 클릭합니다

3. Settings → Developer Settings로 이동합니다

4. Personal Access Tokens 섹션에서 Create new token을 클릭합니다

5. 토큰 이름을 입력하고 생성합니다

6. 생성된 토큰을 복사하여 AiTalk.ch의 Access Token 필드에 붙여넣습니다

⚠️ 주의: 토큰은 생성 시 한 번만 표시됩니다. 안전한 곳에 보관하세요.

---

2. Space ID 찾는 방법

Space ID는 GitBook의 특정 문서 공간을 식별하는 고유 코드입니다.

방법 1: URL에서 확인

• GitBook 문서 편집 화면의 URL을 확인합니다

• 형식: https://app.gitbook.com/s/[Space ID]/...

• 예: https://app.gitbook.com/s/XF5Q8drxdQOBisGrmGGu/ → Space ID는 XF5Q8drxdQOBisGrmGGu

방법 2: Space Settings에서 확인

1. GitBook에서 해당 Space를 엽니다

2. 좌측 하단의 Space Settings (⚙️)를 클릭합니다

3. General 탭에서 Space ID를 확인할 수 있습니다

---

3. Published Base URL 설정

GitBook을 커스텀 도메인으로 퍼블리시한 경우 해당 URL을 입력합니다.

• 예: https://docs.example.com/

• GitBook 기본 도메인을 사용하는 경우: https://[조직명].gitbook.io/[space명]/

---

4. 연결 테스트

모든 정보를 입력한 후:

1. Save Settings를 클릭하여 설정을 저장합니다

2. Test Connection을 클릭하여 연결이 정상적인지 확인합니다

3. "Connected" 상태가 표시되면 설정 완료입니다

---

문제 해결

증상	해결 방법
연결 실패	Access Token이 올바른지 확인하세요
Space를 찾을 수 없음	Space ID가 정확한지 확인하세요
문서를 불러올 수 없음	GitBook Space가 퍼블리시되어 있는지 확인하세요