AI 연결 기능을 사용하면 Claude Code, Cursor, Codex처럼 이미 사용 중인 AI 도구에서 웹사이트, 도메인, 이메일을 관리할 수 있습니다. 도구는 사용자 본인으로 로그인하고, 사용자가 선택한 것만 다루며, 위험한 작업은 하기 전에 사용자에게 먼저 묻습니다.
AI 연결이란
도구를 연결하고 나면 평소 쓰는 말로 KapsuleHost 계정의 작업을 요청할 수 있습니다. 예를 들어 오류 로그 확인, 사이트 배포, 메일박스 추가 등입니다. 도구는 많은 AI 도구가 지원하는 개방형 표준인 MCP를 통해 KapsuleHost와 통신합니다.
복사할 키는 없습니다. 브라우저에서 평소처럼 KapsuleHost 계정으로 로그인하며, 비밀번호, 패스키, 2단계 인증 코드는 오직 브라우저에서만 입력하고 AI 도구에는 절대 입력하지 않습니다.
시작하기 전에
- 계정에 패스키 또는 인증 앱이 있어야 합니다. 둘 다 없으면 KPanel에서 먼저 설정하라고 안내합니다. 계정 보안을 참조하세요.
- 소유자와 관리자는 변경 작업을 하는 도구를 연결할 수 있습니다. 결제, 지원, 보기 전용 멤버는 읽기만 하는 도구를 연결할 수 있습니다.
도구 연결하기
- KPanel에서 계정 설정을 연 다음 연결된 AI를 열고 도구 연결을 선택합니다. 웹사이트, 도메인 또는 메일박스 페이지에서 AI 연결을 클릭해도 됩니다.
- 도구 선택: Claude Code, Claude Desktop, Cursor, VS Code, Codex 또는 기타 MCP 클라이언트.
- 접근 범위 선택: 이 웹사이트만, 이 도메인만, 이 메일함만 또는 내 전체 계정. 도구는 선택한 범위 밖에서는 아무것도 할 수 없습니다.
- KPanel에 표시되는 한 단계로 도구를 추가합니다. Claude Code의 경우 터미널에서 다음과 같은 명령어 하나를 실행합니다.
claude mcp add --transport http northbay-bakery https://mcp.kapsulehost.com/site/nb7k2q
Codex는 명령어 복사를 사용합니다. Cursor와 VS Code는 Cursor에 추가 또는 VS Code에 추가를 사용합니다. Claude Desktop은 단계 보기를 사용합니다. 그 밖의 도구는 주소 복사를 사용해 원격 MCP 서버로 추가합니다.
- 브라우저가 열립니다. KPanel에 로그인하고 도구가 요청하는 내용을 확인한 다음 패스키 또는 인증 앱 코드로 허용합니다.
매번 묻기의 작동 방식
모든 연결은 매번 묻기를 사용합니다. 읽기와 일상적인 안전한 변경은 바로 실행됩니다. 예를 들어 로그 확인이나 캐시 비우기가 그렇습니다.
위험한 작업은 사용자를 기다립니다. 항목 삭제, 도메인 이전, 서비스 해지, 비용이 드는 모든 작업, 그리고 DNS 레코드나 메일 전달처럼 사이트나 이메일을 망가뜨릴 수 있는 변경이 여기에 해당합니다.
도구가 이런 작업을 요청해도 아직은 아무 일도 일어나지 않습니다.
- KPanel에 요청이 표시됩니다. 승인 이메일을 켜 두었다면 이메일로도 알려 드리지만, 이메일에는 KPanel로 가는 링크만 있습니다. 이메일로는 아무것도 승인할 수 없으므로, 메일박스를 읽을 수 있는 도구라도 자신의 요청을 승인할 수는 없습니다.
- 요청에는 무엇이 바뀌는지, 어떤 도구가 요청했는지, 도구가 제시한 이유가 표시됩니다. 그 이유에는 AI 도구에서 온 텍스트라는 표시가 붙습니다.
- 매번 패스키 또는 인증 앱 코드로 승인합니다. 문자 메시지 코드로는 승인할 수 없습니다. 거절하려면 거절을 클릭합니다. 거절에는 코드가 필요하지 않습니다.
아무 조치도 하지 않은 요청은 24시간 후 만료되며 실행되지 않습니다. 예상하지 못한 요청이라면 거절하고 Claude Code 연결 끊기를 선택하세요. 요청이 거절되고 도구가 즉시 취소됩니다. 버튼에는 요청한 도구의 이름이 표시됩니다.
도구가 절대 접근할 수 없는 것
무엇을 선택하든 AI 도구는 다음 항목에 접근할 수 없습니다.
- 비밀번호, 패스키, 2단계 인증 설정
- 로그인 세션
- API 키
- SSH, SFTP, 데이터베이스, 메일박스 비밀번호와 키
- 팀 멤버와 그 역할
- 연결된 AI 설정
- 결제 수단
- 계정 해지
활동 확인과 취소
계정 설정을 연 다음 연결된 AI를 열면 연결된 모든 도구를 볼 수 있습니다.
- 활동에는 도구가 한 일이 표시되고, 활동 로그에는 각 변경 사항을 어떤 도구가 했는지 기록됩니다.
- 취소는 도구 하나를 즉시 로그아웃합니다. 그 도구가 기다리던 작업은 모두 취소됩니다.
- 모두 취소는 모든 도구를 즉시 로그아웃합니다.
로그아웃하면 모든 도구의 연결이 끊깁니다
다음과 같은 경우 연결된 모든 도구가 자동으로 로그아웃됩니다.
- 비밀번호를 변경하거나 재설정할 때
- 2단계 인증을 재설정할 때
- 모든 곳에서 로그아웃할 때
연결은 30일 동안 사용하지 않거나 총 90일이 지나도 종료됩니다. 그러면 도구가 브라우저를 열고 다시 로그인하도록 요청합니다.