Linear

Linear를 연결하면 에이전트가 조사에서 이슈를 등록하고, 상태를 업데이트하고, 발견한 것과 이슈 트래커를 동기화 상태로 유지할 수 있습니다.

설정

1. Linear에서 Settings를 열고 Security & access로 이동합니다.
2. Personal API keys에서 키를 만듭니다. 에이전트가 이슈를 만들고 업데이트할 수 있도록 쓰기 권한이 필요합니다.
3. 키를 Polylane에 붙여 넣습니다. Polylane이 Linear 워크스페이스에 대해 이를 검증하고 연결합니다.

키는 저장 전에 암호화되며 에이전트는 이를 절대 보지 못합니다.

에이전트가 할 수 있는 것

• 팀, 워크플로 상태, 멤버, 프로젝트 나열
• 이슈 나열, 검색, 최근 댓글과 함께 읽기
• 조사 발견 사항에서 증거 흐름을 설명에 담아 이슈 만들기
• 이슈 상태, 우선순위, 담당자, 프로젝트, 라벨, 기한 업데이트
• 발견 사항과 상태를 이슈에 댓글로 남기기
• 위에서 다루지 않은 것을 위해 Linear API에 임의의 GraphQL 실행. 뮤테이션은 같은 확인 게이트를 거침

이슈 쓰기는 실행 전에 항상 확인을 요청합니다.

웹훅과 트리아지

연결하면 모든 공개 팀의 이슈를 다루는 Polylane 웹훅이 Linear 워크스페이스에 등록됩니다. 웹훅이 있으면:

• 긴급으로 바뀐 이슈는 경보로 도착하여 발생하는 대로 트리아지되고, 이슈의 긴급도를 낮추거나 완료하면 경보가 해결됩니다.

웹훅을 만들려면 API 키의 사용자가 Linear의 워크스페이스 관리자여야 합니다. 관리자가 아닌 키도 연결되고 모든 에이전트 도구가 동작하며, 웹훅 기반 트리아지만 건너뜁니다.

문제 해결

"Invalid API key" 오류

• Security & access의 개인 API 키를 사용하세요. OAuth 토큰은 지원되지 않습니다. Polylane은 Linear가 개인 키에 대해 기대하는 대로 Bearer 접두사 없이 키를 그대로 Authorization 헤더에 보냅니다.
• Linear에서 키가 취소되지 않았는지 확인하세요.

Linear에서 경보나 트리거가 오지 않음

• 웹훅 생성에는 워크스페이스 관리자의 키가 필요합니다. 웹훅 기반 트리아지와 트리거를 켜려면 관리자의 키로 다시 연결하세요.

연결 해제

Polylane에서 Linear의 연결을 해제하면 등록한 웹훅도 제거됩니다. 그 다음 Linear에서 API 키를 취소하세요.