메인 콘텐츠로 건너뛰기
OneSignal MCP 서버 URL을 추가하여 원격 Model Context Protocol(MCP) 서버를 지원하는 모든 AI 도구나 에이전트에 OneSignal을 연결하세요. 이 페이지에서 Cursor, Claude Code, Codex CLI, VS Code 또는 자체 에이전트를 연결하거나 전체 도구 목록을 확인할 수 있습니다. Claude 또는 ChatGPT 디렉터리에서 OneSignal을 설치하려면 Claude와 ChatGPT에서 OneSignal 사용하기를 참조하세요. MCP는 AI 앱을 외부 시스템에 연결하기 위한 개방형 표준입니다. OneSignal MCP 서버는 사용자 조회나 메시지 전송과 같은 OneSignal 작업을 AI 도구가 호출할 수 있는 도구로 제공합니다.

사전 요구 사항 \

  • 관리하려는 OneSignal 앱에 액세스할 수 있는 OneSignal 계정.
  • OneSignal이 사용하는 브라우저 기반 로그인인 OAuth를 통해 OneSignal 액세스를 승인할 수 있는 권한.
  • OAuth를 사용하는 HTTP 기반 원격 MCP 서버를 지원하는 AI 도구.

연결 세부 정보 \

모든 AI 도구는 동일한 호스팅 엔드포인트에 연결합니다:
브라우저에서 OneSignal에 로그인하고 액세스를 승인하여 인증합니다. 구성할 REST API 키는 없습니다. OAuth 클라이언트 ID와 클라이언트 시크릿 필드는 비워 두세요. OneSignal이 AI 도구를 자동으로 등록하며, 값을 입력하면 연결이 실패합니다.

AI 도구 설정하기 \

Cursor \

Cursor Marketplace에서 OneSignal을 설치합니다.
1

OneSignal 플러그인 열기

Cursor Marketplace의 OneSignal로 이동하거나 Cursor의 마켓플레이스에서 OneSignal을 검색합니다.
2

플러그인 설치

Add to Cursor를 클릭합니다. Cursor가 MCP 서버를 포함한 OneSignal 플러그인을 설치합니다.
3

OneSignal에 로그인

Settings > MCP & Integrations를 열고 OneSignal 옆의 Authenticate를 클릭합니다. 브라우저에서 로그인하고 Agree & Allow Access를 클릭합니다.
4

Agent 채팅에서 OneSignal 사용

새 Agent 채팅을 시작하고 OneSignal 앱 목록 조회와 같은 읽기 전용 확인을 실행하도록 요청합니다.
Cursor를 직접 구성하려면 mcp.json에 OneSignal을 추가합니다:

Claude Code \

1

OneSignal MCP 서버 추가

터미널에서 다음 명령을 실행합니다:
2

Claude Code 내에서 인증

claude를 시작한 다음 /mcp를 입력하여 MCP 패널을 엽니다. onesignal을 선택한 다음 Authenticate를 선택하여 브라우저에서 OneSignal 로그인 페이지를 엽니다.
3

액세스 승인

로그인하고 Agree & Allow Access를 클릭합니다. Claude Code로 돌아갑니다. 서버 상태가 connected로 바뀝니다.
도구 수를 확인하려면 claude mcp list를 실행하거나 Claude Code 내에서 /mcp를 실행하세요.

Claude 사용자 지정 커넥터 \

Claude 디렉터리에서 OneSignal을 설치할 수 없는 경우에만 사용자 지정 커넥터를 사용하세요. 원격 MCP 서버는 로컬 stdio 서버 전용인 claude_desktop_config.json을 통해 추가할 수 없습니다.
1

사용자 지정 커넥터 추가

Customize > Connectors로 이동하여 Add custom connector를 클릭합니다.
2

서버 세부 정보 입력

Name을 OneSignal로, Remote MCP server URL을 https://api.onesignal.com/mcp/oauth로 설정합니다. Advanced settings 아래의 OAuth Client ID와 OAuth Client Secret은 비워 둡니다.
3

OneSignal에 로그인

Add를 클릭한 다음 브라우저에서 OneSignal 로그인을 완료하고 Agree & Allow Access를 클릭합니다.

Codex CLI \

1

플러그인 브라우저 열기

codex를 실행한 다음 /plugins를 입력합니다.
2

OneSignal 설치

OneSignal을 찾아 열고 설치합니다.
3

새 세션 시작 및 로그인

새 세션을 시작합니다. Codex가 인증을 요청하면 브라우저에서 OneSignal에 로그인하고 Agree & Allow Access를 클릭합니다.
Codex IDE 확장 프로그램은 플러그인을 지원하지 않습니다. Codex에서 OneSignal을 사용하려면 Codex CLI 또는 ChatGPT 데스크톱 앱의 Plugins 탭에서 설치하세요.

VS Code의 GitHub Copilot \

팀과 공유하려면 워크스페이스의 .vscode/mcp.json에 OneSignal을 추가하고, 사용자 프로필에 설치하려면 명령 팔레트에서 MCP: Open User Configuration을 실행하세요:
Copilot이 처음으로 OneSignal 도구를 필요로 할 때 VS Code가 인증을 요청하고 OneSignal 로그인 페이지를 엽니다.

기타 AI 도구 및 에이전트 \

AI 도구의 원격 MCP 서버 설정에 https://api.onesignal.com/mcp/oauth를 추가합니다. AI 도구가 처음으로 OneSignal 도구를 호출하면 브라우저에서 OneSignal 로그인 페이지가 열립니다. 로그인하고 Agree & Allow Access를 클릭합니다. 연결에 성공하면 AI 도구에 OneSignal 도구가 표시됩니다.

연결 확인하기 \

