OAuth 설정 관리
OAuth 설정은 Braze MCP 서버에 대한 회사 전체 액세스를 관리하고, Braze에 연결할 수 있는 MCP 클라이언트 리디렉트 URI를 제어하며, 회사의 모든 MCP OAuth 토큰을 취소할 수 있도록 합니다.
OAuth 설정은 회사 전체에 적용됩니다. 각 사용자에게 할당된 권한에 따라 MCP 서버를 통해 액세스할 수 있는 워크스페이스와 기능이 결정됩니다.
요구 사항
| 요구 사항 | 설명 |
|---|---|
| “Admin” 권한 | OAuth 설정을 확인하거나, MCP OAuth 액세스를 켜거나 끄거나, 리디렉션 URI를 관리하거나, MCP OAuth 토큰을 취소하려면 회사 수준의 “Admin” 권한이 있어야 합니다. |
| “Use MCP Server” 권한 | 사용자는 MCP 서버를 통해 액세스하려는 각 워크스페이스에 대해 이 권한이 있어야 합니다. 이 권한은 OAuth 설정을 관리하는 데 사용되는 “Admin” 권한과는 별개입니다. |
권한 할당에 대한 자세한 내용은 사용자 권한을 참조하세요.
OAuth 액세스의 작동 방식
OAuth 설정과 사용자 권한은 함께 작동합니다.
- 회사 전체 OAuth 설정은 사용자가 MCP 클라이언트를 Braze에 연결할 수 있는지 여부를 결정합니다.
- “Use MCP Server” 권한은 개별 사용자가 워크스페이스에서 MCP 서버를 사용할 수 있는지 여부를 결정합니다.
- 사용자의 기존 대시보드 권한은 MCP 클라이언트가 액세스할 수 있는 Braze 데이터와 기능을 결정합니다.
- 하나의 OAuth 연결은 사용자에게 액세스 권한이 있는 워크스페이스에만 액세스할 수 있습니다.
MCP OAuth 액세스를 켜도 사용자에게 새로운 워크스페이스 권한이 부여되지는 않습니다. 마찬가지로 대시보드 권한을 제거하면 사용자의 연결된 MCP 클라이언트에서도 해당 기능이 제거됩니다.
회사 및 워크스페이스 제어
OAuth 정책은 회사 수준에서 저장됩니다. 워크스페이스 관리자는 단일 워크스페이스에 대해 MCP OAuth 액세스 또는 리디렉션 URI 상태를 재정의할 수 없습니다.
| 제어 | 구성 위치 | 범위 |
|---|---|---|
| MCP OAuth 액세스 | 설정 > 관리자 설정 > 외부 연결 | 회사 전체. 이 설정이 꺼져 있으면 모든 워크스페이스에서 MCP OAuth가 거부됩니다. |
| 승인된 리디렉션 URI | 설정 > 관리자 설정 > 외부 연결 | 회사 전체. 승인 및 차단된 URI는 모든 워크스페이스에 적용됩니다. |
| MCP OAuth 토큰 취소 | 설정 > 관리자 설정 > 외부 연결 | 회사 전체. 취소는 모든 워크스페이스의 모든 MCP OAuth 토큰에 적용됩니다. |
| “MCP 서버 사용” 권한 | 설정 > 사용자 관리 | 워크스페이스별. 사용자는 MCP 서버를 통해 액세스하는 각 워크스페이스에서 이 권한이 있어야 합니다. |
“관리자” 권한이 있는 사용자만 MCP OAuth 액세스를 변경하거나, 리디렉션 URI 상태를 변경하거나, MCP OAuth 토큰을 취소할 수 있습니다. 워크스페이스 권한이 이러한 회사 설정과 어떻게 상호 작용하는지 알아보려면 OAuth 및 MCP 액세스를 참조하세요.
MCP OAuth 액세스 켜기 또는 끄기
회사의 MCP OAuth 액세스를 업데이트하려면 다음 단계를 따르세요.
- 설정 > 관리자 설정 > 외부 연결로 이동합니다.
- 글로벌 액세스 제어에서 MCP OAuth 액세스를 켜거나 끕니다.
MCP OAuth 액세스가 켜져 있으면 “Use MCP Server” 권한이 있는 사용자가 승인된 MCP 클라이언트를 인증할 수 있습니다. 꺼져 있으면 회사의 모든 사용자와 워크스페이스에 대해 MCP 서버에 대한 OAuth 액세스가 거부됩니다.
MCP OAuth 액세스를 꺼도 구성된 리디렉션 URI는 삭제되거나 차단되지 않습니다. 다만 Braze가 회사의 기존 MCP OAuth 토큰을 취소하므로, 연결된 MCP 클라이언트는 액세스 권한을 잃게 됩니다. MCP OAuth 액세스가 꺼져 있는 동안에는 승인된 리디렉션 URI 섹션이 숨겨집니다. 동일한 URI 목록을 다시 관리하려면 액세스를 다시 켜세요.
Braze가 사용자 환경의 원격 MCP 서버를 끈 경우에는 MCP OAuth 액세스 토글이 비활성화됩니다. 이때 원격 MCP 서버가 다시 켜질 때까지 회사 설정이 적용되지 않는다는 메시지가 표시됩니다.
승인된 리디렉션 URI 관리
MCP OAuth 액세스를 켜면 승인된 리디렉션 URI 섹션에 MCP 클라이언트가 인증 중에 사용할 수 있는 리디렉션 URI가 표시됩니다. 형식 안내는 리디렉션 URI 형식을 참조하세요.
회사 관리자는 Claude, ChatGPT, Cursor, OpenAI Codex, Claude Code, Visual Studio Code 같은 클라이언트를 포함한 모든 MCP 클라이언트의 리디렉션 URI를 승인해야 합니다. 클라이언트의 리디렉션 URI가 승인되지 않으면 사용자는 연결을 완료할 수 없습니다. 승인하려면 리디렉션 URI 추가를 참조하세요.
승인된 리디렉션 URI 테이블에는 다음 정보가 표시됩니다.
| 열 | 설명 |
|---|---|
| 리디렉션 URI | Braze가 클라이언트의 콜백과 대조하는 정확한 주소로, 경로를 포함합니다. |
| 추가한 사람 | URI를 추가했거나 마지막으로 업데이트한 대시보드 사용자입니다. |
| 추가된 날짜 | URI가 추가되었거나 마지막으로 업데이트된 시점입니다. |
| 상태 | 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). |
| 커스텀 스킴 | cursor://처럼 http:// 또는 https://가 아닌 커스텀 URI 스킴으로 시작합니다. 표시된 그대로 정확히 입력하세요. 일부 데스크톱 앱에서 이러한 주소를 사용합니다. |
리디렉션 URI 추가
리디렉션 URI가 아직 목록에 없는 MCP 클라이언트를 허용하려면 다음을 수행하세요.
- 리디렉션 URI 추가를 선택합니다.
- 클라이언트의 OAuth 또는 통합 설정에서 콜백 프로토콜을 포함한 전체 리디렉션 URI를 입력합니다. 클라이언트의 콜백과 일치시키는 데 도움이 필요하면 리디렉션 URI 형식 테이블을 참조하세요.
- 저장을 선택합니다.
로컬 클라이언트의 경우 추가하는 리디렉션 URI에 127.0.0.1을 사용하고 포트 번호는 생략하세요.
승인됨 상태인 리디렉션 URI만 새로운 OAuth 인증을 완료할 수 있습니다. 클라이언트의 리디렉션 URI가 목록에 없거나 상태가 차단됨이면 Braze는 인증 요청을 거부합니다.
리디렉션 URI 차단
리디렉션 URI에서 새로운 OAuth 인증이 이루어지지 않도록 하려면 해당 행에서 차단을 선택하고 작업을 확인하세요. Braze는 URI 기록을 유지하고 상태를 차단됨으로 변경합니다.
리디렉션 URI를 차단해도 이미 해당 MCP 클라이언트에 연결된 사용자의 토큰은 취소되지 않습니다. 해당 세션을 종료하려면 MCP OAuth 토큰 취소를 선택하세요. URI 차단은 해당 콜백으로 새로운 인증이 이루어지지 않도록 하는 별도의 작업입니다.
또는 사용자에게서 “MCP 서버 사용” 권한을 제거하면 해당 사용자만 MCP 서버를 사용하지 못하도록 할 수 있습니다. 다른 사용자의 MCP 연결은 MCP OAuth 토큰 취소를 선택할 때까지 활성 상태로 유지됩니다.
리디렉션 URI 차단 해제
차단된 리디렉션 URI의 액세스를 복원하려면 해당 행에서 차단 해제를 선택하고 작업을 확인하세요. Braze는 중복 기록을 만드는 대신 기존 기록을 승인됨으로 업데이트합니다.
이전에 해당 MCP 클라이언트에 연결되어 있던 사용자는 다시 인증해야 합니다.
MCP OAuth 토큰 취소
토큰을 취소하면 회사 전체의 모든 MCP OAuth 토큰이 한 번에 무효화됩니다. 토큰이 유출되었거나 오용되었다고 의심되면 이 기능을 사용하세요.
회사의 MCP OAuth 토큰을 취소하려면 다음 단계를 따르세요.
- 설정 > 관리자 설정 > 외부 연결로 이동합니다.
- MCP OAuth 토큰 취소에서 MCP OAuth 토큰 취소를 선택합니다.
- 확인 대화 상자를 검토한 다음 토큰 취소를 선택합니다.
Braze는 백그라운드에서 토큰을 취소하고, 취소가 완료되면 확인 메시지를 표시합니다. 연결이 많은 회사라면 몇 분 정도 걸릴 수 있습니다. 확인 메시지가 표시될 때까지 외부 연결 페이지를 열어 두세요.
토큰 취소는 되돌릴 수 없습니다. 연결된 모든 MCP 클라이언트가 Braze에 액세스할 수 없게 되며, 각 사용자는 다시 로그인하여 MCP 클라이언트를 다시 연결해야 합니다.
취소 시 변경되는 사항
| 항목 | 결과 |
|---|---|
| 액세스 토큰 | 취소됩니다. 연결된 MCP 클라이언트는 사용자가 다시 연결할 때까지 작동하지 않습니다. |
| 새로 고침 토큰 | 취소됩니다. MCP 클라이언트가 백그라운드에서 자동으로 다시 연결할 수 없습니다. 사용자가 직접 다시 연결해야 합니다. |
| MCP OAuth 액세스 | 변경되지 않습니다. 켜져 있었다면 사용자가 바로 다시 연결할 수 있습니다. |
| 승인된 리디렉션 URI | 변경되지 않습니다. 승인된 URI와 차단된 URI는 그대로 유지됩니다. |
| “Use MCP Server” 권한 | 변경되지 않습니다. 사용자는 권한을 유지하며 다시 연결할 수 있습니다. |
| 새 연결 | 영향을 받지 않습니다. 취소를 시작한 후에 생성된 연결은 계속 작동합니다. |
취소 시점에 이미 진행 중이던 요청은 회수되지 않습니다. 현재 세션만 종료하는 대신 모든 MCP 액세스를 중지하려면 MCP OAuth 액세스를 끄세요(이 경우 MCP OAuth 토큰도 함께 취소됩니다). 특정 사용자 한 명의 MCP 액세스를 제거하려면 해당 사용자에게서 “Use MCP Server” 권한을 제거하세요.
취소가 완료되지 않으면 Braze에서 오류 메시지를 표시합니다. 일부 토큰은 이미 취소되었을 수 있으므로 다시 시도하기 전에 지원팀에 문의하세요.
차단된 연결 문제 해결
사용자가 MCP 클라이언트를 Braze에 연결할 때 “This app needs approval” 메시지나 “An unexpected error occurred” 같은 일반 오류가 표시된다면, 회사에서 해당 클라이언트의 리디렉션 URI를 승인하지 않았을 수 있습니다.
- 설정 > 관리자 설정 > 외부 연결로 이동한 후 승인된 리디렉션 URI 표에서 클라이언트의 리디렉션 URI를 찾습니다. 상태 열에서 해당 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 서버 설정하기를 참조하세요.