# Notikit > Notikit 은 FCM 위에 사용자 identity 레이어를 얹은 오픈소스(Apache-2.0) 셀프호스트 푸시 알림 툴킷입니다. 기기 토큰이 아니라 사용자 ID 로 보내면 그 사람의 모든 기기로 전달됩니다. 서버 · 관리 콘솔 · 멀티플랫폼 SDK 로 이루어져 있습니다. - 사이트: https://notikit.mint-soft.com/ - 서버 저장소: https://github.com/mintsoft-opensource/notikit - 컨테이너 이미지: ghcr.io/mintsoft-opensource/notikit - 문서 원문 전체: https://notikit.mint-soft.com/llms-full.txt ## 가이드 - [기본 개념](https://notikit.mint-soft.com/docs/concepts.html): Notikit 의 기본 개념 — 프로젝트·디바이스·유저·토픽이 어떻게 연결되고, 토큰이 아니라 유저 기준으로 푸시를 보내는 방식. - [인증](https://notikit.mint-soft.com/docs/auth.html): Notikit 인증 — 공개용 api-key 와 서버 전용 api-secret 의 차이, identity_hash(HMAC)로 계정 도용을 막는 방법. - [빠른 시작](https://notikit.mint-soft.com/docs/quickstart.html): Notikit 빠른 시작 — 디바이스 등록부터 첫 푸시 발송까지. Firebase 없이 log-only 모드로 흐름부터 확인할 수 있습니다. - [발송](https://notikit.mint-soft.com/docs/sending.html): Notikit 발송 API — 개별(single)·다중(multi)·토픽(topic)·전체(broadcast) 발송, 개인화 변수, 예약, 받는 사람 현지 시각 발송, A/B 자동 승자. - [클릭 추적](https://notikit.mint-soft.com/docs/clicks.html): Notikit 클릭 추적 — notikit_log_id 로 알림 클릭을 집계하는 방식. SDK 를 쓰면 자동으로 보고됩니다. - [토큰 수명 관리](https://notikit.mint-soft.com/docs/tokens.html): FCM 토큰 수명 관리 — 토큰 갱신 시 교체(rotate) API 로 중복 발송을 막고, 앱 삭제를 감지하는 방식. - [통계 지표 정의](https://notikit.mint-soft.com/docs/metrics.html): Notikit 통계 지표 정의 — DAU·MAU, 재방문율, 클릭률, 성공/대상 수가 각각 무엇을 세는지. - [운영](https://notikit.mint-soft.com/docs/ops.html): Notikit 운영 가이드 — 운영용 docker-compose.prod.yml, 마이그레이션, 헬스체크, 구조화 로그와 운영 지표, 웹훅 재시도. - [자주 겪는 문제](https://notikit.mint-soft.com/docs/troubleshooting.html): Notikit 자주 겪는 문제 — 알림이 안 오거나 두 번 오는 경우, 클릭 미집계, identity_hash 403 등 증상별 원인과 조치. - [업데이트](https://notikit.mint-soft.com/docs/updates.html): Notikit 업데이트 — 인스턴스를 새 버전으로 올리는 방법과 그때 실제로 일어나는 일. - [MCP 서버](https://notikit.mint-soft.com/docs/mcp.html): Notikit MCP 서버 — Claude Code·Cursor·Claude Desktop 에서 프로젝트 토큰으로 연결해 연동 코드 삽입과 테스트 발송을 AI 에 맡기는 방법. ## SDK - [Web](https://notikit.mint-soft.com/docs/sdk-web.html): Notikit Web SDK — 브라우저 푸시 (FCM / Firebase Cloud Messaging). - [React · Next.js](https://notikit.mint-soft.com/docs/sdk-react.html): Notikit React SDK — Web SDK 위의 hooks (Next.js 호환). - [React Native](https://notikit.mint-soft.com/docs/sdk-react-native.html): Notikit React Native SDK — 디바이스 등록 + identity (@mint-soft/notikit-core 기반). - [JS Core · Node](https://notikit.mint-soft.com/docs/sdk-core.html): Notikit SDK 코어 — 타입 안전 API 클라이언트 (브라우저 / Node / React Native 공용). - [iOS (Swift)](https://notikit.mint-soft.com/docs/sdk-ios.html): Notikit Swift SDK — 유저 중심 푸시 디바이스 등록/식별 (async/await). - [Android (Kotlin)](https://notikit.mint-soft.com/docs/sdk-android.html): Notikit Android SDK — 유저 중심 푸시 디바이스 등록/식별. Kotlin & Java 호환. - [Flutter](https://notikit.mint-soft.com/docs/sdk-flutter.html): Notikit Flutter SDK — 유저 중심 푸시 디바이스 등록/식별. ## 저장소 - [notikit](https://github.com/mintsoft-opensource/notikit): 서버 · 관리 콘솔 · MCP - [notikit-js](https://github.com/mintsoft-opensource/notikit-js): Web · React · React Native · Node SDK (npm) - [notikit-ios](https://github.com/mintsoft-opensource/notikit-ios): iOS SDK (SwiftPM) - [notikit-android](https://github.com/mintsoft-opensource/notikit-android): Android SDK (JitPack) - [notikit-flutter](https://github.com/mintsoft-opensource/notikit-flutter): Flutter SDK (pub.dev)