Pushpad MCP

Pushpad MCP 서버로, 웹 푸시 알림을 전송하고 Pushpad의 리소스(알림, 구독, 프로젝트, 발신자에 대한 CRUD 작업)를 Pushpad API를 사용하여 관리합니다.

이 프로젝트는 Pushpad API 위에 구축된 얇은 계층으로, 공식 Pushpad OpenAPI 스펙과 FastMCP for TypeScript를 사용합니다.

보안

MCP 기술을 사용하여 Pushpad 계정과 상호작용하는 것은 위험을 수반할 수 있습니다.

이 MCP 서버는 Pushpad API에 대한 전체 액세스 권한을 제공하며, 여기에는 되돌릴 수 없고 파괴적인 작업(업데이트, 삭제 등)이 포함됩니다. 또한 API는 푸시 구독 키(구독 API) 및 VAPID 키(발신자 API)와 같은 민감한 데이터를 반환할 수 있습니다.

에이전트에서 적절한 권한 모드를 사용하고 제한된 액세스 권한이 있는 Pushpad 토큰을 사용하는 것을 권장합니다.

에이전트 설정에서 권한 모드를 수동으로 변경하거나 이 MCP 서버에서 제공하는 다양한 도구에 대해 허용 / 거부 권한을 설정할 수 있습니다.

발신자에 저장된 VAPID 키를 AI 컨텍스트에서 제외하는 것을 권장합니다. 제한된 액세스 권한이 있는 Pushpad 토큰을 사용하거나 발신자 API에 액세스하는 도구를 거부하면 됩니다.

액세스 토큰을 비공개로 유지하고 Git 저장소에 절대 저장하지 마십시오.

Related MCP server: Dialpad Universal MCP Server

설치

1단계: 환경 변수로 API 토큰 설정

먼저 새 Pushpad 토큰을 생성해야 합니다. Pushpad 대시보드를 열고 계정 이름을 클릭한 다음 액세스 토큰을 클릭하고 새 토큰을 생성하세요.

그런 다음 Pushpad 토큰을 환경 변수로 저장해야 합니다. 전역적으로(~/.bashrc, ~/.zshrc 또는 다른 셸 프로필) 설정하거나, 비밀번호 관리자(1Password CLI 등)를 사용하거나, 프로젝트별 .env 파일에 설정하거나, MCP 클라이언트 설정 파일(.mcp.json 등)에 직접 추가할 수 있습니다. 비밀을 포함할 수 있는 .env, .mcp.json 또는 기타 파일을 .gitignore에 추가하는 것을 잊지 마십시오.

2단계: AI 에이전트에 MCP 서버 추가

로컬 MCP 서버는 MCP JSON 설정 파일에 정의된 설정을 사용하여 MCP 클라이언트에 의해 직접 실행됩니다. 이 파일의 정확한 위치와 적용 방식은 MCP 클라이언트에 따라 다릅니다.

MCP 서비스를 활성화하려면 mcpServers 블록에 항목을 추가하세요:

{
  "mcpServers": {
    "pushpad": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "pushpad-mcp"],
      "env": {
        "PUSHPAD_TOKEN": "${PUSHPAD_TOKEN}"
      }
    }
  }
}

위 예시 구성은 ${PUSHPAD_TOKEN}으로 Pushpad MCP 서버를 설정합니다. 이를 Pushpad 토큰으로 바꾸거나 클라이언트별 변수 대체 방법(사용 가능한 경우)을 사용하여 설정 파일에 토큰을 저장하지 않도록 하세요.

3단계: Pushpad MCP 사용

마지막으로 MCP와 AI 에이전트를 사용하여 Pushpad와 상호작용할 수 있습니다.

예시:

Pushpad를 사용하여 모든 사람에게 XYZ에 대한 알림을 보내줘.

Pushpad를 사용하여 사용자 123에게 알림을 보내줘.

알림 98765가 몇 번의 클릭을 받았어?

프로젝트 456에서 알림의 기본 TTL은 얼마야?

MCP 서버는 알림 API, 구독 API, 프로젝트 API 및 발신자 API를 포함한 전체 Pushpad API를 지원합니다.

개발

이 프로젝트에 기여하고 싶다면 이슈를 열거나 풀 리퀘스트를 제출해 주세요.

이 패키지를 변경하려면 로컬 개발을 위해 이 저장소를 클론하고 개발 컨테이너와 함께 VS Code를 사용하면 더 쉽게 설정할 수 있습니다.

그런 다음 다음 명령어를 사용할 수 있습니다:

• npm run build - TypeScript 프로젝트 컴파일

• npm run start - MCP 서버 시작

• npm run inspect - MCP 서버를 시작하고 @modelcontextprotocol/inspector로 검사

.env 파일에 PUSHPAD_TOKEN을 설정하면 자동으로 읽힙니다.

이 저장소에는 개발 컨테이너에 Claude Code와 이 MCP 서버의 로컬 버전을 시험해 볼 수 있는 .mcp.json도 포함되어 있습니다. 이는 이 패키지를 변경하고 풀 리퀘스트를 제출하기 전에 수정된 버전을 시험해보려는 경우에만 유용합니다.

라이선스

이 MCP 서버는 오픈 소스 라이선스(MIT)로 배포됩니다.