---
title: OpenConnector용 Notion OAuth 앱 생성
description: Notion 퍼블릭 연결을 생성하고 OAuth 리디렉션 URI를 구성한 뒤 Notion을 OOMOL OpenConnector에 연결합니다.
lang: ko
canonical_url: https://oomol.com/ko/docs/openconnector-notion-oauth-app/
markdown_url: https://oomol.com/ko/docs/openconnector-notion-oauth-app.md
---

# OpenConnector용 Notion OAuth 앱 생성

OpenConnector가 사용자가 OAuth를 통해 워크스페이스 페이지나 데이터베이스를 승인하도록 해야 할 때는 Notion 퍼블릭 연결을 사용하세요. Notion은 내부 통합 시크릿도 지원하지만, 사용자 승인 흐름을 원할 때는 OAuth가 적절한 방법입니다.

## OpenConnector 서비스

| Service ID | Provider | Auth type |
| --- | --- | --- |
| `notion` | Notion | OAuth2 |

OpenConnector의 Notion OAuth 제공자는 `read_content`, `insert_content`, `update_content` 등의 권한을 요청합니다.

## 사전 요구 사항

- 실행 중인 OpenConnector 런타임.
- Notion integrations 개발자 포털에 대한 접근.
- 퍼블릭 연결을 생성할 수 있는 권한.
- 사용자가 브라우저에서 여는 OpenConnector 오리진(예: `http://localhost:3000` 또는 `https://connect.example.com`).

## 1단계: OpenConnector 콜백 URL 설정

OpenConnector 오리진에 `/oauth/callback`를 추가하여 콜백 URL을 만듭니다. 로컬 테스트에는 `http://localhost:3000/oauth/callback`을 사용하세요. 퍼블릭 배포에는 `OOMOL_CONNECT_ORIGIN`을 설정하고 OpenConnector를 재시작한 뒤 `https://connect.example.com/oauth/callback`와 같은 퍼블릭 콜백 URL을 사용하세요.

## 2단계: Notion 퍼블릭 연결 생성

[Notion integrations 개발자 포털](https://www.notion.com/my-integrations)에서:

1. 새 퍼블릭 연결을 생성합니다.
2. 연결 이름과 워크스페이스 세부 정보를 입력합니다.
3. OAuth 리디렉션 URI 구성에 정확한 OpenConnector 콜백 URL을 추가합니다.
4. 사용 사례에 맞는 설치 범위를 선택합니다.
5. OpenConnector 액션에 필요한 콘텐츠 권한을 구성합니다.
6. 연결을 저장합니다.

Notion의 공식 가이드는 [Authorization](https://developers.notion.com/guides/get-started/authorization)입니다. Notion은 퍼블릭 연결을 생성할 때 설치 범위를 선택한다고 안내하므로 신중하게 선택하세요.

## 3단계: 클라이언트 자격 증명 복사

Notion 퍼블릭 연결 설정에서 다음을 복사합니다:

| Notion 값 | OpenConnector 필드 |
| --- | --- |
| OAuth client ID | `clientId` |
| OAuth client secret | `clientSecret` |

## 4단계: OpenConnector에 Notion 클라이언트 저장

OpenConnector 웹 콘솔을 사용합니다:

1. OpenConnector 웹 콘솔(예: `http://localhost:3000`)을 엽니다.
2. **Providers**를 열고 **Notion**을 선택합니다.
3. **Configure OAuth Client** 또는 **Edit OAuth Client**를 선택합니다.
4. Notion client ID와 client secret을 붙여넣습니다.
5. **Save OAuth Client**를 선택합니다.

## 5단계: 연결 및 테스트

OAuth 클라이언트를 저장한 뒤 Notion 제공자 페이지에서 **Connect**를 선택합니다. 공유할 Notion 워크스페이스 콘텐츠를 선택하고, 접근을 승인하고, OpenConnector로 돌아와 제공자 페이지에 워크스페이스가 연결된 것으로 표시되는지 확인합니다.

콘솔 액션 목록에서 `notion.search` 또는 `notion.list_users`을 위험 부담이 낮은 테스트 액션으로 사용하세요.

## 문제 해결

| 증상 | 확인할 사항 |
| --- | --- |
| Notion이 리디렉션 URI를 거부함 | Notion의 OAuth 리디렉션 URI가 `<openconnector-origin>/oauth/callback`과 정확히 일치해야 합니다. |
| 공유 콘텐츠가 누락됨 | 승인 중에 연결이 접근해야 할 페이지 또는 데이터베이스를 선택하세요. Notion 접근은 공유 콘텐츠로 범위가 제한됩니다. |
| 쓰기 액션이 실패함 | Notion 연결에 콘텐츠 삽입 또는 업데이트 권한이 있고 공유 페이지/데이터베이스가 해당 작업을 허용하는지 확인하세요. |
| 잘못된 워크스페이스가 연결됨 | 의도한 Notion 워크스페이스에 로그인된 브라우저 프로필에서 승인을 시작하세요. |
| 내부 통합 토큰과 OAuth 혼동 | 이 가이드에는 OAuth client ID와 client secret을 사용하세요. 내부 통합 시크릿은 다른 설정 경로입니다. |