# 13. AI 연결

# AI 앱 연결하기

<span style="font-size: 16px;">**관리자 페이지 \[홈페이지 설정\] / \[AI 연동 API\]**  
  
</span>

<span style="font-size: 16px;">ChatGPT, Claude 등의 AI 앱이나 Claude Code, Codex 등의 터미널 도구에 홈페이지를 연결하면 대화로 페이지를 만들고 수정할 수 있습니다.</span>

<span style="font-size: 16px;">AI 앱은 닷홈 연결 서버를 거쳐 홈페이지에 접근하며, 연결할 때 허용한 권한 안에서만 작업합니다. 대부분의 변경 사항은 게시 후 홈페이지에 반영됩니다. (게시판·슬라이드 등 일부는 바로 반영)</span>

[![1bbb35d07f51d6869034ff575188084f.png](https://docs.dothome.co.kr/uploads/images/gallery/2026-11/scaled-1680-/1bbb35d07f51d6869034ff575188084f.png)](https://docs.dothome.co.kr/uploads/images/gallery/2026-11/1bbb35d07f51d6869034ff575188084f.png)

<span style="font-size: 16px;">관리자 페이지 상단 메뉴의 \[홈페이지 설정\]을 클릭하고 좌측 메뉴에서 \[AI 연동 API\]를 선택합니다.</span>

<span style="font-size: 16px;">\[AI 연결\] 탭에서 \[+ AI 앱 연결\]을 누르면 앱 선택 → 권한 설정 → 연결 3단계로 연결합니다. (약 2분)</span>

<span style="color: rgb(51, 51, 51); font-size: 18px; font-weight: 700;">● </span><span style="font-weight: bolder; color: rgb(51, 51, 51); font-size: 18px;">연결하기 전에 확인해주세요</span>

<span style="font-size: 16px;">· 연결 추가·연장·해제는 최고 관리자만 할 수 있으며, 일반 관리자는 목록만 조회할 수 있습니다.</span>

<span style="font-size: 16px;">· 홈페이지 주소는 닷홈 기본 주소(https://(계정 아이디).dothome.co.kr)로 연결합니다. 독자 도메인 주소로는 연결할 수 없습니다.</span>

<span style="font-size: 16px;">· AI 연결과 개발자용 키는 합쳐서 5개까지 사용할 수 있습니다.</span>

<span style="color: rgb(51, 51, 51); font-size: 18px; font-weight: 700;">● </span><span style="font-weight: bolder; color: rgb(51, 51, 51); font-size: 18px;">1단계 - 앱 선택</span>

<span style="font-size: 16px;">연결할 앱을 선택합니다.</span>

[![4ec8769ca1e604f8771773fb59ac155b.png](https://docs.dothome.co.kr/uploads/images/gallery/2026-11/scaled-1680-/4ec8769ca1e604f8771773fb59ac155b.png)](https://docs.dothome.co.kr/uploads/images/gallery/2026-11/4ec8769ca1e604f8771773fb59ac155b.png)

<table class="table table-bordered" id="bkmrk-%EC%95%B1%EC%84%A4%EB%AA%85chatgptopenaiclau"><tbody><tr><td style="width: 28%;"><span style="font-size: 16px;">**앱**</span></td><td><span style="font-size: 16px;">**설명**</span></td></tr><tr><td><span style="color: rgb(33, 37, 41); font-size: 16px;">ChatGPT</span></td><td><span style="color: rgb(33, 37, 41); font-size: 16px;">OpenAI</span></td></tr><tr><td><span style="color: rgb(33, 37, 41); font-size: 16px;">Claude</span></td><td><span style="color: rgb(33, 37, 41); font-size: 16px;">Anthropic · 웹·데스크톱·모바일</span></td></tr><tr><td><span style="color: rgb(33, 37, 41); font-size: 16px;">Claude Code</span></td><td><span style="color: rgb(33, 37, 41); font-size: 16px;">Anthropic · 터미널 도구</span></td></tr><tr><td><span style="color: rgb(33, 37, 41); font-size: 16px;">Codex</span></td><td><span style="color: rgb(33, 37, 41); font-size: 16px;">OpenAI · 터미널 도구</span></td></tr><tr><td><span style="color: rgb(33, 37, 41); font-size: 16px;">기타 MCP 앱</span></td><td><span style="color: rgb(33, 37, 41); font-size: 16px;">OAuth 로그인을 지원하는 앱 (Hermes Agent 등)</span></td></tr></tbody></table>

<span style="color: rgb(51, 51, 51); font-size: 18px; font-weight: 700;">● </span><span style="font-weight: bolder; color: rgb(51, 51, 51); font-size: 18px;">2단계 - 권한 설정</span>

<span style="font-size: 16px;">AI에게 허용할 권한을 선택합니다. \[홈페이지 내용 조회\]는 항상 포함되며, 처음에는 \[문구·이미지·링크 수정\]과 \[페이지·메뉴·섹션 생성·삭제\]가 선택되어 있습니다.</span>

[![d4c85534e9d73696691a58a0f93de945.png](https://docs.dothome.co.kr/uploads/images/gallery/2026-11/scaled-1680-/d4c85534e9d73696691a58a0f93de945.png)](https://docs.dothome.co.kr/uploads/images/gallery/2026-11/d4c85534e9d73696691a58a0f93de945.png)

<table class="table table-bordered" id="bkmrk-%EA%B6%8C%ED%95%9C%EC%84%A4%EB%AA%85%ED%99%88%ED%8E%98%EC%9D%B4%EC%A7%80-%EB%82%B4%EC%9A%A9-%EC%A1%B0%ED%9A%8C%ED%8E%98%EC%9D%B4%EC%A7%80%C2%B7%EB%A9%94%EB%89%B4"><tbody><tr><td style="width: 28%;"><span style="font-size: 16px;">**권한**</span></td><td><span style="font-size: 16px;">**설명**</span></td></tr><tr><td><span style="color: rgb(33, 37, 41); font-size: 16px;">홈페이지 내용 조회</span></td><td><span style="color: rgb(33, 37, 41); font-size: 16px;">페이지·메뉴·디자인·설정·작업 기록을 조회합니다. (항상 포함)</span></td></tr><tr><td><span style="color: rgb(33, 37, 41); font-size: 16px;">문구·이미지·링크 수정</span></td><td><span style="color: rgb(33, 37, 41); font-size: 16px;">페이지의 문구·이미지·링크·지도와 푸터 문구를 수정합니다.  
푸터 문구는 모든 페이지에 적용됩니다.</span></td></tr><tr><td><span style="color: rgb(33, 37, 41); font-size: 16px;">페이지·메뉴·섹션 생성·삭제</span></td><td><span style="color: rgb(33, 37, 41); font-size: 16px;">페이지·메뉴·섹션·항목을 생성·삭제하고 순서를 변경합니다.  
블록 설정(갤러리·슬라이드 등)과 페이지 삭제 시 함께 삭제되는 블록 내용은 바로 반영됩니다. 새 게시판은 생성 즉시 공개되며 AI가 삭제할 수 없습니다.</span></td></tr><tr><td><span style="color: rgb(33, 37, 41); font-size: 16px;">디자인 변경</span></td><td><span style="color: rgb(33, 37, 41); font-size: 16px;">전체 디자인(글꼴·색·너비), 헤더·푸터·서브메뉴·타이틀 영역, 섹션·항목 디자인을 변경합니다.  
전체 디자인과 헤더·푸터·서브메뉴·타이틀 영역은 모든 페이지에 적용됩니다.</span></td></tr><tr><td><span style="color: rgb(33, 37, 41); font-size: 16px;">게시</span></td><td><span style="color: rgb(33, 37, 41); font-size: 16px;">게시하면 다른 사람이 수정한 내용까지 해당 언어 전체가 함께 공개됩니다. 허용하지 않으면 관리자가 디자인 편집에서 게시합니다.</span></td></tr><tr><td><span style="color: rgb(33, 37, 41); font-size: 16px;">이미지 업로드·삭제</span></td><td><span style="color: rgb(33, 37, 41); font-size: 16px;">삭제한 이미지는 복구할 수 없으며, 해당 이미지를 사용하던 곳에 바로 표시되지 않습니다.</span></td></tr><tr><td><span style="color: rgb(33, 37, 41); font-size: 16px;">게시판·게시글 관리</span></td><td><span style="color: rgb(33, 37, 41); font-size: 16px;">게시판 설정을 변경하고 게시글을 조회·작성·수정·삭제합니다.  
게시 없이 바로 반영되며, 삭제한 게시글·댓글·첨부파일은 복구할 수 없습니다.</span></td></tr><tr><td><span style="color: rgb(33, 37, 41); font-size: 16px;">홈페이지 설정·팝업·언어</span></td><td><span style="color: rgb(33, 37, 41); font-size: 16px;">기본 설정과 SEO 설정을 변경하고, 팝업을 관리하고, 언어를 추가합니다.  
게시 없이 바로 반영되며 이전 상태로 되돌릴 수 없습니다. 추가한 언어는 AI가 삭제할 수 없습니다.</span></td></tr><tr><td><span style="color: rgb(33, 37, 41); font-size: 16px;">코드 입력</span></td><td><span style="color: rgb(33, 37, 41); font-size: 16px;">코드블럭과 공통코드(모든 페이지에 삽입되는 코드)를 입력·수정합니다.  
입력한 스크립트는 방문자 브라우저에서 실행됩니다. 공통코드는 게시 없이 바로 반영됩니다.</span></td></tr></tbody></table>

<table class="table table-bordered" id="bkmrk-%ED%95%AD%EB%AA%A9%EC%84%A4%EB%AA%85%EC%97%B0%EA%B2%B0-%EC%9D%B4%EB%A6%84%EB%B0%94%EB%80%90-%EB%82%B4%EC%9A%A9%EA%B3%BC-%EA%B2%8C%EC%8B%9C%EA%B8%80-"><tbody><tr><td style="width: 28%;"><span style="font-size: 16px;">**항목**</span></td><td><span style="font-size: 16px;">**설명**</span></td></tr><tr><td><span style="color: rgb(33, 37, 41); font-size: 16px;">연결 이름</span></td><td><span style="color: rgb(33, 37, 41); font-size: 16px;">바뀐 내용과 게시글 작성자에 표시됩니다. 여러 컴퓨터에서 사용한다면 구분할 수 있게 입력해주세요. (예: Codex 연결 - 회사 서버)</span></td></tr><tr><td><span style="color: rgb(33, 37, 41); font-size: 16px;">사용 기간</span></td><td><span style="color: rgb(33, 37, 41); font-size: 16px;">3개월·6개월·1년 중에서 선택합니다. 만료 전에 연장할 수 있습니다.</span></td></tr></tbody></table>

<span style="color: rgb(51, 51, 51); font-size: 18px; font-weight: 700;">● </span><span style="font-weight: bolder; color: rgb(51, 51, 51); font-size: 18px;">3단계 - 연결</span>

<span style="font-size: 16px;">\[API 키 발급\]을 누르면 API 키가 발급되고, 선택한 앱의 연결 방법이 표시됩니다. **API 키는 지금 한 번만 표시됩니다.**</span>

[![0e6da9a96b8d0102bc0a9902d280f8b7.png](https://docs.dothome.co.kr/uploads/images/gallery/2026-11/scaled-1680-/0e6da9a96b8d0102bc0a9902d280f8b7.png)](https://docs.dothome.co.kr/uploads/images/gallery/2026-11/0e6da9a96b8d0102bc0a9902d280f8b7.png)

<span style="font-size: 16px;">1. 앱의 MCP 서버(커넥터) 추가 화면에 아래 주소를 입력하고, 인증 방식은 OAuth를 선택합니다.</span>

<span style="font-size: 16px;"> `https://buildermcp.dothome.co.kr/mcp`</span>

<span style="font-size: 16px;">2. 닷홈 연결 화면이 열리면 사이트 주소와 API 키를 입력하고 \[연결\]을 누릅니다.</span>

<span style="font-size: 16px;">3. 연결이 확인되면 "✓ 연결이 확인되었습니다."가 표시되고, \[연결된 앱\]에 \[연결됨\]으로 나타납니다.</span>

<span style="color: rgb(99, 99, 99); font-size: 16px;">\* API 키는 닷홈 연결 화면에만 입력하고, 대화창이나 터미널에는 붙여 넣지 마세요.</span>

<span style="color: rgb(99, 99, 99); font-size: 16px;">\* API 키는 닷홈 연결 서버에서만 사용할 수 있어, 유출되어도 다른 곳에서는 사용할 수 없습니다.</span>

<span style="color: rgb(99, 99, 99); font-size: 16px;">\* 연결을 마칠 때까지 이 화면을 닫지 마세요. 키를 분실한 경우 연결을 해제하고 다시 연결해주세요. 여러 사이트를 함께 쓰던 연결이면 닷홈 연결 화면에 그 사이트들의 키도 함께 입력해주세요. 분실한 키는 그 사이트에서 새로 발급해주세요.</span>

<span style="color: rgb(99, 99, 99); font-size: 16px;">\* 앱별 자세한 연결 방법은 [\[AI 앱별 연결 방법\]](https://docs.dothome.co.kr/books/13-ai/page/ai-qFk)을 참고해주세요.</span>

<span style="color: rgb(51, 51, 51); font-size: 18px; font-weight: 700;">● </span><span style="font-weight: bolder; color: rgb(51, 51, 51); font-size: 18px;">연결된 앱</span>

<span style="font-size: 16px;">연결한 앱은 \[AI 연결\] 탭의 \[연결된 앱\]에 표시됩니다.</span>

<table class="table table-bordered" id="bkmrk-%EC%83%81%ED%83%9C%EC%84%A4%EB%AA%85%EC%97%B0%EA%B2%B0-%EB%8C%80%EA%B8%B0%EB%8B%B7%ED%99%88-%EC%97%B0%EA%B2%B0-%ED%99%94%EB%A9%B4%EC%97%90%EC%84%9C-"><tbody><tr><td style="width: 28%;"><span style="font-size: 16px;">**상태**</span></td><td><span style="font-size: 16px;">**설명**</span></td></tr><tr><td><span style="color: rgb(33, 37, 41); font-size: 16px;">연결 대기</span></td><td><span style="color: rgb(33, 37, 41); font-size: 16px;">닷홈 연결 화면에서 API 키를 아직 입력하지 않았습니다.</span></td></tr><tr><td><span style="color: rgb(33, 37, 41); font-size: 16px;">연결됨</span></td><td><span style="color: rgb(33, 37, 41); font-size: 16px;">앱이 홈페이지에 연결되었습니다.</span></td></tr><tr><td><span style="color: rgb(33, 37, 41); font-size: 16px;">N일 후 만료</span></td><td><span style="color: rgb(33, 37, 41); font-size: 16px;">사용 기간이 얼마 남지 않았습니다. \[기간 연장\]으로 연장할 수 있습니다.</span></td></tr></tbody></table>

<span style="font-size: 16px;">기간 연장과 연결 해제는 [\[연결 연장·해제하기\]](https://docs.dothome.co.kr/books/13-ai/page/1651c)를 참고해주세요.</span>

# AI 앱별 연결 방법

<span style="font-size: 16px;">**관리자 페이지 \[홈페이지 설정\] / \[AI 연동 API\] / \[AI 연결\]**  
  
</span>

<span style="font-size: 16px;">AI 앱 연결 3단계에서 선택한 앱의 연결 방법이 표시됩니다. 모든 앱은 같은 닷홈 연결 서버 주소를 사용합니다.</span>

<span style="font-size: 16px;"> `https://buildermcp.dothome.co.kr/mcp`</span>

<span style="color: rgb(51, 51, 51); font-size: 18px; font-weight: 700;">● </span><span style="font-weight: bolder; color: rgb(51, 51, 51); font-size: 18px;">앱별 연결 방법</span>

<table class="table table-bordered" id="bkmrk-%EC%95%B1%EC%97%B0%EA%B2%B0-%EB%B0%A9%EB%B2%95claude%28%EC%9B%B9%C2%B7%EB%8D%B0%EC%8A%A4%ED%81%AC%ED%86%B1%C2%B7"><tbody><tr><td style="width: 28%;"><span style="font-size: 16px;">**앱**</span></td><td><span style="font-size: 16px;">**연결 방법**</span></td></tr><tr><td><span style="color: rgb(33, 37, 41); font-size: 16px;">Claude  
(웹·데스크톱·모바일)</span></td><td><span style="color: rgb(33, 37, 41); font-size: 16px;">설정 › 커넥터 › 사용자 지정 커넥터 추가 → 서버 주소 입력 → \[연결\] → 닷홈 연결 화면.  
대화에서 그 커넥터를 켭니다. Free 요금제는 커넥터 1개, Team·Enterprise는 관리자가 먼저 추가합니다.</span></td></tr><tr><td><span style="color: rgb(33, 37, 41); font-size: 16px;">ChatGPT</span></td><td><span style="color: rgb(33, 37, 41); font-size: 16px;">웹 설정에서 개발자 모드를 켠 뒤 새 앱(커넥터)을 만들고 MCP 서버 주소를 입력, 인증은 OAuth를 선택 → \[연결\] → 닷홈 연결 화면.  
디렉터리 등재 전에는 개발자 모드를 쓸 수 있는 요금제만 연결할 수 있습니다.</span></td></tr><tr><td><span style="color: rgb(33, 37, 41); font-size: 16px;">Claude Code</span></td><td><span style="color: rgb(33, 37, 41); font-size: 16px;">`claude mcp add --transport http dothome https://buildermcp.dothome.co.kr/mcp` 로 등록하고, 아래 \[터미널 도구 로그인\]대로 로그인합니다.</span></td></tr><tr><td><span style="color: rgb(33, 37, 41); font-size: 16px;">Codex</span></td><td><span style="color: rgb(33, 37, 41); font-size: 16px;">`~/.codex/config.toml` 에 `[mcp_servers.dothome]` 과 `url = "https://buildermcp.dothome.co.kr/mcp"` 를 넣고, 아래 \[터미널 도구 로그인\]대로 로그인합니다.</span></td></tr><tr><td><span style="color: rgb(33, 37, 41); font-size: 16px;">기타 MCP 앱</span></td><td><span style="color: rgb(33, 37, 41); font-size: 16px;">OAuth 로그인을 지원하는 앱만 연결할 수 있습니다. 헤더에 키를 넣는 방식만 지원하는 앱은 연결할 수 없으며, OpenAPI·HTTP 호출을 지원한다면 [\[개발자용 키로 API 직접 호출하기\]](https://docs.dothome.co.kr/books/13-ai/page/api)을 이용해주세요.</span></td></tr></tbody></table>

<span style="color: rgb(99, 99, 99); font-size: 16px;">\* 앱마다 메뉴 이름이 다르며, 앱 업데이트에 따라 바뀔 수 있습니다.</span>

<span style="color: rgb(51, 51, 51); font-size: 18px; font-weight: 700;">● </span><span style="font-weight: bolder; color: rgb(51, 51, 51); font-size: 18px;">닷홈 연결 화면</span>

<span style="font-size: 16px;">앱에서 연결을 시작하면 닷홈 연결 화면이 열립니다. 사이트 주소와 API 키를 입력하고 \[연결\]을 누릅니다.</span>

[![539ee0c1b085778ba441c7b27a8a6372.png](https://docs.dothome.co.kr/uploads/images/gallery/2026-11/scaled-1680-/539ee0c1b085778ba441c7b27a8a6372.png)](https://docs.dothome.co.kr/uploads/images/gallery/2026-11/539ee0c1b085778ba441c7b27a8a6372.png)

<span style="font-size: 16px;">· 이 AI 앱에서 쓸 사이트는 **모두 이 화면에 함께** 입력해주세요. (10개까지)</span>

<span style="font-size: 16px;">· 연결할 때마다 입력한 사이트만으로 새 연결이 만들어지며, 이전 연결의 사이트는 옮겨 오지 않습니다.</span>

<span style="font-size: 16px;">· 연결한 뒤에는 AI 앱을 다시 시작해주세요. 열려 있던 대화·터미널 세션은 이전 연결을 계속 사용할 수 있습니다.</span>

<span style="font-size: 16px;">· 키에 IP 제한이 없으면 경고가 표시됩니다. \[AI 연결\] 탭의 \[+ AI 앱 연결\]로 다시 발급하는 것을 권장합니다.</span>

<span style="font-size: 16px;">· 직접 시작하지 않은 연결 화면이 열렸다면 \[거부\]를 누르세요.</span>

<span style="color: rgb(51, 51, 51); font-size: 18px; font-weight: 700;">● </span><span style="font-weight: bolder; color: rgb(51, 51, 51); font-size: 18px;">터미널 도구 로그인</span>

<span style="font-size: 16px;">Claude Code·Codex 등 터미널 도구는 같은 컴퓨터든 SSH로 접속한 서버든 같은 방법으로 로그인합니다.</span>

<span style="font-size: 16px;">1. 로그인 명령을 실행합니다. 연결 주소가 표시되고 입력을 기다립니다.</span>

<span style="font-size: 16px;"> Claude Code: `claude mcp login dothome --no-browser`</span>

<span style="font-size: 16px;"> Codex: `codex mcp login dothome --no-browser`</span>

<span style="font-size: 16px;"> Hermes Agent: `hermes mcp login <서버 이름>`</span>

<span style="font-size: 16px;">2. 그 주소를 브라우저에서 열고, 닷홈 연결 화면에서 사이트 주소와 API 키를 입력해 \[연결\]을 누릅니다.</span>

<span style="font-size: 16px;">3. 같은 컴퓨터에서는 \[연결\]을 누르면 로그인이 완료됩니다. 다른 컴퓨터(서버)라면 브라우저가 http://localhost… 또는 http://127.0.0.1… 로 넘어가며 열리지 않는 화면이 나옵니다. 정상이며, 주소창의 주소 **전체**를 복사해 터미널에 붙여 넣습니다. (Codex는 입력한 내용이 화면에 보이지 않습니다.)</span>

<span style="color: rgb(99, 99, 99); font-size: 16px;">\* \[연결\]을 누른 뒤 5분 안에 붙여 넣어야 합니다. 시간이 지나면 1번부터 다시 진행해주세요.</span>

<span style="color: rgb(99, 99, 99); font-size: 16px;">\* 이 주소는 다른 사람에게 보내지 마세요.</span>

# AI에게 작업 맡기기

<span style="font-size: 16px;">AI에게 홈페이지 작업을 맡기기 전에 아래 내용을 확인해주세요.</span>

<span style="color: rgb(51, 51, 51); font-size: 18px; font-weight: 700;">● </span><span style="font-weight: bolder; color: rgb(51, 51, 51); font-size: 18px;">도구 사용 승인을 '항상 허용'으로 설정하지 마세요</span>

<span style="font-size: 16px;">AI 앱이 도구 사용을 물을 때마다 허용하면, 홈페이지를 바꾸기 전에 어떤 작업인지 확인할 수 있습니다. '항상 허용'으로 설정하면 홈페이지 전체에 적용되는 변경도 확인 없이 진행될 수 있습니다.</span>

<span style="color: rgb(51, 51, 51); font-size: 18px; font-weight: 700;">● </span><span style="font-weight: bolder; color: rgb(51, 51, 51); font-size: 18px;">요청할 때 범위를 분명히 말해주세요</span>

<span style="font-size: 16px;">"회사소개 페이지 본문 맨 위에…"처럼 홈페이지·페이지·위치를 함께 말하면 AI가 엉뚱한 곳을 바꾸지 않습니다.</span>

<span style="color: rgb(51, 51, 51); font-size: 18px; font-weight: 700;">● </span><span style="font-weight: bolder; color: rgb(51, 51, 51); font-size: 18px;">여러 페이지에 함께 적용되는 변경</span>

<span style="font-size: 16px;">아래 항목은 한 페이지가 아니라 여러 페이지에 함께 적용됩니다. AI가 이런 변경을 하기 전에 물으면 범위를 확인하고 답해주세요.</span>

<table class="table table-bordered" id="bkmrk-%EA%B5%AC%EB%B6%84%EB%82%B4%EC%9A%A9%ED%97%A4%EB%8D%94%C2%B7%ED%91%B8%ED%84%B0%EC%83%81%EB%8B%A8-%EB%A9%94%EB%89%B4%C2%B7%EB%A1%9C%EA%B3%A0%2C-%ED%95%98"><tbody><tr><td style="width: 28%;"><span style="font-size: 16px;">**구분**</span></td><td><span style="font-size: 16px;">**내용**</span></td></tr><tr><td><span style="color: rgb(33, 37, 41); font-size: 16px;">헤더·푸터</span></td><td><span style="color: rgb(33, 37, 41); font-size: 16px;">상단 메뉴·로고, 하단 회사 정보 문구, 서브메뉴, 타이틀 영역 사용</span></td></tr><tr><td><span style="color: rgb(33, 37, 41); font-size: 16px;">전체 디자인·코드</span></td><td><span style="color: rgb(33, 37, 41); font-size: 16px;">글꼴·색·너비, 공통코드(모든 페이지에 들어가는 스크립트)</span></td></tr><tr><td><span style="color: rgb(33, 37, 41); font-size: 16px;">홈페이지 설정</span></td><td><span style="color: rgb(33, 37, 41); font-size: 16px;">기본 제목·검색 노출·사이트맵 등 기본 설정과 SEO 설정</span></td></tr><tr><td><span style="color: rgb(33, 37, 41); font-size: 16px;">대표 페이지</span></td><td><span style="color: rgb(33, 37, 41); font-size: 16px;">첫 화면으로 보이는 페이지</span></td></tr><tr><td><span style="color: rgb(33, 37, 41); font-size: 16px;">함께 쓰는 게시판·달력·팝업</span></td><td><span style="color: rgb(33, 37, 41); font-size: 16px;">여러 페이지가 함께 쓰는 게시판·달력의 설정과 분류, 여러 페이지에 걸린 팝업</span></td></tr></tbody></table>

<span style="color: rgb(99, 99, 99); font-size: 16px;">\* ChatGPT의 메모리가 켜져 있으면 이전 대화에서 승낙한 내용을 다음 대화에서 다시 묻지 않을 수 있습니다. 여러 페이지에 적용되는 변경은 대화마다 확인해주세요.</span>

<span style="color: rgb(51, 51, 51); font-size: 18px; font-weight: 700;">● </span><span style="font-weight: bolder; color: rgb(51, 51, 51); font-size: 18px;">게시 후 반영되는 것과 바로 반영되는 것</span>

<table class="table table-bordered" id="bkmrk-%EA%B5%AC%EB%B6%84%EB%82%B4%EC%9A%A9%EA%B2%8C%EC%8B%9C-%ED%9B%84-%EB%B0%98%EC%98%81%ED%8E%98%EC%9D%B4%EC%A7%80%C2%B7%EC%84%B9%EC%85%98%EC%9D%98-%EB%AC%B8"><tbody><tr><td style="width: 28%;"><span style="font-size: 16px;">**구분**</span></td><td><span style="font-size: 16px;">**내용**</span></td></tr><tr><td><span style="color: rgb(33, 37, 41); font-size: 16px;">게시 후 반영</span></td><td><span style="color: rgb(33, 37, 41); font-size: 16px;">페이지·섹션의 문구와 디자인, 페이지 설정, 메뉴, 헤더·푸터, 전체 디자인</span></td></tr><tr><td><span style="color: rgb(33, 37, 41); font-size: 16px;">바로 반영</span></td><td><span style="color: rgb(33, 37, 41); font-size: 16px;">게시판·게시글, 팝업, 홈페이지 설정, 공통코드, 이미지 업로드·삭제, 언어 추가</span></td></tr></tbody></table>

<span style="font-size: 16px;">게시하면 해당 언어에서 대기 중인 변경이 **모두** 함께 공개됩니다. (다른 사람이 디자인 편집에서 수정한 내용 포함) AI가 게시 전에 보여 주는 목록을 확인하고 답해주세요.</span>

# 바뀐 내용 확인하고 되돌리기

<span style="font-size: 16px;">**관리자 페이지 \[홈페이지 설정\] / \[AI 연동 API\] / \[바뀐 내용\]**  
  
</span>

<span style="font-size: 16px;">AI가 홈페이지를 바꾼 내용을 시간순으로 확인할 수 있습니다. 연결을 선택하면 해당 앱이 바꾼 내용만 표시됩니다.</span>

[![dd10bd5a8d82931f3f275ade39ca3691.png](https://docs.dothome.co.kr/uploads/images/gallery/2026-11/scaled-1680-/dd10bd5a8d82931f3f275ade39ca3691.png)](https://docs.dothome.co.kr/uploads/images/gallery/2026-11/dd10bd5a8d82931f3f275ade39ca3691.png)

<span style="color: rgb(51, 51, 51); font-size: 18px; font-weight: 700;">● </span><span style="font-weight: bolder; color: rgb(51, 51, 51); font-size: 18px;">반영 상태</span>

<table class="table table-bordered" id="bkmrk-%EC%83%81%ED%83%9C%EC%84%A4%EB%AA%85%EA%B2%8C%EC%8B%9C-%EC%A0%84%EA%B2%8C%EC%8B%9C-%ED%9B%84-%EB%B0%98%EC%98%81%EB%90%A9%EB%8B%88%EB%8B%A4.%EC%9D%BC"><tbody><tr><td style="width: 28%;"><span style="font-size: 16px;">**상태**</span></td><td><span style="font-size: 16px;">**설명**</span></td></tr><tr><td><span style="color: rgb(33, 37, 41); font-size: 16px;">게시 전</span></td><td><span style="color: rgb(33, 37, 41); font-size: 16px;">게시 후 반영됩니다.</span></td></tr><tr><td><span style="color: rgb(33, 37, 41); font-size: 16px;">일부 바로 반영</span></td><td><span style="color: rgb(33, 37, 41); font-size: 16px;">블록 데이터는 반영되었고, 나머지는 게시 후 반영됩니다.</span></td></tr><tr><td><span style="color: rgb(33, 37, 41); font-size: 16px;">바로 반영</span></td><td><span style="color: rgb(33, 37, 41); font-size: 16px;">홈페이지에 반영되었습니다.</span></td></tr><tr><td><span style="color: rgb(33, 37, 41); font-size: 16px;">공개됨</span></td><td><span style="color: rgb(33, 37, 41); font-size: 16px;">게시가 완료되었습니다.</span></td></tr><tr><td><span style="color: rgb(33, 37, 41); font-size: 16px;">실패</span></td><td><span style="color: rgb(33, 37, 41); font-size: 16px;">저장되지 않았습니다. 사유가 함께 표시됩니다.</span></td></tr><tr><td><span style="color: rgb(33, 37, 41); font-size: 16px;">접근 거부</span></td><td><span style="color: rgb(33, 37, 41); font-size: 16px;">해제·만료된 연결 등 허용되지 않은 요청입니다.</span></td></tr></tbody></table>

<span style="font-size: 16px;">· \[조회·미리보기·접근 거부 포함\]을 선택하면 AI가 조회만 한 기록과 거부된 요청도 함께 표시됩니다.</span>

<span style="font-size: 16px;">· 설정을 바꾼 기록은 \[이전 값\]을 눌러 바꾸기 전 값을 확인할 수 있습니다.</span>

<span style="color: rgb(51, 51, 51); font-size: 18px; font-weight: 700;">● </span><span style="font-weight: bolder; color: rgb(51, 51, 51); font-size: 18px;">이전 상태로 되돌리기</span>

<span style="font-size: 16px;">페이지·헤더·푸터·공통코드는 AI가 바꾸기 전에 자동으로 저장(스냅샷)해 둡니다. AI에게 "회사소개 페이지를 어제 상태로 되돌려 줘"처럼 요청하면 됩니다. 헤더를 되돌리면 서브메뉴·타이틀 영역 사용 여부도 함께 되돌아갑니다.</span>

<span style="font-size: 16px;">아래 변경은 되돌릴 수 없으니 특히 신중하게 승인해주세요.</span>

<table class="table table-bordered" id="bkmrk-%EA%B5%AC%EB%B6%84%EB%90%98%EB%8F%8C%EB%A6%B4-%EC%88%98-%EC%97%86%EB%8A%94-%EA%B2%83%ED%8E%98%EC%9D%B4%EC%A7%80%EC%82%AD%EC%A0%9C%ED%95%9C-%ED%8E%98"><tbody><tr><td style="width: 28%;"><span style="font-size: 16px;">**구분**</span></td><td><span style="font-size: 16px;">**되돌릴 수 없는 것**</span></td></tr><tr><td><span style="color: rgb(33, 37, 41); font-size: 16px;">페이지</span></td><td><span style="color: rgb(33, 37, 41); font-size: 16px;">삭제한 페이지, 대표 페이지 변경(이전 대표 페이지를 다시 지정해야 함)</span></td></tr><tr><td><span style="color: rgb(33, 37, 41); font-size: 16px;">게시판·팝업·이미지</span></td><td><span style="color: rgb(33, 37, 41); font-size: 16px;">삭제한 게시글·댓글·첨부파일, 팝업, 업로드한 이미지 삭제(그 이미지를 쓰던 모든 곳에서 표시되지 않음)</span></td></tr><tr><td><span style="color: rgb(33, 37, 41); font-size: 16px;">함께 쓰는 설정</span></td><td><span style="color: rgb(33, 37, 41); font-size: 16px;">여러 페이지가 함께 쓰는 게시판·달력의 설정과 분류, 홈페이지 설정, 언어 추가</span></td></tr><tr><td><span style="color: rgb(33, 37, 41); font-size: 16px;">이미 게시한 내용</span></td><td><span style="color: rgb(33, 37, 41); font-size: 16px;">되돌린 뒤 다시 게시해야 홈페이지에 반영됩니다.</span></td></tr></tbody></table>

<span style="color: rgb(99, 99, 99); font-size: 16px;">\* AI에게 "최근 변경 기록 보여 줘"라고 요청해도 바뀐 내용을 확인할 수 있습니다.</span>

# 연결 연장·해제하기

<span style="font-size: 16px;">**관리자 페이지 \[홈페이지 설정\] / \[AI 연동 API\] / \[AI 연결\]**  
  
</span>

<span style="font-size: 16px;">\[연결된 앱\]에서 연결별로 사용 기간을 연장하거나 연결을 해제할 수 있습니다. (최고 관리자만 가능)</span>

[![13fe9a25c486b688de3017d1c3422be0.png](https://docs.dothome.co.kr/uploads/images/gallery/2026-11/scaled-1680-/13fe9a25c486b688de3017d1c3422be0.png)](https://docs.dothome.co.kr/uploads/images/gallery/2026-11/13fe9a25c486b688de3017d1c3422be0.png)

<span style="color: rgb(51, 51, 51); font-size: 18px; font-weight: 700;">● </span><span style="font-weight: bolder; color: rgb(51, 51, 51); font-size: 18px;">기간 연장</span>

<span style="font-size: 16px;">\[기간 연장\]을 누르면 사용 기간이 3개월 연장됩니다. 오늘부터 최대 1년까지 연장할 수 있으며, 다시 연결할 필요는 없습니다.</span>

<span style="color: rgb(99, 99, 99); font-size: 16px;">\* 만료 7일 전부터 AI 응답에 만료 안내가 표시됩니다.</span>

<span style="color: rgb(51, 51, 51); font-size: 18px; font-weight: 700;">● </span><span style="font-weight: bolder; color: rgb(51, 51, 51); font-size: 18px;">연결 해제</span>

<span style="font-size: 16px;">\[연결 해제\]를 누르면 앱이 바로 홈페이지에 접근할 수 없게 됩니다. 다시 사용하려면 새로 연결해야 합니다.</span>

<span style="font-size: 16px;">해제·만료된 연결은 \[이전 연결\]에 모여 표시됩니다.</span>

<span style="color: rgb(99, 99, 99); font-size: 16px;">\* AI 앱에서 커넥터를 삭제해도 닷홈 쪽 연결은 남습니다. 바로 끊으려면 \[연결 해제\]를 눌러주세요. (90일 동안 사용하지 않으면 자동으로 해제됩니다.)</span>

<span style="color: rgb(99, 99, 99); font-size: 16px;">\* 연결이 만료·해제되면 AI가 다시 연결하라고 안내합니다. [\[AI 앱 연결하기\]](https://docs.dothome.co.kr/books/13-ai/page/ai)로 새로 연결해주세요. 여러 사이트를 함께 쓰던 연결이면 닷홈 연결 화면에 그 사이트들의 키도 함께 입력해주세요. 분실한 키는 그 사이트에서 새로 발급해주세요.</span>

<span style="color: rgb(51, 51, 51); font-size: 18px; font-weight: 700;">● </span><span style="font-weight: bolder; color: rgb(51, 51, 51); font-size: 18px;">모든 연결 한 번에 차단하기</span>

<span style="font-size: 16px;">\[고급\] 탭의 \[AI 연동 API 사용\]을 \[사용 안함\]으로 바꾸면 모든 AI 연결과 개발자용 키가 바로 차단됩니다. 다시 \[사용\]으로 바꾸면 그대로 이어집니다.</span>

<span style="color: rgb(51, 51, 51); font-size: 18px; font-weight: 700;">● </span><span style="font-weight: bolder; color: rgb(51, 51, 51); font-size: 18px;">사용 한도</span>

<table class="table table-bordered" id="bkmrk-%EA%B5%AC%EB%B6%84%ED%95%9C%EB%8F%84%EC%97%B0%EA%B2%B0-%EA%B0%9C%EC%88%98ai-%EC%97%B0%EA%B2%B0%EA%B3%BC-%EA%B0%9C%EB%B0%9C%EC%9E%90%EC%9A%A9"><tbody><tr><td style="width: 28%;"><span style="font-size: 16px;">**구분**</span></td><td><span style="font-size: 16px;">**한도**</span></td></tr><tr><td><span style="color: rgb(33, 37, 41); font-size: 16px;">연결 개수</span></td><td><span style="color: rgb(33, 37, 41); font-size: 16px;">AI 연결과 개발자용 키를 합쳐 5개까지</span></td></tr></tbody></table>

# 개발자용 키로 API 직접 호출하기

<span style="font-size: 16px;">**관리자 페이지 \[홈페이지 설정\] / \[AI 연동 API\] / \[고급\]**  
  
</span>

<span style="font-size: 16px;">직접 만든 프로그램에서 API를 호출할 때 사용합니다. AI 앱은 \[AI 연결\] 탭에서 연결해주세요.</span>

[![03a2156ab8d017c20dd4ff78641faddb.png](https://docs.dothome.co.kr/uploads/images/gallery/2026-11/scaled-1680-/03a2156ab8d017c20dd4ff78641faddb.png)](https://docs.dothome.co.kr/uploads/images/gallery/2026-11/03a2156ab8d017c20dd4ff78641faddb.png)

<span style="color: rgb(51, 51, 51); font-size: 18px; font-weight: 700;">● </span><span style="font-weight: bolder; color: rgb(51, 51, 51); font-size: 18px;">개발자용 키 발급</span>

<span style="font-size: 16px;">\[+ 키 발급\]을 누르고 키 이름, 권한, 허용 IP, 사용 기간을 입력합니다. 발급된 키는 한 번만 표시되니 프로그램의 환경 변수 등에 보관해주세요.</span>

<span style="color: rgb(99, 99, 99); font-size: 16px;">\* 허용 IP에는 프로그램이 실행되는 서버의 IP만 입력해주세요. 키가 유출되어도 다른 곳에서는 사용할 수 없습니다.</span>

<span style="color: rgb(99, 99, 99); font-size: 16px;">\* 키는 AI 프롬프트나 대화창에 입력하지 마세요.</span>

<span style="color: rgb(99, 99, 99); font-size: 16px;">\* 키를 분실한 경우 폐기하고 다시 발급해주세요. 폐기하면 그 키로 보내는 요청이 바로 거부되며, 되돌릴 수 없습니다.</span>

<span style="color: rgb(51, 51, 51); font-size: 18px; font-weight: 700;">● </span><span style="font-weight: bolder; color: rgb(51, 51, 51); font-size: 18px;">API 직접 호출</span>

<table class="table table-bordered" id="bkmrk-%ED%95%AD%EB%AA%A9%EC%84%A4%EB%AA%85%EA%B8%B0%EB%B3%B8-%EC%A3%BC%EC%86%8Chttps%3A%2F%2F%28%EA%B3%84%EC%A0%95"><tbody><tr><td style="width: 28%;"><span style="font-size: 16px;">**항목**</span></td><td><span style="font-size: 16px;">**설명**</span></td></tr><tr><td><span style="color: rgb(33, 37, 41); font-size: 16px;">기본 주소</span></td><td><span style="color: rgb(33, 37, 41); font-size: 16px;">https://(계정 아이디).dothome.co.kr/dh-api/v1/</span></td></tr><tr><td><span style="color: rgb(33, 37, 41); font-size: 16px;">인증</span></td><td><span style="color: rgb(33, 37, 41); font-size: 16px;">`Authorization: Bearer (개발자용 키)` 헤더</span></td></tr><tr><td><span style="color: rgb(33, 37, 41); font-size: 16px;">명세</span></td><td><span style="color: rgb(33, 37, 41); font-size: 16px;">openapi.json — 요청·응답 형식</span></td></tr><tr><td><span style="color: rgb(33, 37, 41); font-size: 16px;">AI용 안내서</span></td><td><span style="color: rgb(33, 37, 41); font-size: 16px;">guide.md — AI 에이전트에게 함께 전달하는 사용 안내</span></td></tr></tbody></table>

<span style="color: rgb(51, 51, 51); font-size: 18px; font-weight: 700;">● </span><span style="font-weight: bolder; color: rgb(51, 51, 51); font-size: 18px;">진단 정보</span>

<span style="font-size: 16px;">API 버전, 코어 호환성, AI가 사용할 수 없는 기능, 저장 용량(스냅샷·작업 기록), 호출 한도를 확인할 수 있습니다.</span>

# 자주 보는 안내와 보안

<span style="color: rgb(51, 51, 51); font-size: 18px; font-weight: 700;">● </span><span style="font-weight: bolder; color: rgb(51, 51, 51); font-size: 18px;">기록과 보안</span>

<span style="font-size: 16px;">· 닷홈 연결 서버는 API 키를 암호화해 보관하고, 도구 호출 기록(어떤 도구를 언제 불렀고 결과가 어땠는지 — 요청 내용은 저장하지 않음)을 90일 보관합니다.</span>

<span style="font-size: 16px;">· 게시글·댓글처럼 다른 사람이 쓴 내용에는 AI에게 무언가를 시키는 문장이 섞여 있을 수 있습니다. AI가 그런 내용을 읽은 뒤 요청하지 않은 변경을 하려 하면 허용하지 마세요.</span>

<span style="color: rgb(51, 51, 51); font-size: 18px; font-weight: 700;">● </span><span style="font-weight: bolder; color: rgb(51, 51, 51); font-size: 18px;">자주 보는 안내</span>

<table class="table table-bordered" id="bkmrk-ai%EC%9D%98-%EC%95%88%EB%82%B4%EC%9D%98%EB%AF%B8%EC%99%80-%EC%A1%B0%EC%B9%98%EC%82%AC%EC%9D%B4%ED%8A%B8-api-"><tbody><tr><td style="width: 28%;"><span style="font-size: 16px;">**AI의 안내**</span></td><td><span style="font-size: 16px;">**의미와 조치**</span></td></tr><tr><td><span style="color: rgb(33, 37, 41); font-size: 16px;">사이트 API 버전이 오래됐다</span></td><td><span style="color: rgb(33, 37, 41); font-size: 16px;">관리자 페이지에서 사이트 API를 업데이트한 뒤 다시 요청해주세요.</span></td></tr><tr><td><span style="color: rgb(33, 37, 41); font-size: 16px;">키가 유효하지 않다·다시 연결하라</span></td><td><span style="color: rgb(33, 37, 41); font-size: 16px;">연결이 만료·해제되었습니다. [\[AI 앱 연결하기\]](https://docs.dothome.co.kr/books/13-ai/page/ai)로 새로 연결해주세요.  
여러 사이트를 함께 쓰던 연결이면 닷홈 연결 화면에 그 사이트들의 키도 함께 입력해주세요. 분실한 키는 그 사이트에서 새로 발급해주세요.</span></td></tr><tr><td><span style="color: rgb(33, 37, 41); font-size: 16px;">연결된 사이트가 일부만 보인다</span></td><td><span style="color: rgb(33, 37, 41); font-size: 16px;">그 연결에는 닷홈 연결 화면에 입력한 사이트만 들어갑니다. 쓸 사이트를 모두 함께 입력해 다시 연결하고 AI 앱을 다시 시작해주세요.</span></td></tr><tr><td><span style="color: rgb(33, 37, 41); font-size: 16px;">호출 한도를 넘었다·중계 서버가 바쁘다</span></td><td><span style="color: rgb(33, 37, 41); font-size: 16px;">잠시 뒤 다시 요청해주세요.</span></td></tr><tr><td><span style="color: rgb(33, 37, 41); font-size: 16px;">점검 중</span></td><td><span style="color: rgb(33, 37, 41); font-size: 16px;">닷홈 공지사항을 확인한 뒤 다시 요청해주세요.</span></td></tr><tr><td><span style="color: rgb(33, 37, 41); font-size: 16px;">확인이 필요하다(여러 페이지에 적용)</span></td><td><span style="color: rgb(33, 37, 41); font-size: 16px;">적용 범위를 확인하고 진행 여부를 답해주세요.</span></td></tr></tbody></table>