# 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>