OAuth 설정 관리
OAuth 설정은 OAuth 파트너 앱과 Braze MCP 서버에 대한 회사 전체 액세스를 관리합니다. 이 설정을 사용하여 워크스페이스별로 파트너 앱을 승인하거나 차단하고, Braze에 연결할 수 있는 MCP 클라이언트와 리디렉트 URI를 제어하며, 회사의 모든 MCP OAuth 토큰을 취소할 수 있습니다.
OAuth 설정은 회사 전체에 적용됩니다. 각 사용자에게 할당된 권한에 따라 파트너 앱과 MCP 서버를 통해 액세스할 수 있는 워크스페이스와 기능이 결정됩니다.
요구 사항
| 요구 사항 | 설명 |
|---|---|
| “관리자” 권한 | OAuth 설정을 보거나, OAuth 파트너 앱을 관리하거나, MCP OAuth 액세스를 켜거나 끄거나, MCP 클라이언트를 승인 또는 제거하거나, 리디렉션 URI를 관리하거나, MCP OAuth 토큰을 취소하려면 회사 수준의 “관리자” 권한이 있어야 합니다. |
| “MCP 서버 사용” 권한 | 사용자는 MCP 서버를 통해 액세스하려는 각 워크스페이스에 대해 이 권한이 있어야 합니다. 이 권한은 OAuth 설정 관리에 사용되는 “관리자” 권한과는 별개입니다. |
권한 할당에 대한 자세한 내용은 사용자 권한을 참조하세요.
OAuth 액세스 작동 방식
OAuth 설정과 사용자 권한은 함께 작동합니다.
- 회사 전체 OAuth 설정은 사용자가 파트너 앱과 MCP 클라이언트를 Braze에 연결할 수 있는지 여부를 결정합니다.
- OAuth 파트너 앱 정책은 각 워크스페이스에서 승인되거나 차단되는 파트너 앱을 결정합니다.
- “MCP 서버 사용” 권한은 개별 사용자가 워크스페이스에서 MCP 서버를 사용할 수 있는지 여부를 결정합니다.
- 사용자의 기존 대시보드 권한은 MCP 클라이언트 또는 파트너 앱이 액세스할 수 있는 Braze 데이터와 기능을 결정합니다.
- 하나의 OAuth 연결은 사용자가 액세스 권한을 가진 워크스페이스에만 액세스할 수 있습니다.
MCP OAuth 액세스 또는 파트너 앱 OAuth 액세스를 켜도 사용자에게 새로운 워크스페이스 권한이 부여되지는 않습니다. 마찬가지로 대시보드 권한을 제거하면 사용자가 연결한 클라이언트 또는 파트너 앱에서도 해당 기능이 제거됩니다.
회사 및 워크스페이스 제어
OAuth 정책은 회사 수준에서 저장됩니다. 워크스페이스 관리자는 단일 워크스페이스에 대해 파트너 앱 OAuth 액세스, MCP OAuth 액세스 또는 리디렉션 URI 상태를 재정의할 수 없습니다. 다만 파트너 앱 승인을 통해 선택한 워크스페이스로 액세스를 제한할 수는 있습니다.
| 제어 | 구성 위치 | 범위 |
|---|---|---|
| 파트너 앱 OAuth 액세스 및 OAuth 파트너 앱 | 설정 > 관리자 설정 > 외부 연결 | OAuth 설정 탭에서 회사 전체에 대해 인에이블먼트를 설정하고, OAuth 파트너 앱 탭에서 파트너 앱별 승인 또는 차단 상태와 선택한 워크스페이스를 지정합니다. |
| MCP OAuth 액세스 | 외부 연결 > OAuth 설정 | 회사 전체. 이 설정이 꺼져 있으면 모든 워크스페이스에서 MCP OAuth가 거부됩니다. |
| MCP 클라이언트 페이지 | 외부 연결 > MCP 클라이언트 | 회사 전체. 인증된 클라이언트를 승인하면 “MCP 서버 사용” 권한이 있는 사용자가 모든 워크스페이스에서 해당 클라이언트를 연결할 수 있습니다. |
| 승인된 리디렉션 URI | 외부 연결 > MCP 클라이언트 | 회사 전체. 커스텀(및 로컬) 리디렉션 URI는 모든 워크스페이스에 적용됩니다. |
| MCP OAuth 토큰 취소 | 외부 연결 > OAuth 설정 | 회사 전체. 취소는 모든 워크스페이스의 모든 MCP OAuth 토큰에 적용됩니다. |
| “MCP 서버 사용” 권한 | 설정 > 사용자 관리 | 워크스페이스별. 사용자는 MCP 서버를 통해 액세스하는 각 워크스페이스에서 이 권한이 필요합니다. |
“관리자” 권한이 있는 사용자만 파트너 앱 정책 변경, MCP OAuth 액세스 변경, MCP 클라이언트 승인 또는 제거, 리디렉션 URI 상태 변경, MCP OAuth 토큰 취소를 할 수 있습니다. 워크스페이스 권한이 이러한 회사 설정과 어떻게 상호 작용하는지 알아보려면 OAuth 및 MCP 액세스를 참조하세요.
OAuth 파트너 앱
OAuth 파트너 앱 탭에서 회사 사용자가 OAuth로 연결할 수 있는 파트너 앱을 모니터링하고 관리할 수 있습니다.
- 설정 > 관리자 설정 > 외부 연결로 이동합니다.
- OAuth 파트너 앱 탭을 엽니다.
파트너 앱 보기
파트너 앱 목록에는 회사에서 승인했거나 차단한 모든 OAuth 파트너 앱이 표시됩니다. 각 앱에 대해 다음 정보를 확인할 수 있습니다.
| 열 | 설명 |
|---|---|
| 앱 이름 | 파트너 앱의 이름입니다. |
| 마지막 업데이트한 사용자 | 파트너 앱 정책을 마지막으로 변경한 대시보드 사용자입니다. |
| 마지막 업데이트 | 파트너 앱 정책이 마지막으로 변경된 시점입니다. |
| 승인된 워크스페이스 | 회사 사용자가 앱을 연결할 수 있는 워크스페이스입니다. |
| 상태 | 앱이 승인됨 또는 차단됨 상태인지 나타냅니다. |
파트너 앱 찾아보기 및 승인
회사에서 사용할 파트너 앱을 승인하려면 다음 단계를 따르세요.
- OAuth 파트너 앱 탭에서 앱 찾아보기를 선택합니다.
- 검토할 파트너 앱을 선택합니다.
- 앱 승인을 선택한 다음, 모든 워크스페이스 또는 선택한 워크스페이스를 고릅니다.
- 승인을 선택합니다.
기본값으로 모든 워크스페이스가 승인됩니다. 회사 사용자는 승인된 워크스페이스에만 앱을 연결할 수 있습니다. 나중에 워크스페이스 편집을 선택해 워크스페이스 액세스 권한을 변경할 수 있습니다.
앱 세부 정보 검토
파트너 앱을 열면 앱 설명과 권한 범위를 포함한 앱 세부 정보를 확인할 수 있습니다. 각 사용자는 자신의 Braze 권한으로 허용된 작업만 수행할 수 있습니다.
파트너 앱 차단
선택한 워크스페이스에서 사용자가 파트너 앱을 연결하지 못하도록 하려면 다음 단계를 따르세요.
- 파트너 앱 목록 또는 앱 찾아보기에서 파트너 앱을 엽니다.
- 앱 차단을 선택한 다음, 차단할 워크스페이스를 고릅니다.
- 작업을 확인합니다.
해당 워크스페이스의 사용자는 즉시 연결이 해제되며, 더 이상 해당 앱으로 로그인하거나 동기화할 수 없습니다. 언제든지 앱을 다시 승인할 수 있습니다.
파트너 앱 OAuth 액세스 켜기 또는 끄기
파트너 앱 OAuth 액세스는 OAuth 설정 탭에 있는 회사 전체 스위치입니다.
- 설정 > 관리자 설정 > 외부 연결로 이동합니다.
- OAuth 설정 탭을 엽니다.
- 글로벌 액세스 제어에서 파트너 앱 OAuth 액세스를 켜거나 끕니다.
파트너 앱 OAuth 액세스가 켜져 있으면 관리자는 OAuth 파트너 앱 탭에서 파트너 앱을 관리할 수 있고, 회사 사용자는 승인된 워크스페이스에서 승인된 파트너 앱을 연결할 수 있습니다. 꺼져 있으면 Braze가 모든 사용자의 파트너 앱 OAuth 액세스를 즉시 해제하고 활성 세션을 종료합니다. 이러한 통합을 통해 이미 동기화된 데이터는 Braze에 그대로 유지됩니다. 파트너 앱 OAuth 액세스를 다시 켜면 기존 연결이 다시 작동합니다.
MCP OAuth 액세스 켜기 또는 끄기
회사의 MCP OAuth 액세스를 업데이트하려면 다음 단계를 따르세요.
- 설정 > 관리자 설정 > 외부 연결로 이동합니다.
- 글로벌 액세스 제어에서 MCP OAuth 액세스를 켜거나 끕니다.
MCP OAuth 액세스가 켜져 있으면 “Use MCP Server” 권한이 있는 사용자가 승인된 MCP 클라이언트를 인증할 수 있습니다. 꺼져 있으면 회사의 모든 사용자와 워크스페이스에서 MCP 서버에 대한 OAuth 액세스가 거부되며, MCP 클라이언트 탭을 사용할 수 없습니다.
MCP OAuth 액세스를 꺼도 구성된 리디렉션 URI는 제거되거나 차단되지 않습니다. 다만 Braze가 회사의 기존 MCP OAuth 토큰을 취소하므로, 연결된 MCP 클라이언트는 액세스 권한을 잃게 됩니다.
MCP 클라이언트 관리
MCP 클라이언트 탭에서는 사용자가 연결할 수 있는 Braze 검증 MCP 클라이언트를 관리합니다. Braze 검증 목록에 없는 클라이언트의 커스텀 리디렉션 URI도 이 탭에서 관리합니다.

