AI 어시스턴트(MCP) 연결하기

MCP(Model Context Protocol)는 AI 어시스턴트와 Kanorio 사이의 번역기 역할을 합니다. 연결이 완료되면 대시보드를 수동으로 클릭할 필요가 없습니다. ChatGPT, Claude 또는 Cursor에게 "수제 베이커리 사이트를 만들고, 히어로 섹션, 빵 소개 3개, FAQ 섹션을 홈페이지에 추가한 뒤, 검토할 수 있게 초안으로 저장해 줘"라고 자연스럽게 말하기만 하면 AI가 Kanorio에서 작업을 대신 처리합니다.

• MCP 서버 URL: https://app.kanorio.com/api/mcp

1단계: 연결 방법 결정하기

사용 중인 도구에 따라 두 가지 연결 방법이 있습니다.

도구가 어떤 방법을 사용하는지 확실하지 않다면, "계정 설정 › API 액세스"로 이동하여 "키 만들기"를 클릭하세요. 첫 번째 단계에서 도구를 선택합니다. OAuth 링크를 지원하는 도구를 선택하면 새 키를 만들지 않고도 화면에서 서버 URL을 바로 제공합니다.

두 방법 모두 동일한 보안 규칙을 공유합니다. AI는 사용자가 부여한 권한을 넘어서는 작업을 수행할 수 없으며, 해당 사이트에서 사용자의 멤버 역할보다 높은 권한을 가질 수 없습니다.

방법 1: OAuth 링크를 통해 연결 (ChatGPT, Claude 등)

ChatGPT, Claude, Gemini, Zapier, Make와 같이 내장된 "커넥터"가 있는 도구에 적합합니다. ChatGPT와 Claude의 예시는 다음과 같습니다.

1. 도구에 Kanorio 커넥터 추가하기

• ChatGPT: "설정" → "커넥터"를 열고(사용자 지정 커넥터를 사용하는 경우 개발자 모드 활성화), "만들기"를 선택합니다. 이름을 Kanorio로 지정하고, MCP 서버 URL https://app.kanorio.com/api/mcp를 입력한 뒤, 인증 방법으로 OAuth를 선택합니다.
• Claude: "설정" → "통합" 또는 "커넥터"를 열고, "원격 MCP 서버 추가"를 선택한 뒤, 이름 Kanorio와 URL https://app.kanorio.com/api/mcp를 입력합니다.

2. 사이트를 선택하고 Kanorio 인증 페이지에서 "허용" 클릭하기

저장 후 브라우저에서 Kanorio 인증 페이지가 열립니다.

1. 화면에 표시된 Kanorio 계정이 올바른지 확인합니다.
2. "이 애플리케이션이 수행할 수 있는 작업" 아래의 권한 목록을 검토합니다. 권한은 앱에서 요청하며(지정되지 않은 경우 시스템은 기본적으로 "콘텐츠 편집" 플랜을 적용합니다. 이 플랜은 페이지 및 블로그 초안을 보고 편집할 수 있지만, 사이트 게시 또는 게시 취소는 불가능합니다).
3. "액세스 가능한 사이트" 아래에서 AI가 관리할 사이트만 선택하세요. AI가 처음부터 새 사이트를 만들게 하려면 "모든 사이트(향후 추가되는 사이트 포함)"를 선택합니다.
4. "허용"을 클릭하여 도구로 돌아간 뒤, 채팅창에서 Kanorio 도구를 활성화하여 시작합니다.

다시 인증하라는 메시지가 뜨나요? 처음에 기본 "콘텐츠 편집" 권한으로 연결했다가 나중에 AI에게 "사이트 게시"나 "사용자 지정 도메인 바인딩"을 요청하면, AI 어시스턴트가 자동으로 인증 페이지로 안내하여 누락된 권한을 부여하도록 합니다(새 항목은 "신규"로 표시됨). 확인 후 "허용"을 클릭하여 계속 진행하세요. 인증 화면에 대한 전체 설명 및 액세스 권한 취소 방법은 을 참조하세요.

