노티플라이 Remote MCP 서버

노티플라이 Remote MCP는 Claude Code, Codex 같은 MCP 클라이언트가 인터넷으로 호출하는 원격 MCP 엔드포인트입니다. 로컬 서버를 설치하지 않고 아래 URL만 등록합니다.

https://api.notifly.tech/mcp

이 문서는 현재 운영 중인 Remote MCP 기준만 다룹니다. 클라이언트에 URL을 등록한 뒤 노티플라이 계정으로 로그인하면 됩니다.

노티플라이의 AI 도구는 세 가지입니다. 콘솔 안에서 쓰는 AI 어시스턴트 (Pro 플랜 이상), ChatGPT와 Claude 등 외부 AI 클라이언트를 연결하는 Remote MCP, AI 코딩 에이전트의 SDK 연동을 돕는 Agent Skills. 이 중 AI 어시스턴트와 Remote MCP는 조회와 초안 작업까지만 지원하며 운영 발송, 캠페인 활성화, 삭제는 수행하지 않습니다. Agent Skills는 프로젝트 코드에 SDK 연동을 적용하는 개발 도구이므로 생성된 코드와 설정을 직접 검토하세요.

동작 방식

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 CLI는 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는 요청 안에서만 유효한 노드 ref를 사용해 비활성 유저 여정 초안만 생성하며, 실제 노드 ID는 서버가 생성합니다. 유저 여정 수정·활성화·발송·삭제는 하지 않습니다.

예시 프롬프트와 응답 형태

이 예시는 실제 계정 데이터가 아니라 응답 형태를 보여주기 위한 예시입니다.

접근 가능한 프로젝트 찾기

내가 접근할 수 있는 노티플라이 제품과 프로젝트를 보여줘.

접근 가능한 제품 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 연결을 삭제한 뒤 재연결합니다.
프로젝트가 보이지 않음	로그인한 노티플라이 계정이 해당 제품/프로젝트 권한을 갖는지 확인합니다.
쓰기 도구 호출 전 승인 요청이 뜸	정상입니다. 캠페인/유저 여정 초안 생성·수정은 클라이언트가 별도 승인을 요구할 수 있습니다.

시작하기

개발자 가이드

개발자 도구

노티플라이 Remote MCP 서버

동작 방식

Claude Code에 연결하기

Codex에 연결하기

기능

예시 프롬프트와 응답 형태

접근 가능한 프로젝트 찾기

캠페인 성과 요약

특정 유저의 미수신 원인 확인

초안 캠페인 만들기

문제 해결

​동작 방식

​Claude Code에 연결하기

​Codex에 연결하기

​기능

​예시 프롬프트와 응답 형태

​접근 가능한 프로젝트 찾기

​캠페인 성과 요약

​특정 유저의 미수신 원인 확인

​초안 캠페인 만들기

​문제 해결

동작 방식

Claude Code에 연결하기

Codex에 연결하기

기능

예시 프롬프트와 응답 형태

접근 가능한 프로젝트 찾기

캠페인 성과 요약

특정 유저의 미수신 원인 확인

초안 캠페인 만들기

문제 해결