외부 MCP 서버
외부 MCP 서버를 사용하면 Braze의 AI 어시스턴트인 BrazeAI OperatorTM가 Jira, Notion, GitHub 등 팀에서 사용하는 다른 제품의 도구를 사용할 수 있습니다. Operator는 Jira의 브리프처럼 작업에 필요한 컨텍스트를 가져오고, Braze에서의 대화만으로 해당 제품에서 작업을 수행할 수 있습니다.

External MCP servers은(는) 현재 조기 액세스 단계입니다. 조기 액세스 참여에 관심이 있으시면 담당 Braze 계정 매니저에게 문의하세요.
MCP 서버 정보
모델 컨텍스트 프로토콜(MCP)은 AI 도구가 다른 소프트웨어에 연결할 수 있게 해 주는 개방형 표준입니다. 많은 제품이 자사의 데이터와 작업을 도구로 사용할 수 있게 해 주는 MCP 서버를 제공합니다.
Braze에 MCP 서버를 추가하면 Operator는 Braze에 이미 있는 도구와 함께 해당 서버의 도구를 사용할 수 있습니다. 예를 들어 Operator에게 다음과 같이 요청할 수 있습니다.
- “Jira에서 연말 시즌 출시 브리프를 가져와서 거기에 설명된 Canvas를 만들어 줘.”
- “Notion 데이터베이스에 있는 히어로 이미지를 사용해서 새 이메일 템플릿을 만들어 줘.”
- “지난주 이메일 성능 요약을 팀 채널에 게시해 줘.”
설정은 세 부분으로 구성됩니다.
- 관리자가 서버를 추가합니다. 서버가 개인 액세스를 사용하는 경우 관리자가 서버에 연결한 다음, Operator가 사용할 수 있는 도구를 선택합니다.
- 각 사용자가 자신의 계정을 도구에 연결합니다(서버에서 필요한 경우). Operator는 해당 사용자가 그 도구에서 볼 수 있고 할 수 있는 것만 보고 수행합니다.
- 사용자가 Operator에게 요청합니다. Operator는 작업에 맞는 도구를 찾고, 다른 도구에서 무언가를 변경하기 전에 승인을 요청합니다.
MintMCP 같은 엔터프라이즈 MCP 게이트웨이 뒤에 있는 서버를 포함해 Braze가 URL로 접근할 수 있는 모든 원격 MCP 서버를 추가할 수 있습니다. 단, 서버가 Braze를 클라이언트로 허용해야만 작동합니다. 일부 서버는 Braze를 자동으로 등록하고, 일부는 등록된 앱이 필요하며, 일부 공급업체는 자체적으로 승인한 AI 클라이언트만 허용합니다. 특정 제품을 기준으로 계획을 세우기 전에 추가 설정이 필요한 서버를 확인하세요. 자신의 컴퓨터에서 실행되는 로컬 MCP 서버는 지원되지 않습니다.

외부 MCP 서버는 Claude, ChatGPT, Cursor 같은 AI 도구가 Braze에서 작업할 수 있게 해 주는 Braze MCP 서버와 다릅니다. 외부 MCP 서버는 반대 방향으로 작동하여 Operator가 다른 제품에서 작업할 수 있게 해 줍니다. Operator에는 이미 Braze MCP 서버의 도구가 내장되어 있으므로 Braze MCP 서버를 MCP 서버로 추가할 수 없습니다.
MCP 서버 작동 방식
MCP 서버는 워크스페이스가 아니라 회사에 속합니다. 관리자가 서버를 추가하고 도구를 허용하면 Operator는 모든 워크스페이스에서 Operator를 사용하는 회사의 모든 사용자를 위해 해당 도구를 사용할 수 있습니다.
각 서버는 다음 두 가지 액세스 유형 중 하나를 사용합니다.
- 개인 액세스: Operator가 서버를 사용하려면 각 사용자가 먼저 자신의 계정을 연결해야 합니다. Operator는 해당 사용자의 계정으로 서버를 사용하므로, 그 사용자가 다른 제품에서 볼 수 있고 할 수 있는 것만 보고 수행할 수 있습니다.
- 공유 액세스: 관리자가 도구를 허용하는 즉시 모든 사용자가 서버의 허용된 도구를 사용할 수 있습니다. 개인 계정이 필요하지 않습니다.
위험 및 안전
신뢰할 수 있는 MCP 서버만 추가하세요. Operator를 신뢰할 수 없는 MCP 서버에 연결하면 고객 데이터 노출, Braze 제품 내에서의 의도하지 않은 작업 등 예상치 못한 결과가 발생할 수 있습니다.
Operator Connect는 MCP 클라이언트를 통해 사용되므로, Braze 대시보드의 Operator와 달리 Braze에서 작업을 수행하기 전에 명시적인 승인을 요청하지 않습니다. 회사에서 Operator Connect를 사용하는 경우, 승인한 MCP 서버 도구는 사람이 각 작업을 승인하지 않아도 실행될 수 있습니다.
위험을 줄이려면 다음을 따르세요.
- Operator에 필요한 도구만 허용하세요.
- 보안팀에서 MCP 게이트웨이를 관리하는 경우 게이트웨이를 통해 서버를 추가하는 것을 고려하세요.
전제 조건

