Claude 커넥터는 Claude 웹 앱에 Remote MCP를 연결하는 기능입니다. 노티플라이 커넥터를 추가하면 Claude 대화 안에서 노티플라이 프로젝트, 캠페인, 유저 여정, 유저 상태를 조회하고 초안을 만들 수 있습니다.
https://api.notifly.tech/mcp
Claude 커스텀 커넥터에는 노티플라이 Remote MCP URL만 등록하면 됩니다.
연결하기
- Claude에서 사용자 지정 → 커넥터로 이동합니다.
- 우측 상단의 + 버튼을 누르고 커스텀 커넥터 추가를 선택합니다.
- 다음 값을 입력합니다.
| 입력 필드 | 값 |
|---|
| 이름 | Notifly |
| 원격 MCP 서버 URL | https://api.notifly.tech/mcp |
| OAuth 클라이언트 ID | 비워 둠 |
| OAuth 클라이언트 시크릿 | 비워 둠 |
- 추가를 누릅니다.
- 커넥터 목록에서 Notifly를 선택하고 연결을 누릅니다.
- 노티플라이 로그인 화면이 열리면 노티플라이 계정으로 로그인합니다.
- Claude로 돌아오면 Notifly 상세 화면에 연결 해제 버튼과 도구 권한 목록이 표시됩니다.
OAuth 인증 흐름
Claude는 https://api.notifly.tech/mcp에 연결하면서 노티플라이 OAuth discovery 정보를 확인합니다. Notifly는 동적 클라이언트 등록과 PKCE를 지원하므로 Claude의 커스텀 커넥터 화면에서 OAuth 클라이언트 ID/시크릿을 직접 입력하지 않아도 됩니다.
인증은 보통 이런 흐름입니다.
- Claude가
/mcp에 접근합니다.
- 노티플라이가 Claude에 로그인 필요 상태를 알려줍니다.
- Claude가 브라우저에서 노티플라이 로그인 화면을 엽니다.
- 노티플라이 계정으로 로그인합니다.
- Claude가 연결된 계정 권한으로 도구 목록을 읽고 필요한 도구를 호출합니다.
도구 권한
연결 후 Claude는 Notifly 도구를 읽기 전용 도구와 쓰기/삭제 도구로 나눠 보여줍니다.
| 권한 그룹 | 도구 수 | 도구 예 | 의미 |
|---|
| 읽기 전용 도구 | 23 | 조회·검색 도구 | 프로젝트/캠페인/유저/문서 데이터를 조회합니다. |
| 쓰기/삭제 도구 | 4 | 초안 생성·수정 도구 | 캠페인 초안 또는 비활성 유저 여정 초안을 생성/수정합니다. |
승인 필요 등으로 정합니다. 조직 정책상 민감한 프로젝트를 다룬다면 쓰기 도구는 승인 필요 상태로 두는 편이 안전합니다.
쓰기/삭제 도구라는 Claude UI 표현과 달리 Notifly MCP의 쓰기 도구는 운영 발송이나 삭제를 하지 않습니다. 캠페인은 초안으로만 생성/수정되고, 유저 여정도 비활성 또는 수정 가능한 초안만 다룹니다.
| 범주 | 도구 예 | 설명 |
|---|
| 제품/프로젝트 | list_products 등 | 계정 권한 안에서 제품과 프로젝트를 찾습니다. |
| 캠페인 | 조회·통계 도구 | 캠페인 목록, 상세, 통계, variant 정보를 조회합니다. |
| 캠페인 초안 | create_campaign 등 | 노티플라이 콘솔에서 열 수 있는 캠페인 초안을 생성/수정합니다. |
| 유저 진단 | identify_user 등 | 특정 유저의 채널 상태, 이벤트, 적격성, 발송 기록을 확인합니다. |
| 유저 여정 | 여정 조회 도구 | 유저 여정 목록, 상세, 성과, 유저 세션을 조회합니다. |
| 유저 여정 초안 | 여정 초안 도구 | 비활성 유저 여정 초안을 생성/수정합니다. |
| 문서 | 공식 문서 검색 도구 | 공식 문서를 검색하고 페이지 내용을 읽습니다. |
예시 프롬프트와 응답 형태
이 예시는 실제 계정 데이터가 아니라 응답 형태를 보여주기 위한 예시입니다.
프로젝트와 캠페인 찾기
노티플라이 커넥터로 내가 접근할 수 있는 프로젝트를 찾고,
첫 번째 프로젝트의 최근 캠페인을 보여줘.
접근 가능한 프로젝트를 확인했습니다.
- commerce-prod
- onboarding-demo
commerce-prod의 최근 캠페인:
- 6월 리텐션 알림: active, app_push, scheduled
- 장바구니 리마인드: draft, app_push, event_based
유저 미수신 원인 확인
user@example.com 이 장바구니 리마인드 캠페인을 받지 못한 원인을 확인해 줘.
추정과 실제 조회 결과를 나눠서 설명해 줘.
실제 조회 결과:
1. 유저 식별: `identify_user`로 canonical Notifly user ID를 찾았습니다.
2. 채널 상태: 앱 푸시 채널이 opt-out 상태였습니다.
3. 캠페인 적격성: 세그먼트 조건은 통과했지만 채널 수신 가능 조건에서 제외되었습니다.
4. 발송 기록: 해당 캠페인 delivery record는 없습니다.
결론: 세그먼트 문제가 아니라
앱 푸시 수신 동의/토큰 상태 문제로 보는 편이 맞습니다.
비활성 유저 여정 초안 만들기
회원가입 이벤트 이후 하루 기다렸다가
앱 푸시를 보내는 유저 여정 초안을 만들어 줘.
활성화하지 말고, 생성한 초안의 구조를 설명해 줘.
비활성 유저 여정 초안을 만들었습니다.
- 상태: inactive draft
- entry: 회원가입 이벤트 기반 진입
- nodes:
1. delay node: 1일 대기
2. message node: 앱 푸시 메시지
- 활성화/발송: 하지 않음
노티플라이 콘솔에서 초안을 열어
메시지 문구와 진입 조건을 검토한 뒤 활성화하세요.
연결 해제와 재연결
- 연결을 끊으려면 사용자 지정 → 커넥터 → Notifly → 연결 해제를 누릅니다.
- 계정을 바꾸려면 연결 해제 후 다시 연결합니다.
- 도구가 보이지 않거나 OAuth가 실패하면 커스텀 커넥터를 삭제한 뒤 같은 URL로 다시 추가합니다.
문제 해결
| 증상 | 확인할 점 |
|---|
추가 후 연결 버튼이 보이지 않음 | 이름과 원격 MCP 서버 URL이 정확한지 확인합니다. URL은 https://api.notifly.tech/mcp입니다. |
| OAuth 클라이언트 ID/시크릿을 요구하는 것처럼 보임 | Notifly는 동적 클라이언트 등록을 지원하므로 두 필드는 비워 둡니다. |
| 로그인 후 다시 Claude로 돌아오지 않음 | 브라우저 팝업/리다이렉트 차단 여부를 확인하고 다시 연결을 누릅니다. |
| 도구 호출마다 승인을 요구함 | Claude의 도구 권한 정책 때문입니다. 필요하면 읽기 전용 도구만 허용 수준을 조정하세요. |
| 프로젝트가 조회되지 않음 | 로그인한 노티플라이 계정의 제품/프로젝트 권한을 확인합니다. |
