Linear에 앱 연결하기
앱을 Linear에 연결하여 이슈 생성/수정, 프로젝트 및 팀 데이터 읽기, Lovable 앱에서 이슈 추적 워크플로우를 구축하세요.
Linear는 소프트웨어 팀을 위한 프로젝트 관리 도구입니다. Lovable 앱에서 이슈, 프로젝트, 팀, 사이클, 코멘트를 다룰 수 있어 Linear 워크스페이스와 직접 상호작용하는 내부 도구와 자동화를 구축할 수 있습니다.
Linear를 연동하면 앱에서 다음과 같은 작업이 가능합니다:
- 이슈 및 코멘트 생성/수정
- 팀, 프로젝트, 사이클 데이터 읽기
- 이슈 상태와 진행률을 보여주는 대시보드 구축
- 분류, 보고, 기획 워크플로우 자동화
Linear는 앱에서 엔지니어링 작업, 제품 기획, 이슈 추적을 직접 다뤄야 할 때 적합합니다.
주요 활용 사례 및 예시 앱
| 예시 앱 | 프롬프트 예시 | 설명 |
|---|---|---|
| 버그 리포트 폼 | 내부 버그 리포터를 만들어줘. 사용자가 리포트를 제출하면 Linear 이슈를 생성해줘. | 앱에서 직접 Linear에 버그를 등록할 수 있게 합니다. 제출 내용을 캡처하고 적절한 팀 대기열에 올바른 형식의 Linear 이슈를 생성합니다. |
| 스프린트 대시보드 | 팀과 상태별로 오픈된 이슈를 보여주는 스프린트 대시보드를 만들어줘. 사이클별로 그룹화해줘. | 앱을 떠나지 않고 스프린트 진행 상황을 실시간으로 확인합니다. Linear에서 현재 사이클 데이터를 읽어 상태, 담당자, 우선순위별로 이슈를 표시합니다. |
| 기능 요청 접수 | 제품 요청 접수 폼을 만들어줘. 누군가 요청을 제출하면 분류 백로그에 Linear 이슈를 만들어줘. | 폼 제출을 구조화된 Linear 이슈로 자동 변환합니다. 수신된 요청을 Linear 백로그에 직접 라우팅하여 누락을 방지합니다. |
| 이슈 분류 워크스페이스 | 새로운 Linear 이슈를 보여주고 팀/우선순위 필터링, 상태 업데이트를 한 화면에서 할 수 있는 분류 워크스페이스를 만들어줘. | 팀이 수신 작업을 더 효율적으로 검토하고 관리할 수 있게 합니다. Linear에서 이슈를 읽어 집중 분류 인터페이스로 정리하고, 도구 전환 없이 우선순위나 상태를 업데이트합니다. |
| 프로젝트 건강 대시보드 | Linear에서 이슈 수, 완료율, 차단 요소를 가져와 프로젝트 건강 대시보드를 만들어줘. | Linear 데이터를 앱의 컨텍스트와 결합하여 하나의 내부 뷰로 제공합니다. Linear에서 프로젝트 및 사이클 지표를 읽어 다른 운영 데이터와 함께 표시합니다. |
Linear 연결 방식
각 Linear 연결은 하나의 Linear 워크스페이스에 대해 승인됩니다. Linear를 연결하면 인증된 계정을 대신하여 Linear에 접근하도록 Lovable을 승인합니다.
Lovable 워크스페이스에서는:
- Linear 연결을 여러 개 만들 수 있습니다
- 각 연결은 별도의 OAuth 승인입니다
- 각 연결은 다음이 달라질 수 있습니다:
- Scope
- 연결되는 Linear 워크스페이스
- 같은 워크스페이스 내 여러 프로젝트가 하나의 연결을 공유할 수 있습니다
이를 통해 개발/운영 환경 분리나 복수 Linear 워크스페이스 운영이 쉬워집니다.
Linear는 안전한 OAuth 처리와 자동 토큰 갱신을 위해 Lovable의 게이트웨이 아키텍처를 사용합니다. 인증 및 사용량 제한에 대한 자세한 내용은 게이트웨이 기반 커넥터를 참고하세요.
Linear 연결하기
워크스페이스 admin 또는 owner가 Linear를 연결할 수 있습니다.
연결을 만들면 해당 워크스페이스의 모든 프로젝트에서 Linear를 사용할 수 있습니다.
사전 준비
Linear를 연결하기 전에 다음을 준비하세요:
- OAuth로 승인할 수 있는 Linear 계정
- Lovable 워크스페이스 admin 또는 owner 권한
Linear 연결 설정
Linear를 연결하면 Linear 데이터가 워크스페이스의 모든 사용자에게 접근 가능합니다.
Linear 커넥터로 이동
Settings → Connectors → Shared connectors에서 Linear를 선택합니다.
새 연결 추가
Add connection을 클릭합니다.
연결 이름 지정
Display name에 연결 이름을 입력합니다. 예: Linear (Prod)
Scope 설정 (선택)
Advanced settings를 펼쳐 요청할 OAuth scope(앱에 필요한 Linear 권한)를 확인하거나 조정합니다. 가장 일반적인 사용 사례에 맞는 Read와 Write가 기본 선택되어 있습니다.
앱에 필요한 scope만 선택하세요. 나중에 연결을 편집하고 Reconnect를 클릭하면 scope를 업데이트할 수 있습니다. 전체 scope 문서는 Linear scope reference를 참고하세요.
Linear 연결 및 승인
- Connect를 클릭하면 Linear 승인 창이 열립니다. 브라우저 팝업 차단을 해제해 주세요.
- 연결할 워크스페이스를 선택하고, 요청 권한을 검토한 뒤 Allow를 클릭하면 Lovable로 돌아오면서 연결이 완료됩니다.
연결이 완료되면 Lovable 앱에서 Linear 데이터를 사용할 수 있습니다.
제한 사항
Linear 커넥터는 다음을 지원하지 않습니다:
- Linear 수신 웹훅 또는 실시간 이벤트 구독 수신
- 사용자별 Linear 로그인 (최종 사용자가 각자 Linear 계정을 연결)
Linear 연결에서 프로젝트 연결 해제
Editor 이상 권한을 가진 사용자는 연결 자체를 삭제하지 않고 특정 프로젝트만 연결 해제할 수 있습니다. 연결은 다른 프로젝트에서 계속 사용할 수 있습니다.
연결 해제 방법:
커넥터로 이동
Settings → Connectors → Shared connectors에서 **Linear**를 선택합니다.
연결 열기
관리할 연결을 엽니다.
프로젝트 선택
Linked projects에서 연결 해제할 프로젝트를 선택합니다.
확인
Unlink projects를 클릭하고 확인합니다.
연결 해제 후 해당 프로젝트는 이 연결을 통해 Linear에 접근할 수 없습니다. 필요하면 다른 연결로 다시 연결할 수 있습니다.
Linear 연결 삭제
워크스페이스 admin 또는 owner가 Linear 연결을 삭제할 수 있습니다.
연결 삭제는 영구적이며 되돌릴 수 없습니다. 연결된 모든 프로젝트에서 인증 정보가 제거되며, 새 연결을 만들기 전까지 이 연결을 사용하던 앱은 동작을 멈춥니다.
삭제 전에 Linked projects 섹션에서 현재 이 연결을 사용 중인 프로젝트를 먼저 확인하세요.
삭제 방법:
커넥터로 이동
Settings → Connectors → Shared connectors에서 **Linear**를 선택합니다.
연결 열기
삭제할 연결을 엽니다.
연결된 프로젝트 확인
Linked projects 섹션을 확인합니다.
삭제
Delete this connection에서 Delete를 클릭하고 확인합니다.