모든 MCP 서버가 Operator와 함께 작동하는 것은 아닙니다. 서버의 작동 여부는 Braze뿐만 아니라 공급업체에 따라서도 달라집니다. 팀에 특정 도구를 약속하기 전에 서버를 추가하고 Operator에서 직접 사용해 보며 작동하는지 확인하세요.
권한
MCP 서버는 회사 수준 권한을 사용합니다. 이 권한은 권한 세트나 역할이 아니라 각 사용자 페이지의 회사 탭에서 할당합니다.
| 권한 | 수행할 수 있는 작업 |
|---|---|
| MCP 서버 보기 | MCP 서버 페이지를 열고 각 서버의 세부 정보와 도구를 확인합니다. |
| MCP 서버 편집 | 서버를 추가 및 편집하고, 서버에 연결하고, Operator가 사용할 수 있는 도구를 선택합니다. |
| MCP 서버 보관 | 서버를 삭제합니다. |
자신의 계정을 서버에 연결하고 Operator에서 해당 도구를 사용하려면 워크스페이스에 대한 “BrazeAI OperatorTM 사용” 권한 또는 “MCP 서버 편집” 권한이 필요합니다. 자세한 내용은 사용자 권한을 참조하세요.
MCP 서버 설정
서버 설정은 세 단계로 진행됩니다. “MCP 서버 편집” 권한이 필요합니다.
- 서버를 추가합니다.
- 서버가 개인 액세스를 사용하는 경우 자신의 계정을 연결하여 서버의 도구를 로드합니다.
- Operator가 사용할 수 있는 도구를 선택합니다.
관리자가 도구를 선택하기 전까지는 어떤 도구도 허용되지 않으므로, 3단계를 완료하기 전까지 Operator는 새 서버를 사용할 수 없습니다.
1단계: 서버 추가
시작하기 전에 공급업체의 MCP 설명서에서 서버 URL과 추가 설정 필요 여부를 확인하세요. 자세한 내용은 추가 설정이 필요한 서버를 참조하세요.
- 에이전트 > MCP 서버로 이동합니다.
- MCP 서버 추가를 선택합니다.
- 이름을 입력합니다. 사용자는 Operator에서 이 이름을 보게 됩니다.
- 서버 URL을 입력합니다. 공급업체의 원격 MCP URL이며
https://로 시작합니다. 입력을 잠시 멈추거나 필드를 벗어나면 Braze가 서버를 확인하고 서버가 Braze를 자동으로 등록하는지 확인합니다. - Braze에 클라이언트 ID 및 클라이언트 시크릿 필드가 표시되면 서버에 등록된 앱이 필요하다는 의미입니다. 앱의 세부 정보를 입력하세요. 자세한 내용은 공급업체에 등록된 앱 사용을 참조하세요.
- 위험 고지를 읽은 다음 이해했으며 계속하겠습니다를 선택합니다. 자세한 내용은 위험 및 안전을 참조하세요.
- 서버 추가를 선택합니다. Braze가 아직 서버를 확인하는 중이면 확인이 끝날 때까지 버튼을 사용할 수 없습니다.
서버의 세부 정보 페이지가 열립니다.
2단계: 연결하여 도구 로드
서버가 공유 액세스를 사용하는 경우 이 단계를 건너뛰세요. 서버를 추가하는 즉시 도구가 표시되고 준비됨 상태로 표시됩니다.
서버가 개인 액세스를 사용하는 경우 서버 세부 정보 페이지 상단에서 연결을 선택하고 다른 제품에 로그인합니다. 많은 서버는 로그인한 사용자에게만 도구를 보여주므로, Braze는 연결한 후에 도구를 나열합니다.
바로 연결하면 설정도 함께 테스트됩니다. 누군가 연결하기 전까지 서버는 테스트되지 않음으로 표시됩니다. 연결에 성공하면 로그인이 작동하고 클라이언트 ID와 시크릿이 올바르다는 것이 확인됩니다.
3단계: 도구 선택
허용된 도구는 회사의 모든 사용자를 위해 Operator에서 사용할 수 있습니다. 도구 섹션은 서버가 각 도구의 기능에 대해 설명하는 내용을 기준으로 도구를 그룹화합니다.
- 읽기: 서버가 읽기 전용으로 표시한 도구입니다.
- 쓰기: 서버가 데이터를 삭제하거나 덮어쓸 수 있다고 표시한 도구입니다.
- 상호작용: 서버가 설명하지 않은 도구를 포함한 기타 모든 도구입니다.
위험을 줄이려면 Operator에 필요한 도구만 허용하세요.
- 서버의 세부 정보 페이지에서 도구 섹션으로 이동합니다.
- Operator가 사용할 수 있는 도구를 허용합니다.
- 서버가 나중에 추가하는 도구를 포함해 모든 도구를 허용하려면 모든 도구 허용을 켭니다.
- 그룹의 현재 도구를 허용하려면 그룹을 펼치고 모두 허용을 켭니다. 서버가 나중에 그룹에 추가하는 도구는 허용하기 전까지 꺼진 상태로 유지됩니다.
- 도구 하나를 허용하려면 해당 그룹을 펼치고 허용됨 열에서 도구를 켭니다. 도구를 찾으려면 도구 검색을 사용하세요.
- 도구 액세스 저장을 선택합니다.