Gemini 사용 시 참고: Google은 현재 Gemini 웹의 "사용자 지정 앱"을 영어 인터페이스를 사용하는 18세 이상의 미국 개인 계정으로 제한하고 있습니다. Gemini Enterprise는 고정 클라이언트 비밀 키 요구 사항으로 인해 현재 지원되지 않습니다.

방법 2: API 키를 통해 연결 (Cursor, Claude Code 등)

Cursor, Claude Code, GitHub Copilot(VS Code), Windsurf, Perplexity, n8n 및 사용자 지정 프로그램에 적합합니다.

1. 키를 만들고 구성 복사하기

1. "계정 설정 › API 액세스"로 이동하여 "키 만들기"를 클릭합니다.
2. 도구 선택: 연결하려는 도구의 아이콘을 클릭합니다(예: Cursor 또는 Claude Code).
3. 액세스 가능한 사이트 선택: 기존 사이트의 경우 해당 특정 사이트만 선택하는 것을 권장합니다. AI가 처음부터 새 사이트를 만들게 하려면 "모든 사이트(향후 추가되는 사이트 포함)"를 선택합니다.
4. 권한 플랜 선택:
   • 기본 "콘텐츠 편집" 플랜은 AI가 페이지 모듈 수정, 이미지 업로드, 블로그 초안 작성을 수행할 수 있게 합니다(게시 전 검토가 가능하여 가장 안전함).
   • AI가 게시, 도메인 바인딩 또는 상품 관리를 처리하게 하려면 "전체 관리"를 선택하세요.
5. 만료 날짜 선택 및 본인 확인 후 만들기를 클릭합니다. 키 순환에 대한 자세한 내용은 를 참조하세요.

2. 도구에 구성 붙여넣기

키가 생성되면 키와 서버 URL이 이미 입력된 구성이 화면에 생성됩니다. "구성 복사"를 클릭하고 적절한 위치에 붙여넣으세요.

Cursor 구성 (.cursor/mcp.json) 예시:

{
  "mcpServers": {
    "kanorio": {
      "url": "https://app.kanorio.com/api/mcp",
      "headers": {
        "Authorization": "Bearer knr_pat_your_key"
      }
    }
  }
}

Claude Code 터미널 명령어 예시:

claude mcp add --transport http kanorio https://app.kanorio.com/api/mcp \
  --header "Authorization: Bearer knr_pat_your_key"

로컬 구성 파일에 키를 저장하고 싶지 않으신가요? Cursor와 Claude Code도 OAuth 링크를 지원합니다. Cursor 설정에서 headers 필드를 생략하거나 Claude Code에서 --header 매개변수를 생략하세요. 첫 사용 시 도구가 자동으로 브라우저를 열어 Kanorio 인증 페이지로 안내합니다. 이러한 도구는 로컬에서 실행되므로 "이 장치의 프로그램으로 돌아갑니다"라는 노란색 "ID 미확인" 경고가 표시될 수 있습니다. 연결을 직접 시작했다면 안전하게 "허용"을 클릭해도 됩니다( 참조).

AI 어시스턴트가 할 수 있는 일 (안전 범위)

초안 vs 즉시 변경

AI가 사이트를 관리하게 하기 전에 어떤 작업에 "초안 버퍼"가 있는지 이해하세요:

• 초안으로 저장(라이브 상태가 되려면 "게시" 필요):
  • 페이지의 모든 모듈 콘텐츠 및 레이아웃 수정.
  • 헤더 내비게이션, 푸터, 사이트 전체 버튼 및 소셜 링크 수정.
  • 사이트 외관 설정(브랜드 색상, 글꼴, 모서리 스타일, 밀도, 다크/라이트 모드, 콘텐츠 언어) 수정.
  • 블로그 게시물 추가 또는 수정(새 게시물은 항상 초안 상태이며 별도로 게시해야 함).
• 게시된 사이트에 즉시 반영:
  • 페이지 URL 슬러그, 표시 상태 및 페이지별 SEO 필드 수정.
  • 스토어 상품 추가, 수정 또는 보관(상품은 초안 상태가 없으며 변경 사항이 즉시 적용됨).
  • 사이트 게시, 사이트 게시 취소 또는 사용자 지정 도메인 바인딩 실행.

AI가 할 수 없는 일