새 채팅이나 세션을 시작하고 다음을 보냅니다:
응답에 OneSignal 앱이 나열되면 연결이 정상적으로 작동하는 것입니다. “tool access is not enabled for this application”이 반환되면 문제 해결을 참조하세요. AI 도구가 서버에 연결되는지만 확인하려면 onesignal_health를 호출하세요. 이 도구는 AI 도구 액세스가 활성화되기 전에도 응답하므로, 정상 결과가 다른 도구의 작동을 보장하지는 않습니다.

문제 해결 \

  • 다시 인증하세요. AI 도구의 MCP 또는 커넥터 설정에서 OneSignal을 다시 연결한 다음 새 세션을 시작합니다.
  • 서버 URL을 확인하세요. URL은 정확히 https://api.onesignal.com/mcp/oauth여야 하며 추가 경로나 후행 문자가 없어야 합니다.
  • OAuth 클라이언트 필드를 비우세요. AI 도구에 OAuth 클라이언트 ID 또는 시크릿 필드가 있으면 비워 두세요.
  • AI 도구 액세스를 확인하세요. 도구가 “tool access is not enabled for this application”을 반환하는 경우: OneSignal이 아직 귀하의 OneSignal 로그인에 대해 AI 도구 액세스를 활성화하지 않았습니다. OneSignal 지원팀에 문의하세요.
  • AI 도구를 다시 시작하고 새 세션을 시작하세요. 이렇게 하면 대부분의 일시적인 연결 문제가 해결됩니다.

도구 \

아래 도구를 살펴보세요. 도구 검색은 OneSignal 앱 또는 계정의 MCP 활성화 여부에 따라 달라집니다. 각 작업은 OneSignal 앱 권한도 확인합니다.

앱 (도구 2개) \

Journeys (도구 9개) \

MCP로 Journeys 관리하기

도구 요청을 구성하고, 스키마를 가져오고, Journey 변경 사항을 안전하게 적용하세요.

메시징 (도구 3개) \

Live Activity를 시작하거나 업데이트하려면 아래의 Live Activities를 참조하세요.

사용자 및 구독 (도구 12개) \

템플릿 (도구 4개) \

세그먼트 (도구 4개) \

Live Activities (도구 2개) \

내보내기 (도구 2개) \

사용자 지정 이벤트 (도구 2개) \

이메일 전달성 (도구 4개) \

이메일 워밍업 (도구 5개) \

분석 및 유틸리티 (도구 4개) \

안전 및 보호 장치 \

  • OneSignal은 send_message를 영향도가 높은 도구로 표시하므로, 도구 주석을 따르는 AI 도구는 실행 전에 확인을 요청할 수 있습니다.
  • send_message는 전송 전에 타겟팅을 검증합니다. 요청당 하나의 타겟팅 방법만 사용할 수 있으며 필터 수에는 상한이 있습니다.
  • OneSignal은 식별자, 이메일 주소, 전화번호를 포함한 입력을 실행 전에 검증합니다.
  • Journey 동시성 요구 사항, 수명 주기 제어, 불확실한 쓰기 이후의 복구에 대해서는 Journey 요청 가이드를 참조하세요.
  • OneSignal은 각 OneSignal 로그인별로 AI 도구 액세스를 켜거나 끕니다.
  • MCP 서버는 고객 데이터(구독자, 메시지, 내보내기)를 저장하지 않습니다.

제한 및 사용량 \

OneSignal 연결은 무료입니다. 각 작업은 일반 OneSignal API 사용 한도에 포함됩니다. AI 제공업체의 요금제에는 별도의 비용이 발생할 수 있습니다.
  • 도구 호출에는 도구가 통제 불능 루프에 빠지는 것을 방지하기 위한 속도 제한이 있습니다.
  • 연결은 로그인한 사용자의 권한을 따르며 해당 사용자가 관리할 수 있는 모든 OneSignal 앱에 액세스할 수 있습니다.
  • 유틸리티 도구 이외의 도구가 작동하려면 OneSignal이 귀하의 로그인에 대해 AI 도구 액세스를 활성화해야 할 수 있습니다.

FAQ \

REST API 키가 필요한가요? \

아니요. 모든 연결은 OneSignal OAuth를 사용합니다. 브라우저에서 로그인하고 액세스를 승인하므로 복사, 저장, 교체할 API 키가 없습니다.

여러 OneSignal 앱으로 작업하려면 어떻게 하나요? \

하나의 연결로 OneSignal 계정이 관리할 수 있는 모든 앱을 사용할 수 있습니다. list_apps를 호출하여 앱 ID를 찾으세요. 앱별로 별도의 구성이 필요하지 않습니다.

로컬 stdio 서버만 지원하는 AI 도구를 연결할 수 있나요? \

아니요. OneSignal MCP 서버는 HTTP 기반의 원격 서버입니다. AI 도구가 OAuth를 사용하는 원격 MCP 서버를 지원해야 합니다.

AI 도구의 액세스를 해지하려면 어떻게 하나요? \

OneSignal에서 **Settings > Account settings > Connected apps**로 이동하여 연결을 해지하세요. 연결을 해지해도 팀원의 연결에는 영향을 주지 않습니다.

Claude와 ChatGPT에서 OneSignal 사용하기

Claude 또는 ChatGPT 디렉터리에서 OneSignal을 설치합니다.

MCP로 Journeys 관리하기

MCP 클라이언트에서 초안을 생성하고, Journey 단계를 업데이트하고, Journey 상태를 관리합니다.

REST API 개요

OneSignal MCP 서버가 호출하는 엔드포인트에 대한 참조입니다.

메시지 생성 API

send_message의 기반이 되는 엔드포인트 참조입니다.

AI 데이터 관행

OneSignal이 AI 기능과 연결된 AI 도구의 데이터를 처리하는 방법입니다.