TL;DR
Linear 이슈만 보면 맥락을 알 수 없어서 매번 Slack, Notion을 뒤져야 했습니다. "이슈 하나에 관련 문서 다 붙이면 안 되나?"라는 생각으로 Slack/Notion 연동을 시작했고, OAuth deep link 패턴 하나 잡으니 두 서비스 모두 빠르게 연동할 수 있었습니다.
배경: 왜 이걸 만들었나
문제: Linear에서 이슈를 열면 "이게 뭐였더라?" 싶을 때가 많습니다.
Slack에서 논의한 내용이 있었는데... 어디였지?
Notion에 정리해둔 스펙 문서가 있었는데... 뭐였지?
나중엔 Gmail 스레드도 찾아야 하고...
결국 이슈 하나 제대로 파악하려면 3개 앱을 왔다갔다해야 합니다.
이걸 기존에 만들었던 '리니어 캡처'앱에 붙여서 대통합을 하면 어떨까? 생각했습니다.
Linear가 진정한 SSOT(Single Source of Truth)가 되도록, 이슈 생성 시 관련 Slack 메시지, Notion 문서를 자동으로 검색해서 첨부하기.
작업 하이라이트
우선 리니어 캡처 앱에 슬랙과 노션을 연동해야겠죠?
1. OAuth 연동 - deep link 패턴의 위력
Electron 앱에서 OAuth를 구현하는 건 생각보다 까다롭습니다. 앱 내부 웹뷰로 하면 보안 문제가 있고, 시스템 브라우저로 하면 콜백을 어떻게 받을지 고민이었습니다.
해결책: deep link (커스텀 프로토콜)
linear-capture://oauth/slack/callback?code=xxx
시스템 브라우저에서 Slack 로그인
콜백 URL을
linear-capture://스킴으로 설정macOS가 해당 URL을 우리 앱으로 라우팅
앱에서 code를 받아 토큰 교환
이렇게 리니어 캡처 앱 설정에서 'connect'를 누르면
자동으로 슬랙 엑세스 페이지로 넘어가게 되고
리니어 캡처 앱에 슬랙이 연동되어, 원하는 키워드를 검색하면 관련 슬랙 메시지가 뜹니다.
(사실 이런 기능을 원한건 아니고 추후에 고도화를 하겠지만... 일단 연동된걸 확인하는게 이번 phase의 목표였어요)
슬랙 연동 화면
이 패턴을 Slack에서 한번 잡으니까, Notion도 거의 복붙 수준으로 끝났습니다. 같은 구조, 같은 플로우였어요. 앞으로 Gmail, Google Drive 추가할 때도 동일하게 할 수 있지 않을까 생각됩니다.
노션 연동 화면
연동 후 제 개인 워크스페이스에 있는 내용을 검색하면 리스트로 추가됩니다.
2. Notion Search API의 함정
Notion 연동은 순조롭게 됐는데, 검색에서 막혔습니다.
문제: Notion Search API는 페이지 제목만 검색합니다. 본문 내용은 검색이 안 돼요.
"OAuth 구현 방법"이라고 검색하면, 제목에 "OAuth"가 들어간 페이지만 나옵니다. 본문에 OAuth 설명이 잔뜩 있어도 제목이 "인증 가이드"면 안 나와요.
현재 해결책: Blocks API로 페이지 본문을 별도 추출하고 있습니다. 하지만 아직 완벽하진 않아요. 향후 Elasticsearch 같은 자체 인덱싱이 필요할 것 같습니다.
현재 상태
솔직히 말씀드리면, 아직 실사용 단계는 아닙니다. 왜냐하면 '검색'이 아니라 자연스럽게 이슈 설명을 쓰다보면 연관 슬랙/노션이 자연스럽게 추천되고 싱크되는 것까지 생각하고 있거든요.
Slack 검색: 동작함
Notion 검색: 제목 검색은 됨, 본문 검색은 개선 필요
Gmail: 아직 미연동
그래도 OAuth 연동이 잘 되는 걸 눈으로 확인한 것만으로도 의미가 있었습니다.
다음 계획
Notion 본문 검색 개선: Blocks API 활용 또 는 자체 인덱싱
Gmail 연동: 같은 OAuth deep link 패턴 적용
AI 추천: Elasticsearch + 임베딩으로 "이 이슈와 관련된 문서" 자동 추천
궁극적 목표는 이슈 생성할 때 키워드 몇 개 입력하면, 관련 Slack/Notion/Gmail을 AI가 알아서 찾아서 붙여주는 것입니다.
이런 분께 추천드려요
Linear를 쓰는데 맥락 파악이 힘드신 분
Slack, Notion, Gmail을 다 쓰는데 정보가 파편화되신 분
"SSOT"라는 단어에 공감하시는 분
툴 대통합을 꿈꾸시는 분
마무리
아직 미완성이지만, OAuth 패턴 하나 잡은 것만으로도 앞으로의 확장이 훨씬 명확해졌습니다. Slack 되면 Notion 되고, Notion 되면 Gmail도 됩니다.
Linear가 진짜 "모든 맥락의 허브"가 되는 그날까지, 삽질은 계속됩니다.