노티플라이 Remote MCP는 Claude Code, Codex 같은 MCP 클라이언트가 인터넷으로 호출하는 원격 MCP 엔드포인트입니다. 로컬 서버를 설치하지 않고 아래 URL만 등록합니다.
https://api.notifly.tech/mcp
이 문서는 현재 운영 중인 Remote MCP 기준만 다룹니다. 클라이언트에 URL을 등록한 뒤 노티플라이 계정으로 로그인하면 됩니다.
동작 방식
Remote MCP는 클라이언트와 노티플라이 API를 잇는 표준 연결 지점입니다. 클라이언트는 도구 목록을 읽고, 사용자의 질문에 필요한 도구를 호출합니다. 프로젝트 권한은 로그인한 노티플라이 계정 권한을 그대로 따릅니다.
| 항목 | 설명 |
|---|
| 연결 URL | https://api.notifly.tech/mcp |
| 연결 방식 | Streamable HTTP 기반 Remote MCP |
| 로그인 | 노티플라이 계정으로 OAuth 로그인 |
| 권한 범위 | 로그인한 계정이 접근 가능한 제품/프로젝트 |
| 쓰기 동작 | 캠페인/유저 여정 초안 생성·수정까지만 지원 |
Claude Code에 연결하기
Claude Code에서 원격 HTTP MCP 서버를 추가합니다.
claude mcp add --transport http notifly https://api.notifly.tech/mcp
claude mcp list
claude mcp get notifly
claude mcp list 또는 claude mcp get notifly에서 Needs authentication으로 보일 수 있습니다. Claude Code 세션에서 노티플라이 도구가 필요한 질문을 하거나 MCP 인증을 시작하면 브라우저 OAuth 흐름으로 이어집니다. 브라우저에서 노티플라이 계정으로 로그인하면 Claude Code가 발급된 MCP 토큰으로 /mcp를 호출합니다.
연결이 정상이라면 Claude Code는 먼저 list_products 또는 list_projects 도구로 접근 가능한 제품/프로젝트를 찾습니다.
Claude Code 버전에 따라 .mcp.json을 직접 쓰는 흐름도 있습니다. 이 경우에도 로컬 command가 아니라 원격 url을 사용합니다. .mcp.json에 추가한 서버는 처음에는 Pending approval로 보일 수 있으므로 Claude Code 세션에서 승인한 뒤 사용합니다.
{
"mcpServers": {
"notifly": {
"type": "http",
"url": "https://api.notifly.tech/mcp"
}
}
}
Codex에 연결하기
Codex CLI는 Streamable HTTP MCP 서버를 --url로 추가합니다.
codex mcp add notifly --url https://api.notifly.tech/mcp
codex mcp add 직후 브라우저 인증 URL을 바로 보여줄 수 있습니다. 브라우저에서 노티플라이 계정으로 로그인하면 Codex가 연결 정보를 저장합니다.
codex mcp add가 인증 없이 끝났거나 토큰을 다시 발급해야 한다면 다음 명령으로 OAuth 로그인을 실행합니다.
codex mcp login notifly --scopes mcp:read,mcp:tools
~/.codex/config.toml에 다음 형태로 저장합니다.
[mcp_servers.notifly]
url = "https://api.notifly.tech/mcp"
codex mcp get notifly
codex mcp list
codex mcp list의 Auth 열이 OAuth로 표시됩니다.
노티플라이 MCP 도구는 크게 여섯 가지로 묶을 수 있습니다.
| 범주 | 도구 예 | 하는 일 |
|---|
| 제품/프로젝트 탐색 | list_products 등 | 로그인한 계정이 접근 권한을 가진 제품과 프로젝트를 찾습니다. |
| 프로젝트 카탈로그 | 이벤트·속성·채널 조회 도구 | 이벤트 이름, 유저 속성, 채널 설정을 확인합니다. |
| 캠페인 | 캠페인 조회·통계·초안 도구 | 캠페인 목록/상세/성과를 조회하고, 초안 캠페인을 만들거나 수정합니다. |
| 유저 진단 | identify_user 등 | 특정 유저의 식별자, 채널 상태, 이벤트, 캠페인 적격성, 발송 이력을 점검합니다. |
| 유저 여정 | 여정 조회·초안 도구 | 유저 여정 목록/상세/성과를 조회하고 비활성 초안을 만들거나 수정합니다. |
| 문서 검색 | 공식 문서 검색 도구 | 노티플라이 공식 문서를 검색하고 필요한 페이지 내용을 읽습니다. |
쓰기 도구가 곧바로 운영 발송을 실행하지는 않습니다. create_campaign, replace_campaign은 캠페인 초안만 만들거나 수정합니다. create_user_journey, replace_user_journey도 비활성/수정 가능한 유저 여정 초안만 다룹니다. 활성화, 발송, 삭제는 하지 않습니다.
예시 프롬프트와 응답 형태
이 예시는 실제 계정 데이터가 아니라 응답 형태를 보여주기 위한 예시입니다.
접근 가능한 프로젝트 찾기
내가 접근할 수 있는 노티플라이 제품과 프로젝트를 보여줘.
접근 가능한 제품 1개와 프로젝트 2개를 찾았습니다.
- Product A
- Project: commerce-prod (`project_id: ...`)
- Project: commerce-stage (`project_id: ...`)
다음으로 캠페인, 이벤트 카탈로그,
채널 설정을 이어서 확인하세요.
캠페인 성과 요약
최근 앱 푸시 캠페인 5개의 발송, 클릭, 전환 성과를 요약해 줘.
최근 캠페인 5개를 조회했고,
각 캠페인의 통계 도구를 호출했습니다.
- 6월 리텐션 알림: active, 발송 12,340, 클릭 820, 전환 113
- 장바구니 리마인드: draft, 아직 발송 통계 없음
초안 캠페인은 발송 통계가 없어서 성과 집계에서 제외했습니다.
특정 유저의 미수신 원인 확인
user@example.com 이 어제 캠페인 A를 받지 못한 이유를 확인해 줘.
다음 순서로 확인했습니다.
1. `identify_user`로 이메일을 canonical Notifly user ID로 변환했습니다.
2. `get_campaign_user_eligibility`로 캠페인 적격성 조건을 확인했습니다.
3. `list_campaign_user_deliveries`로 실제 발송 기록을 확인했습니다.
결론: 이 유저는 캠페인 세그먼트 조건에는 포함됐지만,
앱 푸시 채널이 opt-out 상태라 발송 대상에서 제외되었습니다.
초안 캠페인 만들기
회원가입 후 3일이 지난 유저에게 보낼 앱 푸시 초안 캠페인을 만들어 줘. 아직 발송하지 마.
초안 캠페인을 만들었습니다.
- 캠페인 ID: `...`
- 상태: `draft`
- 채널: app push
- 발송 여부: 발송하지 않음
노티플라이 콘솔에서 초안을 열어
문구와 조건을 검토한 뒤 활성화하세요.
문제 해결
| 증상 | 확인할 점 |
|---|
| 로그인 창이 열리지 않음 | 클라이언트가 Remote MCP와 OAuth 로그인을 지원하는 버전인지 확인합니다. |
| 인증 오류가 계속 발생함 | 노티플라이 로그인을 다시 진행하거나 클라이언트의 Notifly 연결을 삭제한 뒤 재연결합니다. |
| 프로젝트가 보이지 않음 | 로그인한 노티플라이 계정이 해당 제품/프로젝트 권한을 갖는지 확인합니다. |
| 쓰기 도구 호출 전 승인 요청이 뜸 | 정상입니다. 캠페인/유저 여정 초안 생성·수정은 클라이언트가 별도 승인을 요구할 수 있습니다. |