계정 보안, 재무 및 고객 개인정보를 보호하기 위해 다음 작업은 시스템 수준에서 AI나 API를 통한 수행이 엄격히 금지됩니다. "전체 관리" 권한이 있더라도 이러한 작업은 Kanorio 대시보드에서 직접 수행해야 합니다:

• 데이터 내보내기 및 개인 파일: 사이트 백업 내보내기, 주문/고객/마케팅/분석용 CSV 내보내기 또는 폼 첨부 파일 다운로드.
• 결제, 주문 및 청구: 환불 처리, 주문 상태/메모 수정, 사이트 통화 변경, 상품 가격 플랜 변경 또는 구독 결제 및 결제 수단 관리.
• 되돌릴 수 없는 고객 및 마케팅 작업: 연락처 삭제, 연락처 일괄 가져오기 또는 뉴스레터 직접 발송/예약(AI는 초안만 작성 가능하며 대시보드에서 직접 확인해야 함).
• 권한 및 소유권: 팀원 초대/삭제, 사이트 소유권 이전 또는 사이트/블로그 게시물 영구 삭제.

기능 및 MCP 도구 참조

연결되면 AI는 다음 17가지 기능을 호출할 수 있습니다(오른쪽 도구 이름은 엔지니어링 참조 또는 Cursor/Claude의 호출 로그 확인용입니다).

권장 워크플로우 및 실용적인 프롬프트

AI 사이트 구축 모범 사례

AI 어시스턴트는 다음 7단계를 따를 때 가장 잘 작동합니다(이 순서는 AI가 자동으로 따르는 sections_describe 가이드에 내장되어 있습니다):

1. 모듈 사양 확인: AI가 사용 가능한 모듈과 필드 제한을 이해하도록 합니다.
2. 사이트 만들기 또는 선택: 새 사이트를 만들거나 기존 사이트를 나열하여 대상을 확인합니다.
3. 브랜드 외관 및 글로벌 버튼 설정: 브랜드 색상, 글꼴, 글로벌 버튼(예: "지금 예약")을 먼저 설정하여 새 페이지에 일관되게 적용되도록 합니다.
4. 이미지 준비: 사진을 AI에게 보내거나 무료 스톡 라이브러리에서 선택하도록 요청합니다(다음 섹션 참조).
5. 페이지 다시 쓰기 및 내비게이션 업데이트: AI가 현재 페이지를 읽게 한 후 다시 쓰기를 수행합니다. 새 페이지를 추가한 후에는 반드시 AI에게 헤더 내비게이션을 업데이트하도록 요청하세요.
6. 초안 검토 및 게시: 에디터에서 초안을 미리 보고 AI에게 게시를 요청합니다(첫 게시 시 .kanorio.com 하위 도메인이 필요함).
7. 도메인 바인딩 및 DNS 확인: 사용자 지정 도메인이 있는 경우 AI에게 바인딩 및 DNS 상태 확인을 요청합니다.

복사-붙여넣기용 프롬프트 템플릿

예시 1: 처음부터 브랜드 사이트 구축하기(초안 모드)

