API 키는 knr_pat_로 시작하는 고유한 비밀번호로, "사용자가 부여한 권한 범위 내에서 지정한 웹사이트에 대해서만 수행하는 작업"을 의미합니다. 이 키를 AI 도구나 자동화 스크립트에 추가하면 브라우저를 통해 로그인할 필요 없이 백그라운드에서 웹사이트 목록 조회, 페이지 편집, 이미지 업로드, 콘텐츠 게시, 도메인 연결 등의 작업을 수행할 수 있습니다.
키 관리는 "계정 설정 › API 액세스"에서 할 수 있습니다.
ChatGPT, Claude, Gemini, Zapier, Make에는 API 키가 필요하지 않습니다: 이러한 도구에는 내장 커넥터가 있습니다. MCP 서버 URL
https://app.kanorio.com/api/mcp를 붙여넣고 Kanorio 인증 페이지에서 "허용"을 클릭하기만 하면 됩니다 (자세한 내용은 참조). 키를 생성하는 동안 이러한 도구를 선택해도 시스템은 키를 생성하는 대신 서버 URL을 직접 제공합니다.
로그인 후 오른쪽 상단의 아바타를 클릭하고 "계정 설정" → "API 액세스"로 이동하거나 app.kanorio.com/account/api-access를 직접 방문한 다음 "키 생성"을 클릭합니다.
사용하려는 도구의 아이콘을 클릭합니다:
기본적으로 시스템은 "{도구 이름} Assistant"를 채우지만 수정할 수 있습니다. 이 이름은 사용자만 볼 수 있습니다. "하나의 도구, 하나의 목적, 하나의 키" 명명 원칙(예: "Cursor - 브랜드 웹사이트", "n8n - 일일 재고 동기화")을 권장합니다. 이렇게 하면 도구가 은퇴하거나 팀원이 떠날 때 어떤 키를 취소해야 하는지 쉽게 식별할 수 있습니다.
개별 권한을 관리할 필요 없이 세 가지 사전 설정 플랜 중에서 선택하세요:
| 권한 플랜 | 기능 | 사용 사례 |
|---|---|---|
| 보기 전용 | 사이트 설정, 페이지, 블로그 게시물, , 온라인 양식 응답, 고객 목록, 세그먼트, 제품, 주문 및 분석 데이터를 읽을 수 있습니다. 콘텐츠는 수정할 수 없습니다. | AI를 활용하여 운영 보고서를 정리하거나, 사이트 구조를 확인하거나, 와 함께 ?preview=1 초안 미리보기를 사용할 때 적합합니다. |
| 콘텐츠 편집 (기본값) | 「보기 전용」 권한을 포함하며, 페이지 모듈 초안 추가 및 편집, 머리글 및 바닥글 편집, 이미지 업로드 및 관리, 블로그 게시물 작성이 가능합니다. 사이트를 게시하거나 게시 취소할 수 없습니다. (AI가 컬렉션을 만들고 작성하도록 허용하려면 「사용자 지정」을 클릭하고 「콘텐츠 › 컬렉션 관리」를 체크하거나 「전체 액세스」를 선택하세요.) | AI가 페이지를 편집하고 이미지를 교체하며 매일 게시물을 작성하도록 하고, 사용자가 직접 검토 및 게시를 수행할 때 적합합니다. |
| 전체 액세스 | 사이트 게시 및 게시 취소, 사용자 지정 도메인 연결, 생성 및 관리, CORS 허용 오리진 설정, 제품 추가 및 편집, 고객 태그 관리, 뉴스레터 초안 생성을 포함하여 AI/API에서 사용할 수 있는 모든 권한을 부여합니다. | 사이트 구축부터 라이브까지의 완전 자동화, AI 기반 데이터베이스 생성, 또는 ERP 시스템과 사용자 지정 백엔드를 통합할 때 적합합니다. |
권한을 세밀하게 조정하려면 "사용자 지정"을 클릭하여 6개의 권한 그룹(페이지 탐색, 웹사이트 설정, 콘텐츠, 전자상거래, 고객, 마케팅)을 확장하세요. 각 그룹에 대해 "전체 선택"을 할 수 있습니다. 쓰기 권한(예: "웹사이트 콘텐츠 편집")을 선택하면 시스템이 필요한 읽기 권한(예: "대시보드 액세스" 및 "웹사이트 편집기 액세스")을 자동으로 확인하고 도구가 올바르게 작동하도록 "자동 포함"으로 표시합니다.
보안 제한:
- "마케팅" 전송 권한이나 "전체 관리" 권한이 있더라도 AI와 API는 뉴스레터 초안 생성 및 편집만 가능하며, 직접 뉴스레터를 보내거나 예약할 수 없습니다 (전송 전 대시보드에서 확인해야 합니다).
- 웹사이트/주문/고객/마케팅/분석 데이터 내보내기, 양식 첨부 파일 다운로드, 환불 처리, 연락처 삭제, 웹사이트 통화 변경, 멤버 관리, 결제 관리, 웹사이트 양도와 같은 고위험 권한은 선택할 수 없습니다.
7일, 30일, 90일(기본값), 365일 중에서 선택하세요. 만료 날짜는 옵션 옆에 표시됩니다 (보안상의 이유로 만료되지 않는 키는 제공하지 않습니다):
API 키를 생성하는 것은 외부 프로그램에 계정 액세스 권한을 부여하는 것과 같습니다. 이 기기에서 15분 이상 로그인 상태였다면 시스템이 본인 확인을 다시 요구합니다:
일반 텍스트 키(knr_pat_...)는 완료 화면에 한 번만 표시됩니다. 키 아래에 시스템은 선택한 도구에 따라 키와 서버 URL이 미리 채워진 구성 스니펫을 제공합니다:
.cursor/mcp.json을 위한 전체 JSONclaude mcp add 명령어.vscode/mcp.json을 위한 전체 JSONAuthorization: Bearer 헤더"구성 복사"를 클릭하여 도구에 붙여넣으세요. 복사하지 않고 창을 닫으면 시스템이 확인을 요청합니다. 닫은 후 목록에는 식별을 위해 처음 8자만 표시됩니다. 키를 잊어버린 경우 단순히 "회전"을 수행하세요.
특정 웹사이트에서 키에 대한 실제 권한은 "키에 선택된 권한"과 "해당 웹사이트에서의 사용자 멤버 역할"의 교집합입니다:
$$\text{실제 권한} = \text{키 권한} \cap \text{사용자 멤버 역할 권한}$$
"계정 설정 › API 액세스" 목록에서 각 키는 다음을 표시합니다:
Tool: {client}): 이 키로 마지막으로 연결된 프로그램 이름(예: cursor-vscode, claude-code 또는 kanorio-cli)이 기록됩니다. Cursor용으로 키를 생성했는데 낯선 도구 이름이 보이면 키가 유출되었을 수 있으므로 즉시 회전하거나 취소하세요.각 Kanorio 계정은 한 번에 최대 20개의 활성 키를 가질 수 있습니다 (회전 버퍼에 있는 키는 이 제한에 포함되지 않습니다).
키 옆의 "더 보기(⋯)" 메뉴를 클릭하고 "편집"을 선택하여 이름, 액세스 가능한 웹사이트 및 권한 플랜을 수정하세요 (만료 날짜는 직접 수정할 수 없으며 "회전"을 사용하여 연장하세요).
만료 알림을 받거나, 주기적으로 비밀번호를 업데이트하고 싶거나, 유출이 의심될 때 이전 키를 삭제하고 양식을 다시 작성할 필요가 없습니다. "더 보기(⋯)" 메뉴를 클릭하고 "회전"을 선택하세요:
1시간 또는 24시간 버퍼 기간 동안 목록에는 두 키가 모두 표시되며 이전 키는 "{시간} 후 만료"로 표시됩니다. 버퍼 기간 키는 취소만 가능하며 추가 만료 알림을 트리거하지 않습니다. 버퍼가 지나면 이전 키는 자동으로 무효화됩니다.
만료된 키: 키가 이미 만료된 경우 메뉴에 "재생성"이 표시됩니다. 이 작업도 원래 이름, 웹사이트 및 권한을 새 키에 적용합니다 (이전 키가 이미 무효이므로 버퍼 옵션은 사용할 수 없습니다).
"더 보기(⋯)" 메뉴에서 "취소"를 클릭하고 확인하세요. 키는 즉시 영구적으로 무효화됩니다. 이를 사용하는 AI 어시스턴트나 프로그램은 다음 요청 시 401 UNAUTHORIZED 오류를 수신합니다 (취소 전 저장된 초안은 보존됩니다).
.cursor/mcp.json 파일에 저장하세요 (.gitignore에 추가되었는지 확인).knr_pat_ 키를 메시지에 직접 붙여넣으라고 요청하면 절대 하지 마세요.아니요, 최대 만료 기간은 365일입니다. 정기적인 회전은 장기적인 자격 증명 유출 위험을 크게 줄입니다. 만료 7일 전과 1일 전에 이메일 알림을 받게 되며, "회전"을 클릭하기만 하면 몇 초 만에 원래 설정을 사용하여 새 키를 발급할 수 있습니다.
아니요. 각 API 키는 생성자의 계정 및 감사 로그에 바인딩됩니다. 팀원이 Cursor나 자동화 도구를 사용해야 하는 경우, 자신의 Kanorio 계정으로 로그인하여 키를 만들어야 합니다. 키의 권한은 웹사이트에서의 역할에 따라 자동으로 제한됩니다.
이러한 작업은 웹사이트를 운영할 수 있는 권한을 나타내는 장기 패스를 발급하거나 확장하는 것과 같기 때문입니다. 컴퓨터가 잠금 해제된 상태에서 다른 사람이 키를 생성하거나 이전 로그인 세션을 통해 생성하는 것을 방지하기 위해, 마지막 로그인 후 15분이 지났으면 시스템이 2FA/패스키 확인 또는 재로그인을 요구합니다. 반대로 "권한 축소", "이름 수정", "키 취소"는 보안 수렴적 작업이므로 확인 없이 즉시 적용됩니다.
알림은 Kanorio 계정과 연결된 이메일 주소로 전송되며 대시보드 오른쪽 상단의 받은 편지함 알림으로 동기화됩니다. 스팸 폴더를 확인하세요. 또한 키가 이미 만료, 취소 또는 회전되었거나, 7일 만료를 선택한 경우 (1일 전에만 알림 트리거) 시스템은 해당 단계에 대해 알림을 보내지 않습니다.