사용자 가이드

thumbnail

Linear

Linear 앱을 연동하면 채널웍스 팀챗에서 Linear 이슈를 확인하고 함께 논의할 수 있어요.

채널웍스 팀챗 스레드와 리니어에서 관리 중인 이슈를 연결하면 댓글과 상태 변경이 양쪽으로 동기화됩니다. 업무용 AI CoS에게 요청해서 이슈를 조회·생성·수정할 수도 있어요.

Linear 앱으로 할 수 있는 일은 크게 두 가지예요.

  • 채널웍스 팀챗 댓글로 Linear 이슈를 불러올 수 있어요.

    • Linear 이슈의 댓글과 상태 변경을 스레드 댓글로 받아볼 수 있어요.

    • 반대로 연결된 팀챗 스레드에 댓글을 작성하면, Linear 이슈에 댓글로 확인할 수도 있어요.

  • AI CoS로 Linear 앱에 이슈를 생성하거나, 수정할 수 있어요.

    • Linear 이슈 조회·생성뿐만 아니라 댓글도 작성하고 프로젝트 관리도 요청할 수 있어요.

  • 팀 멤버 각자가 본인 Linear 계정을 각자 소유하고 있어야 해요.

    • 한 명이 대표로 연결해도 다른 멤버는 사용할 수 없어요.

    • 연결한 계정의 접근 권한 범위에서만 이슈 조회나 작업이 가능해요.

  • AI CoS 기능은 AI 에디션의 유료 플랜에서 사용할 수 있어요.

Beta 서비스로 제공되던 AI CoS는 2026년 10월 16일부터 채널웍스 AI 에디션 플랜에서만 이용할 수 있습니다. AI 시트를 보유한 팀 멤버만 사용할 수 있으며 자세한 플랜별 이용 가능 범위는 AI 에디션의 [플랜별 기능 및 한도]에서 확인해 주세요.

  1. 채널톡 관리자 페이지에서 [채널 설정] - [앱스토어] - [Linear] 앱을 선택 후 [설치]를 클릭해 주세요.

  1. Linear 앱 [설정] 화면에서 [채널 계정]과 [내 계정] 모두 [연동하기] 버튼을 눌러 연동해 주세요.

  • 두 계정 모두, Linear에 가입된 본인 이메일로 로그인해야 합니다.

  • 채널 계정

    • ALF가 Linear 이슈를 참고하여 응대하게 하려면, 채널 계정 연동이 필요해요.

    • 추후 채널 계정을 이용한 다양한 Linear 연동 기능이 추가로 업데이트될 수 있어요.

    • 연동하기 버튼을 누른 후, 로그인 화면에서 나타나는 [권한 승인] 팝업은 [Authorize] 버튼을 클릭하여 승인해 주세요.

      • Linear 워크스페이스의 읽기, 쓰기, 실시간 업데이트 수신의 동의이므로 필수로 승인해 주어야 해요.

    • 권한 승인 하단의 팀 접근 범위 선택은, 선택에 따라 노출되는 issue의 범위가 달라질 수 있어요.

  • 내 계정

    • Linear의 등록된 이슈를 불러오기 위해 내 계정 연동이 필요합니다.

    • AI CoS로 Linear 이슈를 생성하고 수정하기 위해서는 내 계정 연동이 꼭 필요해요.

    • 연동하기 버튼을 누른 후, 로그인 화면에서 나타나는 [권한 승인] 팝업은 [Authorize] 버튼을 클릭하여 승인해 주세요.

      • 채널 계정과 동일하게 Linear 워크스페이스의 읽기, 쓰기, 실시간 업데이트 수신의 권한은 필수로 승인해 주셔야 합니다.

연동이 완료되면, [연동하기] 버튼이 [연동 해제] 버튼으로 변경됩니다.

스레드와 Linear 이슈를 연결하면, 이슈의 댓글과 상태 변경 알림을 스레드에서 바로 받을 수 있어요.

  1. 연결하려는 스레드의 댓글 입력 창에, 커맨드를 실행하고 linear-link를 입력해 주세요.

  1. 엔터를 누르면 Linear의 이슈 제목을 입력할 수 있어요.

  1. 검색 결과에서 이슈를 선택하면 연결이 완료돼요.

  • 연결된 Linear 이슈에 댓글을 작성하면, 팀챗 댓글로 전달돼요.

  • 연결된 Linear 이슈의 상태가 변경되면, 팀챗 댓글에 상태 변경 알림이 와요.

연결한 뒤에는 아래 커맨드로 연결 상태를 관리할 수 있어요.

  • linear-status : 현재 연결된 이슈 정보를 확인해요.

  • linear-unlink : 스레드와 이슈의 연결을 해제해요.

    • 해제한 이슈는, linear-link로 다시 연결할 수 있어요.

Linear 계정을 연동하면 채널톡 우측 패널의 AI 에이전트 CoS에게 요청해 팀챗에서 바로 Linear 작업을 할 수 있어요.

아래와 같이 자연어로 요청하면, Linear 앱의 이슈를 생성하거나 수정할 수 있어요.

  • "로그인 오류 관련 이슈 만들어줘"

  • "이슈 상태를 In Progress로 바꿔줘"

  • "현재 내 사이클에 배정된 이슈 목록 보여줘"

일부 기능은 Linear의 플랜과 계정 권한에 따라 사용 범위가 달라질 수 있어요.

  • 특정 스레드와 이슈의 연결만 끊으려면, 해당 스레드에서 linear-unlink 커맨드를 실행해 주세요.

  • 앱 연동 자체를 해제하려면 [채널 설정] - [앱스토어] - Linear 앱 - [설정]으로 접근하여, [연동 해제] 버튼을 눌러 계정 연동을 해제해 주세요.

Linear 이슈에 쓴 댓글은 모두 채널웍스 팀챗에 전달되나요?

아니요. linear-link 커맨드로 Linear 이슈와 연결된 스레드의 댓글만 Linear 댓글로 전달돼요.

Linear 계정은 팀 멤버 한 명이 대표로 연결하면 되나요?

채널 계정은 매니저 한 명만 대표로 연결해도 전 채널에 공유가 가능하지만, 개인 계정의 경우 팀 멤버 각자가 본인 Linear 계정을 직접 연결해야 해요.

연결한 계정의 접근 권한 범위에서만 이슈를 조회하고 작업할 수 있어요.

연결할 이슈가 검색되지 않아요.

연결한 Linear 계정에 해당 이슈의 접근 권한이 있는지 확인해 주세요.

Linear에서 권한이 없는 이슈는 팀 챗 커맨드의 검색 결과에 나오지 않아요.

지금 스레드에 어떤 이슈가 연결되어 있는지 확인하고 싶어요.

해당 스레드에서 linear-status 커맨드를 실행하면 연결된 이슈 정보를 확인할 수 있어요.

Linear 앱을 사용하려면 특정 Linear 플랜이 필요한가요?

일부 기능은 Linear 플랜과 계정 권한에 따라 사용 범위가 달라질 수 있어요.

리니어 가격제 페이지 에서 Linear 앱의 플랜과 가격제를 확인할 수 있어요.

AI CoS에서 Linear를 쓰려면 별도 설정이 필요한가요?

AI CoS 기능은 AI 에디션의 유료 플랜에서 사용할 수 있어요.

AI CoS에 대한 자세한 기능은, CoS 가이드 에서 확인해 보실 수 있어요.