Braze MCP 서버 설정하기

Braze 데이터와 상호작용할 수 있도록 Braze MCP 서버를 설정하는 방법을 배우세요. Claude 및 Cursor와 같은 도구를 사용하여 자연어로 상호작용할 수 있습니다. 더 일반적인 정보는 Braze MCP 서버을 참조하세요.

필수 조건

Before you start, you’ll need the following:

Braze MCP 서버 설정하기

1단계: 설치 uv

먼저, uv—의존성 관리 및 Python 패키지 처리를 위한 명령줄 도구 by Astral를 설치하세요.

• macos and linux
• windows

1
curl -LsSf https://astral.sh/uv/install.sh | sh

1
2
3
4
5
6
7
8
$ curl -LsSf https://astral.sh/uv/install.sh | sh

downloading uv 0.8.9 aarch64-apple-darwin
no checksums to verify
installing to /Users/Isaiah.Robinson/.local/bin
  uv
  uvx
everything's installed!

1
irm https://astral.sh/uv/install.ps1 | iex

1
2
3
4
5
6
7
8
PS C:\Users\YourUser> irm https://astral.sh/uv/install.ps1 | iex

Downloading uv 0.8.9 (x86_64-pc-windows-msvc)
no checksums to verify
installing to C:\Users\YourUser\.local\bin
  uv.exe
  uvx.exe
everything's installed!

2단계: API 키 생성

Braze MCP 서버는 Braze 사용자 프로필에서 데이터를 반환하지 않는 38개의 읽기 전용 엔드포인트를 지원합니다. 설정 > API 및 식별자 > API 키로 이동하여 다음 권한 중 일부 또는 모두를 가진 새 키를 생성하세요.

3단계: 식별자 및 엔드포인트 가져오기

MCP 클라이언트를 구성할 때 API 키의 식별자와 작업 공간의 REST 엔드포인트가 필요합니다. 이 세부정보를 얻으려면 대시보드의 API 키 페이지로 돌아가십시오. 이 페이지를 열어 두어 다음 단계 동안 참조할 수 있습니다.

4단계: MCP 클라이언트 구성

미리 제공된 구성 파일을 사용하여 MCP 클라이언트를 구성하십시오.

• claude
• cursor
• gemini cli

1
2
3
4
5
6
7
8
9
10
11
12
{
  "mcpServers": {
    "braze": {
      "command": "uvx",
      "args": ["--native-tls", "braze-mcp-server@latest"],
      "env": {
        "BRAZE_API_KEY": "your-braze-api-key",
        "BRAZE_BASE_URL": "your-braze-endpoint-url"
      }
    }
  }
}

1
2
3
4
5
6
7
8
9
10
11
12
{
  "mcpServers": {
    "braze": {
      "command": "uvx",
      "args": ["--native-tls", "braze-mcp-server@latest"],
      "env": {
        "BRAZE_API_KEY": "2e8b-3c6c-d12e-bd75-4f0e2a8e5c71",
        "BRAZE_BASE_URL": "https://torchie.braze.com"
      }
    }
  }
}

1
2
mkdir -p ~/.gemini
nano ~/.gemini/settings.json

1
2
3
4
5
6
7
8
9
10
11
12
{
  "mcpServers": {
    "braze": {
      "command": "/Users/yourname/.local/bin/uvx",
      "args": ["--native-tls", "braze-mcp-server@latest"],
      "env": {
        "BRAZE_API_KEY": "2e8b-3c6c-d12e-bd75-4f0e2a8e5c71",
        "BRAZE_BASE_URL": "https://torchie.braze.com"
      }
    }
  }
}

1
2
3
4
gemini
/mcp
/mcp desc
/mcp schema

5단계: 테스트 프롬프트 보내기

Braze MCP 서버를 설정한 후, MCP 클라이언트에 테스트 프롬프트를 보내보십시오. 기타 예제 및 모범 사례는 Braze MCP 서버 사용하기를 참조하십시오.

• claude
• cursor
• gemini cli

문제 해결

터미널 오류

uvx 명령을 찾을 수 없습니다

uvx 명령을 찾을 수 없다는 오류가 발생하면 uv를 재설치하고 터미널을 재시작하십시오.

1
curl -LsSf https://astral.sh/uv/install.sh | sh

spawn uvx ENOENT 오류

spawn uvx ENOENT 오류가 발생하면 클라이언트의 구성 파일에서 파일 경로를 업데이트해야 할 수 있습니다. 먼저, 터미널을 열고 다음 명령을 실행하십시오:

1
which uvx

명령은 다음과 유사한 메시지를 반환해야 합니다:

1
/Users/alex-lee/.local/bin/uvx

메시지를 클립보드에 복사하고 클라이언트의 구성 파일을(를) 엽니다. "command": "uvx"를 복사한 경로로 교체한 후, 클라이언트를 재시작하십시오. For example:

1
"command": "/Users/alex-lee/.local/bin/uvx"

패키지 설치가 실패합니다

패키지 설치가 실패하면 특정 Python 버전을 대신 설치해 보십시오.

1
uvx --python 3.12 braze-mcp-server@latest

클라이언트 구성

MCP 클라이언트가 Braze 서버를 찾을 수 없습니다

1. MCP 클라이언트 구성 구문이 올바른지 확인하십시오.
2. 구성 변경 후 MCP 클라이언트를 다시 시작하십시오.
3. uvx이(가) 시스템 PATH에 있는지 확인하십시오.

인증 오류

1. BRAZE_API_KEY이(가) 올바르고 활성 상태인지 확인하십시오.
2. BRAZE_BASE_URL이(가) Braze 인스턴스와 일치하는지 확인하십시오.
3. API 키에 올바른 권한이 있는지 확인하십시오.

연결 시간 초과 또는 네트워크 오류

1. BRAZE_BASE_URL이(가) 인스턴스에 대해 올바른지 확인하십시오.
2. 네트워크 연결 및 방화벽 설정을 확인하십시오.
3. 기본 URL에서 HTTPS를 사용하고 있는지 확인하십시오.

Disclaimer

모델 컨텍스트 프로토콜 (MCP)은 현재 보안 문제나 취약점에 노출될 수 있는 새로 도입된 오픈 소스 프로토콜입니다.

Braze MCP 서버 설정 코드 및 지침은 Braze에서 “있는 그대로” 제공되며 보증 없이 제공되며, 고객은 이를 자신의 위험 부담 하에 사용합니다. Braze는 부적절한 설정, MCP의 오용 또는 발생할 수 있는 잠재적인 보안 문제로 인해 발생하는 모든 결과에 대해 책임을 지지 않습니다. Braze는 고객이 구성 사항을 신중하게 검토하고 Braze 환경의 무결성과 보안과 관련된 위험을 줄이기 위해 설명된 지침을 따를 것을 강력히 권장합니다.

도움이나 설명이 필요하시면 [email protected]로 문의해 주십시오.