회사에서 해당 클라이언트(Braze 검증 클라이언트의 경우) 또는 해당 리디렉션 URI(커스텀 클라이언트의 경우)를 승인해야 사용자가 MCP 클라이언트 연결을 완료할 수 있습니다. 검증된 클라이언트를 승인하면 “Use MCP Server” 권한이 있는 사용자가 모든 워크스페이스에서 해당 클라이언트를 연결할 수 있습니다.
검증된 MCP 클라이언트
Braze는 검증된 MCP 클라이언트 목록을 미리 등록해 둡니다. 따라서 리디렉션 URI를 직접 붙여넣지 않고 이름으로 클라이언트를 승인할 수 있습니다. 클라이언트를 승인하면 검증된 MCP 클라이언트 아래에 승인됨 상태로 표시됩니다.
- ChatGPT
- Claude
- Claude Code
- Cursor
- OpenAI Codex
- Visual Studio Code
검증된 클라이언트 찾아보기 및 승인
- 설정 > 관리자 설정 > 외부 연결로 이동합니다.
- OAuth 설정에서 MCP OAuth 액세스가 켜져 있는지 확인합니다.
- MCP 클라이언트 탭을 엽니다.
- MCP 클라이언트 추가 > 검증된 MCP 클라이언트 찾아보기를 선택합니다. 아직 승인한 클라이언트가 없다면 MCP 클라이언트 찾아보기를 선택합니다.
- 목록을 검색하거나 필터링한 다음, 허용할 클라이언트를 엽니다.
- 클라이언트 세부 정보와 지원되는 환경(예: 웹, 데스크톱, 터미널)을 검토한 후 설정 완료를 선택합니다.
일부 클라이언트는 각 사용자 컴퓨터의 로컬 주소(예: http://localhost/... 또는 커스텀 스킴)를 통해서만 연결됩니다. 로컬 주소는 특정 앱에만 고유하지 않습니다. 따라서 로컬 주소를 승인하면 같은 주소를 사용하는 다른 앱도 Braze에 도달할 수 있습니다. 로컬 주소가 필요한 클라이언트를 승인하면 Braze에서 해당 주소도 함께 승인하도록 요청할 수 있습니다. 클라이언트 제거나 URI 상태 변경은 나중에 할 수 있습니다.
MCP 클라이언트 상태
| 상태 | 의미 |
|---|---|
| 승인되지 않음 | 회사에서 아직 클라이언트를 승인하지 않았습니다. 클라이언트가 승인 목록에 없으므로 사용자가 연결할 수 없습니다. |
| 승인됨 | “Use MCP Server” 권한이 있는 사용자가 이 클라이언트를 연결할 수 있습니다. 클라이언트의 리디렉션 URI 중 차단된 URI가 없습니다. |
| 부분 액세스 | 클라이언트는 승인되었지만 리디렉션 URI 표에서 하나 이상의 리디렉션 URI가 차단됨 상태입니다. 사용자는 클라이언트의 나머지 승인된 주소를 통해 계속 연결할 수 있습니다. |
| 액세스 없음 | 클라이언트는 승인되었지만 모든 리디렉션 URI가 차단됨 상태입니다. 하나 이상의 주소에 대한 차단을 해제해야 사용자가 클라이언트를 연결할 수 있습니다. |
검증된 클라이언트 제거
승인 목록에서 검증된 클라이언트를 제거하려면 MCP 클라이언트 탭에서 해당 클라이언트를 열고 MCP 클라이언트 제거를 선택합니다. 제거한 클라이언트는 검증된 MCP 클라이언트 찾아보기에서 다시 승인해야 사용자가 연결할 수 있습니다.
클라이언트를 제거해도 이미 연결된 사용자의 세션은 종료되지 않습니다. 해당 세션을 종료하려면 MCP OAuth 토큰 취소를 선택합니다.
커스텀 리디렉션 URI 관리
MCP OAuth access를 켜면 MCP Clients 탭의 Approved redirect URIs 섹션에 로컬 MCP 클라이언트 또는 Braze가 검증하지 않은 원격 클라이언트의 커스텀 리디렉션 URI가 표시됩니다. 검증된 MCP 클라이언트 중에 원하는 클라이언트가 없을 때 이 목록을 사용하세요. 형식 지정 방법은 리디렉션 URI 형식을 참조하세요.
검증된 MCP 클라이언트를 둘러보지 않고 URI를 추가하려면 Add MCP client > Add custom redirect URIs를 선택할 수도 있습니다.
Approved redirect URIs 테이블에는 다음 정보가 표시됩니다.
| 열 | 설명 |
|---|---|
| Redirect URI | Braze가 클라이언트의 콜백과 대조하는 정확한 주소(경로 포함)입니다. |
| Added by | URI를 추가했거나 마지막으로 업데이트한 대시보드 사용자입니다. |
| Date added | URI가 추가되었거나 마지막으로 업데이트된 시점입니다. |
| Status | URI가 Approved 상태인지 Blocked 상태인지 나타냅니다. |
| Actions | 현재 상태에 따라 Block, Unblock 또는 Delete redirect URI를 선택할 수 있습니다. |
리디렉션 URI 형식
| URI 유형 | 추가할 때 사용할 형식 |
|---|---|
| 로컬(루프백 주소) | http://localhost 또는 http://127.0.0.1로 시작합니다. 어떤 로컬 포트든 일치할 수 있도록 포트(호스트 뒤의 콜론과 숫자)는 생략하세요. 예를 들어 클라이언트에 http://localhost:33491/oauth/callback이 표시되면 http://localhost/oauth/callback을 입력합니다. 추가하는 URI에 포트(예: :33491)를 유지하면 Braze는 해당 포트만 일치시킵니다. |
| 원격 주소 | 클라이언트에 표시된 그대로 전체 주소를 입력합니다(예: https://app.example.com/callback). |
| 커스텀 스킴 | http:// 또는 https://가 아닌 커스텀 URI 스킴(예: cursor://)으로 시작합니다. 표시된 그대로 정확히 입력하세요. 일부 데스크톱 앱에서 이러한 주소를 사용합니다. |
커스텀 리디렉션 URI 추가
Braze에서 검증하지 않은 MCP 클라이언트를 허용하려면 다음 단계를 따르세요.
- MCP Clients 탭을 열고 Add MCP client > Add custom redirect URIs를 선택하거나, Approved redirect URIs 섹션에서 Add redirect URI를 선택합니다.
- 클라이언트의 OAuth 또는 통합 설정에서 확인한 콜백 프로토콜을 포함한 전체 리디렉션 URI를 입력합니다. 클라이언트의 콜백과 일치시키는 데 도움이 필요하면 리디렉션 URI 형식 표를 참조하세요.
- Save를 선택합니다.
로컬 클라이언트의 경우, 추가하는 리디렉션 URI에 127.0.0.1을 사용하고 포트 번호는 생략하세요.
커스텀 클라이언트의 새 OAuth 인증은 Approved 상태인 리디렉션 URI로만 완료할 수 있습니다. 클라이언트의 리디렉션 URI가 목록에 없거나 상태가 Blocked이면 Braze는 인증 요청을 거부합니다. Braze에서 검증한 클라이언트의 경우, URI를 직접 추가하기보다는 MCP Clients 페이지에서 클라이언트를 승인하는 것을 권장합니다.
리디렉션 URI 차단
리디렉션 URI에서 새 OAuth 인증이 이루어지지 않도록 하려면 해당 행에서 Block을 선택하고 작업을 확인하세요. Braze는 URI 기록을 유지하고 상태를 Blocked로 변경합니다.
리디렉션 URI를 차단해도 해당 MCP 클라이언트에 이미 연결된 사용자의 토큰은 취소되지 않습니다. 해당 세션을 종료하려면 Revoke MCP OAuth tokens를 선택하세요. URI 차단은 해당 콜백을 통한 새 인증을 막는 별도의 작업입니다.
또는 사용자에게서 “Use MCP Server” 권한을 제거하여 해당 사용자만 MCP 서버를 사용하지 못하게 할 수도 있습니다. 다른 사용자의 MCP 연결은 Revoke MCP OAuth tokens를 선택하기 전까지 활성 상태로 유지됩니다.
리디렉션 URI 차단 해제
차단된 리디렉션 URI의 액세스를 복원하려면 해당 행에서 Unblock을 선택하고 작업을 확인하세요. Braze는 중복 기록을 만들지 않고 기존 기록을 Approved로 업데이트합니다.
이전에 해당 MCP 클라이언트에 연결되어 있던 사용자는 다시 인증해야 합니다.
리디렉션 URI 삭제
Approved redirect URIs 목록에서 리디렉션 URI를 제거하려면 해당 행에서 Delete redirect URI를 선택하고 작업을 확인하세요.
- URI가 Approved 상태였다면, 해당 주소를 사용하는 승인된 마켓플레이스 클라이언트는 여전히 이 주소를 통해 연결할 수 있습니다. 커스텀 목록 항목에만 의존하던 다른 앱은 더 이상 이 주소를 사용할 수 없습니다. 승인된 클라이언트도 이 주소를 사용하지 못하게 하려면 삭제하는 대신 URI를 차단하세요.
- URI가 Blocked 상태였다면, 삭제하면 차단이 해제됩니다. 해당 주소를 사용하는 승인된 클라이언트와 다른 앱이 다시 이 주소를 통해 연결할 수 있습니다. 주소를 계속 차단하려면 목록에 그대로 두세요.
리디렉션 URI를 삭제해도 이미 연결된 사용자의 토큰은 취소되지 않습니다. 해당 세션을 종료하려면 Revoke MCP OAuth tokens를 선택하세요.
MCP OAuth 토큰 취소
토큰을 취소하면 회사 전체의 모든 MCP OAuth 토큰이 한 번에 무효화됩니다. 토큰이 유출되었거나 오용되었다고 생각되면 이 기능을 사용하세요.
회사의 MCP OAuth 토큰을 취소하려면 다음 단계를 따르세요.
- 설정 > 관리자 설정 > 외부 연결로 이동합니다.
- MCP OAuth 토큰 취소에서 MCP OAuth 토큰 취소를 선택합니다.
- 확인 대화 상자를 검토한 다음 토큰 취소를 선택합니다.
Braze는 백그라운드에서 토큰을 취소하고, 취소가 완료되면 확인 메시지를 표시합니다. 연결이 많은 회사의 경우 몇 분 정도 걸릴 수 있습니다. 확인 메시지가 표시될 때까지 외부 연결 페이지를 열어 두세요.

토큰 취소는 되돌릴 수 없습니다. 연결된 모든 MCP 클라이언트가 Braze에 대한 액세스 권한을 잃으며, 각 사용자는 다시 로그인하여 MCP 클라이언트를 다시 연결해야 합니다.
취소로 인해 변경되는 사항
| 항목 | 결과 |
|---|---|
| 액세스 토큰 | 취소됩니다. 사용자가 다시 연결할 때까지 연결된 MCP 클라이언트가 작동하지 않습니다. |
| 새로 고침 토큰 | 취소됩니다. MCP 클라이언트가 백그라운드에서 자동으로 다시 연결할 수 없습니다. 사용자가 직접 다시 연결해야 합니다. |
| MCP OAuth 액세스 | 변경되지 않습니다. 켜져 있었다면 사용자가 즉시 다시 연결할 수 있습니다. |
| 승인된 리디렉션 URI | 변경되지 않습니다. 승인된 URI와 차단된 URI는 그대로 유지됩니다. |
| “MCP 서버 사용” 권한 | 변경되지 않습니다. 사용자는 권한을 유지하며 다시 연결할 수 있습니다. |
| 새 연결 | 영향을 받지 않습니다. 취소를 시작한 후에 생성된 연결은 계속 작동합니다. |
취소 시점에 이미 진행 중이던 요청은 회수되지 않습니다. 현재 세션만 종료하는 대신 모든 MCP 액세스를 중지하려면 MCP OAuth 액세스를 끄세요(이 작업을 하면 MCP OAuth 토큰도 취소됩니다). 특정 사용자 한 명의 MCP 액세스를 제거하려면 해당 사용자에게서 “MCP 서버 사용” 권한을 제거하세요.
취소가 완료되지 않으면 Braze에 오류 메시지가 표시됩니다. 일부 토큰은 이미 취소되었을 수 있으므로 다시 시도하기 전에 지원팀에 문의하세요.
차단된 연결 문제 해결
사용자가 MCP 클라이언트를 Braze에 연결할 때 “This app needs approval” 또는 “An unexpected error occurred”와 같은 일반 오류가 표시된다면, 회사에서 해당 클라이언트나 리디렉션 URI를 승인하지 않았을 수 있습니다.
- 설정 > 관리자 설정 > 외부 연결 > MCP 클라이언트로 이동합니다.
- Braze 인증 클라이언트라면 인증된 MCP 클라이언트 또는 인증된 MCP 클라이언트 찾아보기에서 해당 클라이언트를 엽니다. 승인 목록에 없다면 필요한 로컬 주소를 포함하여 클라이언트를 승인합니다.
- 인증되지 않은 클라이언트라면 승인된 리디렉션 URI 표에서 해당 리디렉션 URI를 찾습니다. 목록에 없다면 URI를 추가하고, 상태가 차단됨이라면 차단 해제를 선택합니다.
- 사용자에게 MCP 클라이언트를 다시 연결하도록 요청합니다.
클라이언트나 리디렉션 URI가 승인되었는데도 연결에 계속 실패한다면, MCP OAuth 액세스가 켜져 있는지, 그리고 사용자에게 “Use MCP Server” 권한이 있는지 확인하세요. 자세한 문제 해결 방법은 Braze MCP 서버 설정하기를 참조하세요.
OAuth 활동 감사
Braze는 MCP 서버에 대한 OAuth 연결을 보안 이벤트 보고서에 기록합니다. 이 보고서로 사용자가 OAuth를 통해 연결한 시점을 감사할 수 있습니다.
특정 사용자의 MCP 액세스 권한을 취소하려면 해당 사용자에게서 “Use MCP Server” 권한을 제거하세요. 회사의 모든 MCP OAuth 토큰을 취소하려면 MCP OAuth 토큰 취소를 참조하세요. 설정 및 문제 해결 안내는 Braze MCP 서버 설정을 참조하세요.