추가 설정이 필요한 서버
모든 MCP 서버가 추가하자마자 작동하는 것은 아니므로, 시작하기 전에 공급업체의 MCP 설명서를 확인하세요. 다음 표는 서버에 필요할 수 있는 추가 설정을 보여줍니다.
| 설정 | 결과 | 해야 할 일 |
|---|---|---|
| 자동 | 서버가 Braze를 자동으로 등록합니다. 가장 일반적인 경우입니다. | 없습니다. 서버를 추가하고 연결하세요. |
| 직접 등록한 앱 | 공급업체에서 먼저 앱을 등록하도록 요구합니다. GitHub, PagerDuty, Slack이 이 방식으로 작동합니다. 서버 URL을 입력하면 Braze에 클라이언트 ID 및 클라이언트 시크릿 필드가 표시됩니다. | 공급업체의 개발자 설정에서 앱을 등록하세요. 공급업체에 등록된 앱 사용을 참조하세요. |
| 공급업체 승인 | 공급업체가 자체 MCP 카탈로그에 등록된 클라이언트처럼 승인한 AI 클라이언트만 허용합니다. Figma가 이 방식으로 작동합니다. 로그인에 실패하거나 공급업체가 Braze를 거부합니다. | 이 설정은 직접 완료할 수 없으며, 공급업체가 Braze를 승인해야 합니다. Braze 계정 매니저에게 문의하고, 공급업체에 담당자가 있다면 공급업체에도 문의하세요. 승인은 공급업체 자체의 검토 절차에 따라 달라지며, Braze는 공급업체의 승인 여부나 시기를 보장할 수 없습니다. 승인 전까지는 Operator에서 해당 서버를 사용할 수 없습니다. |
| 다른 제품의 관리자 설정 | 일부 제품은 해당 제품의 관리자가 서드파티 AI 클라이언트나 MCP 액세스를 허용해야 하며, 일부는 MCP 기능을 특정 요금제로 제한합니다. 연결에 실패하거나 일부 도구가 누락됩니다. | 해당 제품의 관리자에게 확인하세요. |
회사에서 MintMCP 같은 게이트웨이를 통해 MCP 트래픽을 라우팅하는 경우, 서버가 작동하려면 IT팀이 Braze 콜백 URL을 허용하거나 게이트웨이에 서버를 추가해야 할 수도 있습니다.
공급업체에 등록된 앱 사용
- Braze에서 서버 추가를 시작합니다. 표시되는 콜백 URL을 복사합니다.
- 공급업체의 개발자 설정에서 앱을 등록하고 앱 설정에 콜백 URL을 추가합니다.
- Braze에서 앱의 클라이언트 ID와 클라이언트 시크릿을 입력합니다. 공급업체에서 클라이언트 ID만 제공한 경우 시크릿은 비워 두세요.
나중에 등록된 앱 사용을 중지하려면 서버를 편집하고 클라이언트 ID를 지우세요.
계정 연결
서버가 개인 액세스를 사용하는 경우, Operator에게 서버 사용을 요청하기 전에 자신의 계정을 연결하세요. “BrazeAI OperatorTM 사용” 권한 또는 “MCP 서버 편집” 권한이 필요합니다.
- Operator 채팅 패널에서 MCP 서버를 선택합니다.
- 서버를 찾아 연결을 선택합니다.
- 다른 제품에 로그인하고 Braze의 액세스를 승인합니다.
“MCP 서버 보기” 권한이 있는 경우 MCP 서버 페이지의 서버 행이나 서버 세부 정보 페이지 상단에서도 연결할 수 있습니다.
연결은 본인에게만 적용됩니다. 연결을 해제하려면 연결 해제를 선택하세요.
Operator에서 MCP 서버 도구 사용
서버가 설정되고 연결되었다면 Operator에게 필요한 것을 요청하세요. 서버나 도구의 이름을 지정할 필요는 없습니다. Operator는 사용할 Braze 도구를 결정하는 것과 같은 방식으로 도구를 사용할 시점을 결정합니다.
- 페이지 조회나 티켓 검색처럼 읽기 그룹에 속한 도구는 자동으로 실행됩니다.
- 쓰기 및 상호작용 그룹에 속한 도구는 먼저 작업 카드를 표시합니다. 승인하기 전까지는 아무것도 실행되지 않습니다.
Operator가 사용한 도구를 확인하려면 응답에서 도구 목록을 펼치세요.

