이슈스티커이 문서가 필요한 경우
- Extension, SDK, Jira, Notion 설정 중 어디서 막혔는지 파악이 어려운 경우
- 권한을 허용했는데도 목록이나 필드가 보이지 않는 경우
- 등록한 도메인이나 발급한 SDK API key를 다시 확인하고 싶은 경우
권한이 없다고 나와요
이슈스티커에서 소유자나 관리자 역할인지 먼저 확인하세요. 프로젝트, 멤버, 연동 설정은 관리자 이상만 다룰 수 있습니다.
Jira나 Notion 안에서도 권한이 필요합니다. 이슈스티커에서 권한을 허용했더라도 해당 Jira 프로젝트나 Notion 데이터베이스에 접근 권한이 없으면 목록이 보이지 않습니다.
OAuth 연결이 실패해요
브라우저에 이미 로그인된 계정이 원하는 계정인지 확인하세요. 회사 계정과 개인 계정을 함께 쓰면 다른 계정으로 권한을 허용하는 일이 잦습니다.
다시 시도할 때는 외부 서비스의 권한 관리 화면에서 기존 이슈스티커 연결을 제거한 뒤 연결하세요.
도메인 승인이 안 돼요
Extension과 SDK는 프로젝트에 등록된 도메인에서만 동작합니다. 등록값과 현재 주소는 프로토콜, 호스트, 포트를 합친 오리진 단위로 비교하며, 셋 중 하나라도 다르면 다른 주소로 봅니다. https://app.example.com과 http://app.example.com, http://localhost:3000과 http://localhost:5173은 서로 다릅니다.
경로는 비교 대상이 아니므로 https://app.example.com/dashboard가 아니라 https://app.example.com처럼 오리진만 등록하세요.
https://app.example.comhttps://staging.example.comhttp://localhost:3000
서브도메인이 여러 개라면 https://*.example.com처럼 와일드카드로 한 번에 등록할 수 있습니다.
SDK API key는 어디까지 쓸 수 있나요?
SDK API key는 프로젝트 단위로 발급됩니다. 운영 서비스에 넣는 key와 테스트용 key를 분리하세요.
발급된 전체 key는 생성 직후 한 번만 볼 수 있습니다. 외부에 노출되었거나 더 이상 쓰지 않는 key는 새로 만들고 기존 key를 비활성화하세요.
Jira 필드가 안 보여요
선택한 Jira 프로젝트와 이슈 타입에 실제로 연결된 필드인지 확인하세요. Jira에서는 같은 필드라도 프로젝트나 이슈 타입에 따라 보이지 않을 수 있습니다.
커스텀 필드는 Jira 권한, 화면 설정, 필드 컨텍스트의 영향을 받습니다. Jira 관리자 화면에서 해당 필드가 선택한 이슈 타입 화면에 포함되어 있는지 확인하세요.
Notion 데이터베이스가 안 보여요
OAuth 권한 화면에서 그 데이터베이스를 허용했는지 확인하세요. Notion은 워크스페이스 전체가 아니라 선택한 페이지와 데이터베이스 단위로 권한이 열립니다.
권한을 다시 열어 데이터베이스를 포함한 뒤 이슈스티커에서 목록을 새로고침하세요.
외부 도구에서 바꾼 값이 안 보여요
Jira와 Notion은 모두 웹훅 기반 실시간 연동을 지원합니다. 외부 서비스에서 제목, 상태, 담당자 같은 값을 바꾸면 이슈스티커에도 자동으로 반영됩니다.
바로 확인해야 한다면 이슈 팝오버의 연동 영역에서 필드 동기화를 누르세요. 외부 서비스에서 이슈스티커 방향으로 최신 값을 즉시 다시 읽어옵니다.
본문 영역은 외부 서비스에서 이슈스티커 방향으로만 동기화합니다. 이슈스티커는 마크다운 기반의 단순한 문법만 지원하므로, Jira나 Notion의 서식과 맞지 않는 내용을 다시 내보내면 의도하지 않은 내용 손실이 생길 수 있기 때문입니다.
본문을 제외한 나머지 연동 필드는 양방향 동기화를 지원합니다.