Kanorio에서 새로운 브랜드 사이트를 만들어 주세요:
- 브랜드 이름: [브랜드 이름]
- 업종 및 소개: [비즈니스 및 서비스 설명]
- 스타일 및 색상: [예: 따뜻한 흙색 톤, 부드러운 둥근 모서리, 밝은 배경]
- 기본 작업 버튼: [예: 지금 예약(https://instagram.com/example 링크)]
"홈페이지"와 "회사 소개" 페이지를 계획하고 만들어 주세요. 베이커리/빵 테마에 적합한 스톡 사진을 선택해 주세요. 구축 후 헤더 내비게이션을 업데이트하고 게시하기 전에 검토할 수 있도록 초안으로 저장해 주세요.

예시 2: 기존 페이지 다시 쓰기 및 SEO 최적화

Kanorio에 있는 내 [브랜드 이름] 사이트를 읽어 주세요:
1. 현재 홈페이지 모듈을 검토하고, 내용을 더 매력적으로 다시 쓰고, 하단에 "FAQ" 모듈을 추가해 주세요(보관, 예약 시간, 알레르기 관련 Q&A 4개 포함).
2. 사이트 내 모든 페이지의 SEO 제목과 설명을 확인하고 업데이트해 주세요.
아직 게시하지 말고 초안으로 저장한 뒤, 변경 사항을 알려 주세요.

예시 3: 사진 업로드 및 블로그 게시물 초안 작성

내 [브랜드 이름] 사이트에 "가을 밤 사워도우 출시"에 관한 블로그 게시물을 추가하고, 방금 찍은 새 사진으로 홈페이지 히어로 이미지를 업데이트하고 싶습니다. 사진을 업로드할 수 있는 링크를 제공해 주세요. 업로드 후 이미지를 업데이트하고 블로그 초안을 만들어 주세요.

AI는 어떻게 이미지를 가져오나요?

왜 AI는 내가 채팅에 붙여넣은 사진을 사용할 수 없나요?

보안 제한으로 인해 ChatGPT/Claude는 AI가 채팅 내 이미지를 "볼" 수는 있게 하지만, 원본 이미지 파일을 Kanorio로 전송하지는 않습니다. 사이트에 이미지가 필요할 때 AI는 다음 네 가지 경로 중 하나를 따릅니다. AI의 안내를 따르기만 하면 됩니다:

미디어 라이브러리 및 휴지통 규칙

• 24시간 정리: AI를 통해 업로드되었으나 24시간 동안 사용되지 않은 이미지는 공간 절약을 위해 자동으로 회수됩니다.
• 휴지통 및 30일 복구: AI에게 미디어 라이브러리를 정리하고 사용하지 않는 파일을 휴지통(media_trash)으로 이동하도록 요청할 수 있습니다. 휴지통에 있는 파일은 사이트에서 표시가 중단되지만 저장 용량에는 포함됩니다. AI 또는 를 통해 30일 이내에 복구(media_restore)할 수 있습니다. 영구적으로 삭제하려면 AI에게 요청하세요(media_purge; 이미지가 여전히 사용 중인지 확인해 줍니다). 디지털 상품 다운로드 파일은 보호되며 휴지통으로 이동할 수 없습니다.
• 이미지 덮어쓰기: 대시보드에서 오래된 이미지를 새 이미지로 교체했는데 AI가 휴지통에서 이전 버전을 복원하는 경우, 시스템은 이를 새로운 독립 파일로 복원합니다. 새 버전을 사용하는 페이지는 영향을 받지 않습니다.

사용 제한 및 참고 사항

• 사용량 제한: 각 API 키(또는 인증된 앱 연결)는 일반 작업에 대해 분당 최대 120회 호출이 가능합니다. 게시/게시 취소(사이트/블로그 게시물)는 시간당 30회로 제한됩니다. 초과 시 AI가 몇 초 기다리라는 알림을 보냅니다.
• AI 크레딧 및 플랜: "AI 사이트 구축"(brief 모드에서 sites_create)에 AI 어시스턴트를 사용하면 계정의 AI 크레딧과 일일 사이트 구축 제한이 차감됩니다. 무료 플랜 제한(페이지 수, 표시 모듈)이 적용됩니다( 참조).
• 다중 사용자/도구 보호: AI가 페이지를 편집하는 동안 대시보드에서 동일한 페이지를 편집하면 시스템이 두 번째 쓰기를 차단하고 덮어쓰기를 방지하기 위해 새로 고침을 요청합니다. 작업은 사람과 AI가 나누어 수행하는 것을 권장합니다.
• 방문자 데이터 처리: 폼 응답, 연락처 정보 및 주문 메모는 도구 설명에서 "신뢰할 수 없는 방문자 데이터"로 표시됩니다. AI는 이를 지침이 아닌 데이터로 처리해야 합니다. AI가 외부 방문자 메시지를 읽게 할 때는 키를 "콘텐츠 편집" 또는 "보기 전용"으로 유지하세요.
• 베타 상태: MCP 도구와 REST API는 베타 버전입니다. 도구가 더 이상 사용되지 않으면 도구 설명에 대안이 제안됩니다(AI가 자동으로 전환함). 공지 사항은 API 변경 로그에 게시됩니다. 정책은 를 참조하세요.

관련 문서