MCP 서버 관리
회사에서 추가한 모든 서버를 보려면 에이전트 > MCP 서버로 이동하세요. “MCP 서버 보기” 권한이 필요합니다.
상태
목록에는 두 가지 상태가 표시됩니다. MCP 상태는 회사 전체의 서버에 적용되며, “MCP 서버 편집” 권한이 있는 사용자에게만 표시됩니다. 연결 상태는 본인에게만 적용됩니다.

| 열 | 상태 | 의미 |
|---|---|---|
| MCP 상태 | 테스트되지 않음 | 개인 액세스를 사용하는 서버에만 적용됩니다. 아직 아무도 서버에 연결하지 않아 Braze가 서버의 작동 여부를 확인할 수 없습니다. 관리자가 서버 URL, 클라이언트 ID 또는 클라이언트 시크릿을 변경하면 서버는 이 상태로 돌아갑니다. |
| MCP 상태 | 준비됨 | 누군가 서버에 성공적으로 연결했거나 서버가 공유 액세스를 사용합니다. |
| 연결 상태 | 연결됨 | 연결되어 있거나 서버가 공유 액세스를 사용합니다. |
| 연결 상태 | 연결되지 않음 | 아직 계정을 연결하지 않았습니다. |
서버 편집
“MCP 서버 편집” 권한이 필요합니다.
- 서버를 열고 편집을 선택합니다.
- 변경한 다음 변경 사항 저장을 선택합니다.
변경 사항은 Operator에서 해당 서버를 사용하는 회사의 모든 사용자에게 적용됩니다. 서버 URL 또는 등록된 앱을 변경하면 모든 사용자의 연결이 해제되며 각 사용자가 다시 연결해야 합니다. 이름만 변경하면 연결이 해제되지 않습니다.
서버 삭제
“MCP 서버 보관” 권한이 필요합니다.
- 서버를 열고 삭제를 선택합니다.
- 서버를 삭제하면 모든 사용자의 Operator에서 해당 서버의 도구가 제거된다는 것을 확인하는 체크박스를 선택한 다음 삭제를 선택합니다.
서버 삭제는 취소할 수 없습니다. Operator는 더 이상 회사의 누구를 위해서도 해당 서버의 도구를 사용할 수 없으며, 모든 사용자의 서버 로그인 정보가 제거됩니다.
문제 해결
| 메시지 | 해야 할 일 |
|---|---|
| “Braze가 이 서버에 접근할 수 없습니다” | 서버 URL을 확인하고 서버가 온라인 상태인지 확인하세요. |
| “Braze가 이 서버에 연결할 수 없습니다” | 서버 URL이 MCP 서버를 가리키는지, 서버가 온라인 상태인지 확인하세요. |
| “Braze가 이 주소에 연결할 수 없습니다” | 서버 URL을 확인하고 서버가 공용 인터넷에 있는지 확인하세요. |
| “이 서버에는 등록된 앱이 필요합니다” | 공급업체에 앱을 등록한 다음 클라이언트 ID와 시크릿을 입력하세요. 공급업체에 등록된 앱 사용을 참조하세요. |
| “{Vendor}이(가) Braze를 거부했습니다” 또는 “{Vendor}이(가) 로그인을 거부했습니다” | 클라이언트 ID와 시크릿이 공급업체에 등록된 앱과 일치하는지, 앱 설정에 Braze 콜백 URL이 포함되어 있는지 확인한 다음 다시 연결하세요. 공급업체가 Braze를 승인해야 할 수도 있습니다. |
| “이 사이트의 팝업을 허용한 다음 다시 연결하세요.” | 브라우저가 로그인 창을 차단했습니다. Braze 대시보드의 팝업을 허용한 다음 연결을 다시 선택하세요. |
| “{Server}에서 로그인이 완료되지 않았습니다.” | 로그인 창에서 다른 제품 로그인을 완료하거나 다시 연결을 선택하세요. |
| “로그인하는 동안 이 서버가 변경되었습니다.” | 연결하는 동안 관리자가 서버를 편집했습니다. 다시 연결을 선택하세요. |
| “아직 승인된 도구가 없습니다” | 관리자가 서버의 도구를 하나도 허용하지 않았습니다. “MCP 서버 편집” 권한이 있는 사용자에게 필요한 도구를 허용해 달라고 요청하세요. |
자주 묻는 질문
어떤 MCP 서버를 추가할 수 있나요?
엔터프라이즈 MCP 게이트웨이 뒤에 있는 서버를 포함해 Braze가 https:// URL로 접근할 수 있는 모든 원격 MCP 서버를 추가할 수 있습니다. 자신의 컴퓨터에서 실행되는 MCP 서버는 지원되지 않습니다. 일부 서버는 URL 외에 추가 설정이 필요합니다. 자세한 내용은 추가 설정이 필요한 서버를 참조하세요.
Operator가 연결된 제품의 모든 것을 볼 수 있나요?
개인 액세스를 사용하는 서버의 경우 Operator는 사용자의 계정으로 작동하므로, 사용자가 해당 제품에서 볼 수 있고 할 수 있는 것만 보고 수행할 수 있습니다. 관리자는 일부 도구만 허용하여 Operator를 더 제한할 수 있습니다.
서버가 추가된 후 누가 사용할 수 있나요?
어느 워크스페이스에서든 Operator를 사용하는 회사의 모든 사용자가 서버의 허용된 도구를 사용할 수 있습니다. 개인 액세스를 사용하는 서버의 경우 각 사용자가 먼저 자신의 계정을 연결해야 합니다.
Braze MCP 서버와 무엇이 다른가요?
MCP 서버와 Braze MCP 서버는 서로 반대 방향으로 연결됩니다. 다음 표는 MCP 클라이언트와 함께 이들을 비교합니다.
| 기능 | 설명 | 위치 |
|---|---|---|
| 외부 MCP 서버(이 페이지) | Jira, Notion, GitHub 등 Operator가 도구를 사용할 수 있는 다른 제품의 서버입니다. | 에이전트 > MCP 서버 |
| Braze MCP 서버 | Claude, ChatGPT, Cursor 같은 AI 도구가 Braze에서 작업하는 데 사용하는 Braze 자체 MCP 서버입니다. | AI 도구에서 설정 |
| MCP 클라이언트 | 회사에서 Braze MCP 서버에 연결하도록 승인한 AI 도구입니다. | 설정 > 관리자 설정 > 외부 연결 |