13. AI 연결
AI 앱 연결하기
관리자 페이지 [홈페이지 설정] / [AI 연동 API]
ChatGPT, Claude 등의 AI 앱이나 Claude Code, Codex 등의 터미널 도구에 홈페이지를 연결하면 대화로 페이지를 만들고 수정할 수 있습니다.
AI 앱은 닷홈 연결 서버를 거쳐 홈페이지에 접근하며, 연결할 때 허용한 권한 안에서만 작업합니다. 대부분의 변경 사항은 게시 후 홈페이지에 반영됩니다. (게시판·슬라이드 등 일부는 바로 반영)
관리자 페이지 상단 메뉴의 [홈페이지 설정]을 클릭하고 좌측 메뉴에서 [AI 연동 API]를 선택합니다.
[AI 연결] 탭에서 [+ AI 앱 연결]을 누르면 앱 선택 → 권한 설정 → 연결 3단계로 연결합니다. (약 2분)
● 연결하기 전에 확인해주세요
· 연결 추가·연장·해제는 최고 관리자만 할 수 있으며, 일반 관리자는 목록만 조회할 수 있습니다.
· 홈페이지 주소는 닷홈 기본 주소(https://(계정 아이디).dothome.co.kr)로 연결합니다. 독자 도메인 주소로는 연결할 수 없습니다.
· AI 연결과 개발자용 키는 합쳐서 5개까지 사용할 수 있습니다.
● 1단계 - 앱 선택
연결할 앱을 선택합니다.
| 앱 | 설명 |
| ChatGPT | OpenAI |
| Claude | Anthropic · 웹·데스크톱·모바일 |
| Claude Code | Anthropic · 터미널 도구 |
| Codex | OpenAI · 터미널 도구 |
| 기타 MCP 앱 | OAuth 로그인을 지원하는 앱 (Hermes Agent 등) |
● 2단계 - 권한 설정
AI에게 허용할 권한을 선택합니다. [홈페이지 내용 조회]는 항상 포함되며, 처음에는 [문구·이미지·링크 수정]과 [페이지·메뉴·섹션 생성·삭제]가 선택되어 있습니다.
| 권한 | 설명 |
| 홈페이지 내용 조회 | 페이지·메뉴·디자인·설정·작업 기록을 조회합니다. (항상 포함) |
| 문구·이미지·링크 수정 | 페이지의 문구·이미지·링크·지도와 푸터 문구를 수정합니다. 푸터 문구는 모든 페이지에 적용됩니다. |
| 페이지·메뉴·섹션 생성·삭제 | 페이지·메뉴·섹션·항목을 생성·삭제하고 순서를 변경합니다. 블록 설정(갤러리·슬라이드 등)과 페이지 삭제 시 함께 삭제되는 블록 내용은 바로 반영됩니다. 새 게시판은 생성 즉시 공개되며 AI가 삭제할 수 없습니다. |
| 디자인 변경 | 전체 디자인(글꼴·색·너비), 헤더·푸터·서브메뉴·타이틀 영역, 섹션·항목 디자인을 변경합니다. 전체 디자인과 헤더·푸터·서브메뉴·타이틀 영역은 모든 페이지에 적용됩니다. |
| 게시 | 게시하면 다른 사람이 수정한 내용까지 해당 언어 전체가 함께 공개됩니다. 허용하지 않으면 관리자가 디자인 편집에서 게시합니다. |
| 이미지 업로드·삭제 | 삭제한 이미지는 복구할 수 없으며, 해당 이미지를 사용하던 곳에 바로 표시되지 않습니다. |
| 게시판·게시글 관리 | 게시판 설정을 변경하고 게시글을 조회·작성·수정·삭제합니다. 게시 없이 바로 반영되며, 삭제한 게시글·댓글·첨부파일은 복구할 수 없습니다. |
| 홈페이지 설정·팝업·언어 | 기본 설정과 SEO 설정을 변경하고, 팝업을 관리하고, 언어를 추가합니다. 게시 없이 바로 반영되며 이전 상태로 되돌릴 수 없습니다. 추가한 언어는 AI가 삭제할 수 없습니다. |
| 코드 입력 | 코드블럭과 공통코드(모든 페이지에 삽입되는 코드)를 입력·수정합니다. 입력한 스크립트는 방문자 브라우저에서 실행됩니다. 공통코드는 게시 없이 바로 반영됩니다. |
| 항목 | 설명 |
| 연결 이름 | 바뀐 내용과 게시글 작성자에 표시됩니다. 여러 컴퓨터에서 사용한다면 구분할 수 있게 입력해주세요. (예: Codex 연결 - 회사 서버) |
| 사용 기간 | 3개월·6개월·1년 중에서 선택합니다. 만료 전에 연장할 수 있습니다. |
● 3단계 - 연결
[API 키 발급]을 누르면 API 키가 발급되고, 선택한 앱의 연결 방법이 표시됩니다. API 키는 지금 한 번만 표시됩니다.
1. 앱의 MCP 서버(커넥터) 추가 화면에 아래 주소를 입력하고, 인증 방식은 OAuth를 선택합니다.
https://buildermcp.dothome.co.kr/mcp
2. 닷홈 연결 화면이 열리면 사이트 주소와 API 키를 입력하고 [연결]을 누릅니다.
3. 연결이 확인되면 "✓ 연결이 확인되었습니다."가 표시되고, [연결된 앱]에 [연결됨]으로 나타납니다.
* API 키는 닷홈 연결 화면에만 입력하고, 대화창이나 터미널에는 붙여 넣지 마세요.
* API 키는 닷홈 연결 서버에서만 사용할 수 있어, 유출되어도 다른 곳에서는 사용할 수 없습니다.
* 연결을 마칠 때까지 이 화면을 닫지 마세요. 키를 분실한 경우 연결을 해제하고 다시 연결해주세요. 여러 사이트를 함께 쓰던 연결이면 닷홈 연결 화면에 그 사이트들의 키도 함께 입력해주세요. 분실한 키는 그 사이트에서 새로 발급해주세요.
* 앱별 자세한 연결 방법은 [AI 앱별 연결 방법]을 참고해주세요.
● 연결된 앱
연결한 앱은 [AI 연결] 탭의 [연결된 앱]에 표시됩니다.
| 상태 | 설명 |
| 연결 대기 | 닷홈 연결 화면에서 API 키를 아직 입력하지 않았습니다. |
| 연결됨 | 앱이 홈페이지에 연결되었습니다. |
| N일 후 만료 | 사용 기간이 얼마 남지 않았습니다. [기간 연장]으로 연장할 수 있습니다. |
기간 연장과 연결 해제는 [연결 연장·해제하기]를 참고해주세요.
AI 앱별 연결 방법
관리자 페이지 [홈페이지 설정] / [AI 연동 API] / [AI 연결]
AI 앱 연결 3단계에서 선택한 앱의 연결 방법이 표시됩니다. 모든 앱은 같은 닷홈 연결 서버 주소를 사용합니다.
https://buildermcp.dothome.co.kr/mcp
● 앱별 연결 방법
| 앱 | 연결 방법 |
| Claude (웹·데스크톱·모바일) | 설정 › 커넥터 › 사용자 지정 커넥터 추가 → 서버 주소 입력 → [연결] → 닷홈 연결 화면. 대화에서 그 커넥터를 켭니다. Free 요금제는 커넥터 1개, Team·Enterprise는 관리자가 먼저 추가합니다. |
| ChatGPT | 웹 설정에서 개발자 모드를 켠 뒤 새 앱(커넥터)을 만들고 MCP 서버 주소를 입력, 인증은 OAuth를 선택 → [연결] → 닷홈 연결 화면. 디렉터리 등재 전에는 개발자 모드를 쓸 수 있는 요금제만 연결할 수 있습니다. |
| Claude Code | claude mcp add --transport http dothome https://buildermcp.dothome.co.kr/mcp 로 등록하고, 아래 [터미널 도구 로그인]대로 로그인합니다. |
| Codex | ~/.codex/config.toml 에 [mcp_servers.dothome] 과 url = "https://buildermcp.dothome.co.kr/mcp" 를 넣고, 아래 [터미널 도구 로그인]대로 로그인합니다. |
| 기타 MCP 앱 | OAuth 로그인을 지원하는 앱만 연결할 수 있습니다. 헤더에 키를 넣는 방식만 지원하는 앱은 연결할 수 없으며, OpenAPI·HTTP 호출을 지원한다면 [개발자용 키로 API 직접 호출하기]을 이용해주세요. |
* 앱마다 메뉴 이름이 다르며, 앱 업데이트에 따라 바뀔 수 있습니다.
● 닷홈 연결 화면
앱에서 연결을 시작하면 닷홈 연결 화면이 열립니다. 사이트 주소와 API 키를 입력하고 [연결]을 누릅니다.
· 이 AI 앱에서 쓸 사이트는 모두 이 화면에 함께 입력해주세요. (10개까지)
· 연결할 때마다 입력한 사이트만으로 새 연결이 만들어지며, 이전 연결의 사이트는 옮겨 오지 않습니다.
· 연결한 뒤에는 AI 앱을 다시 시작해주세요. 열려 있던 대화·터미널 세션은 이전 연결을 계속 사용할 수 있습니다.
· 키에 IP 제한이 없으면 경고가 표시됩니다. [AI 연결] 탭의 [+ AI 앱 연결]로 다시 발급하는 것을 권장합니다.
· 직접 시작하지 않은 연결 화면이 열렸다면 [거부]를 누르세요.
● 터미널 도구 로그인
Claude Code·Codex 등 터미널 도구는 같은 컴퓨터든 SSH로 접속한 서버든 같은 방법으로 로그인합니다.
1. 로그인 명령을 실행합니다. 연결 주소가 표시되고 입력을 기다립니다.
Claude Code: claude mcp login dothome --no-browser
Codex: codex mcp login dothome --no-browser
Hermes Agent: hermes mcp login <서버 이름>
2. 그 주소를 브라우저에서 열고, 닷홈 연결 화면에서 사이트 주소와 API 키를 입력해 [연결]을 누릅니다.
3. 같은 컴퓨터에서는 [연결]을 누르면 로그인이 완료됩니다. 다른 컴퓨터(서버)라면 브라우저가 http://localhost… 또는 http://127.0.0.1… 로 넘어가며 열리지 않는 화면이 나옵니다. 정상이며, 주소창의 주소 전체를 복사해 터미널에 붙여 넣습니다. (Codex는 입력한 내용이 화면에 보이지 않습니다.)
* [연결]을 누른 뒤 5분 안에 붙여 넣어야 합니다. 시간이 지나면 1번부터 다시 진행해주세요.
* 이 주소는 다른 사람에게 보내지 마세요.
AI에게 작업 맡기기
AI에게 홈페이지 작업을 맡기기 전에 아래 내용을 확인해주세요.
● 도구 사용 승인을 '항상 허용'으로 설정하지 마세요
AI 앱이 도구 사용을 물을 때마다 허용하면, 홈페이지를 바꾸기 전에 어떤 작업인지 확인할 수 있습니다. '항상 허용'으로 설정하면 홈페이지 전체에 적용되는 변경도 확인 없이 진행될 수 있습니다.
● 요청할 때 범위를 분명히 말해주세요
"회사소개 페이지 본문 맨 위에…"처럼 홈페이지·페이지·위치를 함께 말하면 AI가 엉뚱한 곳을 바꾸지 않습니다.
● 여러 페이지에 함께 적용되는 변경
아래 항목은 한 페이지가 아니라 여러 페이지에 함께 적용됩니다. AI가 이런 변경을 하기 전에 물으면 범위를 확인하고 답해주세요.
| 구분 | 내용 |
| 헤더·푸터 | 상단 메뉴·로고, 하단 회사 정보 문구, 서브메뉴, 타이틀 영역 사용 |
| 전체 디자인·코드 | 글꼴·색·너비, 공통코드(모든 페이지에 들어가는 스크립트) |
| 홈페이지 설정 | 기본 제목·검색 노출·사이트맵 등 기본 설정과 SEO 설정 |
| 대표 페이지 | 첫 화면으로 보이는 페이지 |
| 함께 쓰는 게시판·달력·팝업 | 여러 페이지가 함께 쓰는 게시판·달력의 설정과 분류, 여러 페이지에 걸린 팝업 |
* ChatGPT의 메모리가 켜져 있으면 이전 대화에서 승낙한 내용을 다음 대화에서 다시 묻지 않을 수 있습니다. 여러 페이지에 적용되는 변경은 대화마다 확인해주세요.
● 게시 후 반영되는 것과 바로 반영되는 것
| 구분 | 내용 |
| 게시 후 반영 | 페이지·섹션의 문구와 디자인, 페이지 설정, 메뉴, 헤더·푸터, 전체 디자인 |
| 바로 반영 | 게시판·게시글, 팝업, 홈페이지 설정, 공통코드, 이미지 업로드·삭제, 언어 추가 |
게시하면 해당 언어에서 대기 중인 변경이 모두 함께 공개됩니다. (다른 사람이 디자인 편집에서 수정한 내용 포함) AI가 게시 전에 보여 주는 목록을 확인하고 답해주세요.
바뀐 내용 확인하고 되돌리기
관리자 페이지 [홈페이지 설정] / [AI 연동 API] / [바뀐 내용]
AI가 홈페이지를 바꾼 내용을 시간순으로 확인할 수 있습니다. 연결을 선택하면 해당 앱이 바꾼 내용만 표시됩니다.
● 반영 상태
| 상태 | 설명 |
| 게시 전 | 게시 후 반영됩니다. |
| 일부 바로 반영 | 블록 데이터는 반영되었고, 나머지는 게시 후 반영됩니다. |
| 바로 반영 | 홈페이지에 반영되었습니다. |
| 공개됨 | 게시가 완료되었습니다. |
| 실패 | 저장되지 않았습니다. 사유가 함께 표시됩니다. |
| 접근 거부 | 해제·만료된 연결 등 허용되지 않은 요청입니다. |
· [조회·미리보기·접근 거부 포함]을 선택하면 AI가 조회만 한 기록과 거부된 요청도 함께 표시됩니다.
· 설정을 바꾼 기록은 [이전 값]을 눌러 바꾸기 전 값을 확인할 수 있습니다.
● 이전 상태로 되돌리기
페이지·헤더·푸터·공통코드는 AI가 바꾸기 전에 자동으로 저장(스냅샷)해 둡니다. AI에게 "회사소개 페이지를 어제 상태로 되돌려 줘"처럼 요청하면 됩니다. 헤더를 되돌리면 서브메뉴·타이틀 영역 사용 여부도 함께 되돌아갑니다.
아래 변경은 되돌릴 수 없으니 특히 신중하게 승인해주세요.
| 구분 | 되돌릴 수 없는 것 |
| 페이지 | 삭제한 페이지, 대표 페이지 변경(이전 대표 페이지를 다시 지정해야 함) |
| 게시판·팝업·이미지 | 삭제한 게시글·댓글·첨부파일, 팝업, 업로드한 이미지 삭제(그 이미지를 쓰던 모든 곳에서 표시되지 않음) |
| 함께 쓰는 설정 | 여러 페이지가 함께 쓰는 게시판·달력의 설정과 분류, 홈페이지 설정, 언어 추가 |
| 이미 게시한 내용 | 되돌린 뒤 다시 게시해야 홈페이지에 반영됩니다. |
* AI에게 "최근 변경 기록 보여 줘"라고 요청해도 바뀐 내용을 확인할 수 있습니다.
연결 연장·해제하기
관리자 페이지 [홈페이지 설정] / [AI 연동 API] / [AI 연결]
[연결된 앱]에서 연결별로 사용 기간을 연장하거나 연결을 해제할 수 있습니다. (최고 관리자만 가능)
● 기간 연장
[기간 연장]을 누르면 사용 기간이 3개월 연장됩니다. 오늘부터 최대 1년까지 연장할 수 있으며, 다시 연결할 필요는 없습니다.
* 만료 7일 전부터 AI 응답에 만료 안내가 표시됩니다.
● 연결 해제
[연결 해제]를 누르면 앱이 바로 홈페이지에 접근할 수 없게 됩니다. 다시 사용하려면 새로 연결해야 합니다.
해제·만료된 연결은 [이전 연결]에 모여 표시됩니다.
* AI 앱에서 커넥터를 삭제해도 닷홈 쪽 연결은 남습니다. 바로 끊으려면 [연결 해제]를 눌러주세요. (90일 동안 사용하지 않으면 자동으로 해제됩니다.)
* 연결이 만료·해제되면 AI가 다시 연결하라고 안내합니다. [AI 앱 연결하기]로 새로 연결해주세요. 여러 사이트를 함께 쓰던 연결이면 닷홈 연결 화면에 그 사이트들의 키도 함께 입력해주세요. 분실한 키는 그 사이트에서 새로 발급해주세요.
● 모든 연결 한 번에 차단하기
[고급] 탭의 [AI 연동 API 사용]을 [사용 안함]으로 바꾸면 모든 AI 연결과 개발자용 키가 바로 차단됩니다. 다시 [사용]으로 바꾸면 그대로 이어집니다.
● 사용 한도
| 구분 | 한도 |
| 연결 개수 | AI 연결과 개발자용 키를 합쳐 5개까지 |
개발자용 키로 API 직접 호출하기
관리자 페이지 [홈페이지 설정] / [AI 연동 API] / [고급]
직접 만든 프로그램에서 API를 호출할 때 사용합니다. AI 앱은 [AI 연결] 탭에서 연결해주세요.
● 개발자용 키 발급
[+ 키 발급]을 누르고 키 이름, 권한, 허용 IP, 사용 기간을 입력합니다. 발급된 키는 한 번만 표시되니 프로그램의 환경 변수 등에 보관해주세요.
* 허용 IP에는 프로그램이 실행되는 서버의 IP만 입력해주세요. 키가 유출되어도 다른 곳에서는 사용할 수 없습니다.
* 키는 AI 프롬프트나 대화창에 입력하지 마세요.
* 키를 분실한 경우 폐기하고 다시 발급해주세요. 폐기하면 그 키로 보내는 요청이 바로 거부되며, 되돌릴 수 없습니다.
● API 직접 호출
| 항목 | 설명 |
| 기본 주소 | https://(계정 아이디).dothome.co.kr/dh-api/v1/ |
| 인증 | Authorization: Bearer (개발자용 키) 헤더 |
| 명세 | openapi.json — 요청·응답 형식 |
| AI용 안내서 | guide.md — AI 에이전트에게 함께 전달하는 사용 안내 |
● 진단 정보
API 버전, 코어 호환성, AI가 사용할 수 없는 기능, 저장 용량(스냅샷·작업 기록), 호출 한도를 확인할 수 있습니다.
자주 보는 안내와 보안
● 기록과 보안
· 닷홈 연결 서버는 API 키를 암호화해 보관하고, 도구 호출 기록(어떤 도구를 언제 불렀고 결과가 어땠는지 — 요청 내용은 저장하지 않음)을 90일 보관합니다.
· 게시글·댓글처럼 다른 사람이 쓴 내용에는 AI에게 무언가를 시키는 문장이 섞여 있을 수 있습니다. AI가 그런 내용을 읽은 뒤 요청하지 않은 변경을 하려 하면 허용하지 마세요.
● 자주 보는 안내
| AI의 안내 | 의미와 조치 |
| 사이트 API 버전이 오래됐다 | 관리자 페이지에서 사이트 API를 업데이트한 뒤 다시 요청해주세요. |
| 키가 유효하지 않다·다시 연결하라 | 연결이 만료·해제되었습니다. [AI 앱 연결하기]로 새로 연결해주세요. 여러 사이트를 함께 쓰던 연결이면 닷홈 연결 화면에 그 사이트들의 키도 함께 입력해주세요. 분실한 키는 그 사이트에서 새로 발급해주세요. |
| 연결된 사이트가 일부만 보인다 | 그 연결에는 닷홈 연결 화면에 입력한 사이트만 들어갑니다. 쓸 사이트를 모두 함께 입력해 다시 연결하고 AI 앱을 다시 시작해주세요. |
| 호출 한도를 넘었다·중계 서버가 바쁘다 | 잠시 뒤 다시 요청해주세요. |
| 점검 중 | 닷홈 공지사항을 확인한 뒤 다시 요청해주세요. |
| 확인이 필요하다(여러 페이지에 적용) | 적용 범위를 확인하고 진행 여부를 답해주세요. |