Notion 연결
Notion 워크스페이스를 Rephlo에 연결하면 AI가 채팅의 일부로 페이지와 데이터베이스를 검색하고 수정할 수 있습니다. Notion 커넥터는 Starter, Pro, Pro+, Elite, Enterprise 플랜에서 사용할 수 있으며, Trial 기간에도 사용할 수 있습니다. 각 플랜에 포함된 내용은 플랜 및 가격을 참조하십시오.
Notion은 데스크톱 앱의 Settings → Connectors에서 연결합니다. 커넥터 작동 방식에 대한 배경 지식은 커넥터 개요를 참조하십시오.
할 수 있는 작업
Notion이 연결되어 있고 컴포저의 Connectors 메뉴에서 선택되어 있으면, 모델은 사용자를 대신하여 다음 도구를 호출할 수 있습니다.
- 쿼리, 태그, 날짜로 페이지와 데이터베이스를 **검색(Search)**합니다.
- 블록과 데이터베이스 행을 포함하여 페이지의 콘텐츠를 읽습니다(Read).
- 새 페이지 또는 데이터베이스 행을 생성합니다(Create).
- 블록 추가, 속성 편집, 상태 변경 등 기존 페이지를 업데이트합니다(Update).
각 도구 호출은 채팅에서 도구 이름, 상태, 소요 시간을 보여주는 작은 브레드크럼(breadcrumb) 카드로 표시됩니다 — 이를 통해 원시 출력을 스크롤하지 않고도 AI가 정확히 무엇을 했는지 확인할 수 있습니다.
연결 방법
- 데스크톱 앱에서 Settings → Connectors를 엽니다.
- Notion 카드를 찾아 Connect를 클릭합니다.
- 기본 브라우저에서 Notion의 인증(authorization) 페이지가 열립니다. 필요한 경우 로그인합니다.
- Rephlo가 액세스할 Notion 워크스페이스와 페이지를 선택합니다. 특정 페이지와 데이터베이스에만 액세스 권한을 부여할 수 있습니다 — Notion은 워크스페이스 전체에 대한 액세스를 요구하지 않습니다.
- 승인(Approve)합니다. 브라우저가 제어권을 Rephlo로 다시 넘기고, 카드가 Connected 배지로 전환됩니다.
Settings의 Notion 커넥터 카드 — 연결 전과 연결 후.
전체 흐름은 PKCE와 Dynamic Client Registration을 사용하는 OAuth 2.1을 기반으로 합니다. 공유되는 자격 증명이 없고 복사해서 주고받아야 하는 API 키도 없습니다 — 사용자의 액세스는 사용자 계정으로 범위가 지정되며, Notion 자체의 통합(integration) 설정에서 언제든지 취소할 수 있습니다.
Rephlo가 요청하는 권한
| 권한 | AI가 할 수 있는 작업 |
|---|---|
| Read content | 커넥터에 명시적으로 공유한 페이지와 데이터베이스를 읽습니다. |
| Update content | 공유한 페이지와 데이터베이스 행을 편집합니다. |
| Insert content | 공유한 워크스페이스에 새 페이지와 행을 추가합니다. |
Rephlo는 인증 단계에서 커넥터에 공유하지 않은 페이지에는 절대 액세스할 수 없습니다. 공유 범위를 넓히거나 좁히려면 언제든지 이 흐름을 다시 실행할 수 있습니다.
데이터 저장 위치
- **인증 토큰(Authorization tokens)**은 사용자의 기기에서 Rephlo의 애플리케이션 데이터 폴더에 암호화되어 저장됩니다. 이 토큰은 절대 기기 밖으로 나가지 않으며 — Rephlo의 백엔드도 이를 볼 수 없습니다.
- 도구 결과(Tool results)(예: 검색으로 반환된 페이지)는 채팅 세션이 활성화되어 있는 동안에만 메모리에 존재합니다. 전체 결과는 디스크에 저장되지 않으며, 채팅 브레드크럼에는 짧은 텍스트 요약만 표시됩니다.
- 사용자 기기의 **감사 로그(audit log)**는 모든 connect, disconnect, refresh, 도구 호출을 기록합니다 — 커넥터 이름, 도구 이름, 소요 시간, 상태만 기록됩니다. 도구 인자(tool arguments)와 결과 콘텐츠는 절대 로그에 남지 않습니다.
채팅에서 Notion 사용하기
컴포저의 Connectors 메뉴에서 Notion이 선택되어 있는지 확인하십시오. 그런 다음 자연스럽게 질문하면 됩니 다 — 예를 들어 "Notion에서 내 Q3 계획 페이지를 찾아 미완료 작업을 요약해 줘." AI는 검색 및 읽기 도구를 호출하며, 작업이 진행되는 동안 브레드크럼을 확인할 수 있습니다.
연결 해제
Notion 카드에서 Disconnect를 클릭하면 다음이 수행됩니다.
- 진행 중인 모든 Notion 도구 호출을 취소합니다.
- Notion과의 연결을 종료합니다.
- 액세스 토큰과 리프레시 토큰을 Notion 측에서 최선을 다해(best-effort) 취소합니다.
- 캐시된 도구 목록과 연결 정보를 로컬 데이터베이스에서 삭제합니다.
과거 Notion 도구 호출의 히스토리 브레드크럼은 유지됩니다 — 이는 활성 자격 증명이 아니라 발생한 일에 대한 기록입니다.
Notion 측에서도 Rephlo의 액세스를 취소하고 싶다면(완전한 정리를 위해 권장), Notion에서 → Settings & Members → Integrations를 열고 Rephlo를 제거하십시오.
문제 해결
"Authorization failed — please try again." 일반적으로 오래된 브라우저 세션이나 중단된 로그인 과정 때문입니다. Notion 카드에서 Connect를 다시 클릭하십시오.
연결 상태가 "Needs re-auth."로 표시됨. 액세스 권한이 만료되었거나 Notion 측에서 취소되었습니다. 카드의 상세 패널을 열고 다시 인증하십시오.
"Some tools are unavailable because they need additional permissions." Rephlo가 요청한 것보다 적은 권한을 부여했습니다. Reconnect를 클릭하고 전체 권한을 수락하면 모든 도구를 다시 사용할 수 있습니다.
도구 호출에서 프로토콜 오류가 발생함. 대부분 Notion의 일시적인 장애입니다. 몇 분 후 다시 시도하십시오 — 채팅은 계속되며, 실패한 호출만 영향을 받습니다.
도구 호출이 시간 초과됨. 오래 걸리는 작업(대규모 검색, 큰 페이지 읽기)은 호출당 60초 제한에 걸릴 수 있습니다. 더 좁은 범위의 쿼리를 시도하거나 작업을 더 작은 요청으로 나누어 보십시오.
다음 단계
새로운 커넥터가 정기적으로 추가되고 있습니다 — 오늘 연결 가능한 항목과 향후 지원 예정 항목의 최신 전체 목록은 커넥터 개요를 참조하십시오. 직접 운영하는 서버를 지금 바로 추가할 수도 있습니다. 커스텀 MCP 서버를 참조하십시오.