Linear 이슈·프로젝트·팀 데이터를 앱에서 읽고 쓰며 이슈 추적 내부 도구를 구축합니다.
Linear에 앱 연결하기
앱을 Linear에 연결하여 이슈 생성/수정, 프로젝트 및 팀 데이터 읽기, Lovable 앱에서 이슈 추적 워크플로우를 구축하세요.
Linear는 소프트웨어 팀을 위한 프로젝트 관리 도구입니다. Lovable 앱에서 이슈, 프로젝트, 팀, 사이클, 코멘트를 다룰 수 있어 Linear 워크스페이스와 직접 상호작용하는 내부 도구와 자동화를 구축할 수 있습니다.
Linear를 연결하면 앱은 다음 작업이 가능합니다:
- 이슈 및 코멘트 생성/수정
- 팀, 프로젝트, 사이클 데이터 읽기
- 이슈 상태와 진행률을 보여주는 대시보드 구축
- 분류, 보고, 기획 워크플로우 자동화
Linear는 앱에서 엔지니어링 작업, 제품 기획, 이슈 추적을 직접 다뤄야 할 때 적합합니다.
| 사용 방식 | 원하는 작업 |
|---|---|
| App + chat connector (이 페이지) | 공유 Linear 연결을 chat과 published app에서 사용 |
| Chat connector (MCP server) | 빌드 중 개인 Linear 계정을 Lovable의 context로 사용 |
| App user connector | Published app의 각 사용자가 자신의 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 커넥터로 이동
Connectors → App 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 연결 관리
연결은 Connectors에서 관리합니다. **Linear**을 선택한 다음 연결을 여세요.
- Unlink projects를 사용하면 다른 프로젝트에서 연결을 계속 사용할 수 있도록 유지하면서 특정 프로젝트의 Linear 접근 권한만 제거할 수 있습니다. 단계별 절차는 연결에서 프로젝트 연결 해제를 참고하세요.
- Delete the connection을 사용하면 워크스페이스에서 연결을 완전히 제거할 수 있습니다. 삭제는 영구적이며 연결된 모든 프로젝트에서 자격 증명이 제거되고, Linear을 사용하는 앱 기능은 새 연결을 추가할 때까지 작동하지 않습니다. 단계와 삭제 권한은 연결 삭제를 참고하세요.