슈어엠 SMS MCP

슈어엠 SMS MCP

Claude에게 말만 하면, 슈어엠으로 문자메시지를 보내주는 MCP 서버입니다.

"발신번호 15884640으로 010-0000-0000에 '오늘 저녁 7시 약속 잊지 마세요' 문자 보내줘"

주요 기능

• 자연어 발송 — Claude에게 대화하듯 말하면 SMS/LMS를 자동으로 발송
• 자동 SMS/LMS 전환 — 메시지 길이(EUC-KR 기준 바이트)에 따라 자동 선택
  • 90바이트 이하 → SMS
  • 91 ~ 2,000바이트 → LMS
• 예약 발송 — 원하는 시각을 지정해 예약 발송 가능 (미지정 시 즉시 발송)
• 메시지 길이 검증 — 2,000바이트 초과 시 발송 전 경고
• 토큰 자동 갱신 — API 인증 토큰을 자동으로 캐싱/갱신 (50분 주기)

시작하기 (4단계)

1단계. 필수 프로그램 설치

설치 후 터미널(PowerShell / Terminal)에서 아래 명령으로 확인:

node --version

2단계. 슈어엠 회원가입 및 SecretKey 발급

1. 슈어비즈(surebiz.co.kr) 접속 후 회원가입
2. 로그인 후 기본정보 → 내정보 진입
3. 페이지 최하단 REST API 인증키 메뉴에서 SecretKey 발급
4. 발급된 슈어엠 아이디(UserCode) 와 SecretKey 를 메모해둡니다

이 두 값이 MCP 설치 시 환경변수로 필요합니다.

3단계. IP 등록 및 발신번호 등록

슈어엠 API는 사전에 등록된 IP와 발신번호에서만 사용할 수 있습니다. 반드시 아래 두 가지를 먼저 등록하세요.

3-1. 내 PC의 IP 등록

1. 네이버 검색창에 내 IP주소 를 입력해 본인의 공인 IP 확인
2. 슈어비즈 → 기본정보 → 고객지원 → IP관리 메뉴에서 해당 IP 등록

IP를 등록하지 않으면 "HTTP 403 실패" 오류가 발생합니다.

3-2. 발신번호 등록

문자 발송 시 사용할 발신번호는 슈어비즈에 사전 등록된 번호만 사용할 수 있습니다.

1. 슈어비즈 → 기본정보 → 발신번호 메뉴에서 사용할 발신번호를 등록
2. 등록 심사가 완료된 번호만 MCP에서 사용 가능

미등록 번호로 발송 시도 시, 발신번호 미등록 에러로 전송되지 않습니다.

4단계. MCP 설치

OS에 맞는 방법을 선택하세요.

🪟 Windows (자동 설치)

PowerShell을 열고 아래 명령을 실행하세요.

iex ((irm https://raw.githubusercontent.com/suremapp/surem-sms-mcp/main/scripts/install-windows.ps1).TrimStart([char]0xFEFF))

스크립트가 실행되면 입력 안내 메시지와 함께 UserCode와 SecretKey를 순서대로 입력받습니다. (값을 미리 준비해두세요)

.TrimStart([char]0xFEFF) 부분은 스크립트 파일의 UTF-8 BOM을 제거하기 위함입니다. BOM은 파일을 로컬 실행할 때 PowerShell 5.1의 한글 파싱 오류를 막아주지만, irm | iex에서는 명령 앞에 붙어 실행을 방해하므로 제거해야 합니다.

.\scripts\install-windows.ps1 -UserCode "슈어엠_아이디" -SecretKey "API_키"

🍎 Mac (자동 설치)

터미널에서 아래 명령을 실행하세요. 실행 후 UserCode와 SecretKey를 입력하라는 안내가 나타납니다.

curl -s https://raw.githubusercontent.com/suremapp/surem-sms-mcp/main/scripts/install-mac.sh | bash

curl -s https://raw.githubusercontent.com/suremapp/surem-sms-mcp/main/scripts/install-mac.sh | bash -s 슈어엠_아이디 API_키

✏️ 수동 설치

Claude Desktop의 claude_desktop_config.json 파일에 직접 추가합니다.

파일 위치:

설정 내용:

{
  "mcpServers": {
    "surem-sms-mcp": {
      "command": "npx",
      "args": ["-y", "surem-sms-mcp"],
      "env": {
        "SUREM_USER_CODE": "슈어엠_아이디",
        "SUREM_SECRET_KEY": "API_키"
      }
    }
  }
}

설치 확인

1. Claude Desktop을 완전히 종료 후 재시작 (시스템 트레이에서 실행 중이라면 트레이 아이콘 → 종료까지 확인)
2. 채팅창 왼쪽 아래 + 버튼 → 커넥터 메뉴에서 surem-sms-mcp가 켜져 있는지 확인

사용 방법

Claude에게 자연어로 말하면 됩니다. 발신번호는 반드시 슈어비즈에 사전 등록된 번호여야 합니다.

예시

"발신번호 15884640으로 010-0000-0000에 '내일 오전 10시 미팅입니다' 문자 보내줘"

"010-0000-0000에 배송 완료 안내 문자 보내줘. 발신번호는 15881234야."

"아래 내용으로 LMS 발송해줘.
 받는 사람: 010-0000-0000
 발신번호: 15884640
 제목: 주문 확인
 내용: 주문하신 상품이 오늘 출고됩니다. 감사합니다."

메시지 길이가 길면 자동으로 LMS로 전환됩니다. 별도 지시가 필요 없습니다.

예약 발송

시각을 지정해서 말하면 예약 발송됩니다.

"내일 오전 9시에 010-0000-0000로 '좋은 아침입니다' 문자 보내줘. 발신번호는 15884640."

"2026년 4월 25일 오후 2시 30분에 010-0000-0000에 세미나 안내 LMS 예약 발송해줘.
 발신번호: 15884640
 제목: 세미나 안내
 내용: 오늘 오후 3시 3층 대회의실에서 세미나가 진행됩니다."

⚠️ 예약 취소는 슈어비즈에서 수동으로 진행해야 합니다.슈어비즈 → 예약,결과 → 예약조회 메뉴에서 예약된 건을 취소할 수 있습니다.

제공 도구 (Tools)

send_message

수신번호, 내용, 발신번호를 받아 SMS 또는 LMS로 발송합니다. 메시지 길이에 따라 타입이 자동 선택됩니다.

발송 결과는 슈어비즈 사이트의 결과조회 메뉴에서도 확인할 수 있습니다.예약 발송 건의 취소는 슈어비즈 사이트의 예약,결과 → 예약조회 메뉴에서만 가능합니다.

자주 묻는 질문

• SecretKey를 올바르게 입력했는지 확인
• 현재 PC의 공인 IP가 슈어비즈에 등록되어 있는지 확인 (VPN/테더링/사무실 이전 시 IP 변경 가능)
• SUREM_USER_CODE가 슈어엠 아이디인지 확인

발송 요청은 성공했지만 실제 수신이 되지 않는 경우, 아래 순서로 확인하세요.

1. 슈어비즈 결과조회 메뉴에서 실패 사유를 먼저 확인합니다.
2. 실패 사유는 아래와 같이 다양할 수 있습니다.
   • 발신번호 미등록 / 승인 대기
   • 수신자의 080 수신거부 등록
   • 이동통신사 스팸 필터링
   • 잘못된 수신번호 형식

메시지는 EUC-KR 기준 최대 2,000바이트까지 발송 가능합니다.한글은 1글자 = 2바이트로 계산되므로 약 1,000자 정도가 한계입니다.

• Claude Desktop을 완전히 종료 후 재시작했는지 확인 (트레이 아이콘까지 종료)
• claude_desktop_config.json 파일의 JSON 문법이 올바른지 확인
• Node.js가 설치되어 있고 node --version 명령이 동작하는지 확인

예약 발송의 취소는 MCP에서 제공하지 않습니다. 슈어비즈 사이트에서 직접 취소해야 합니다.

1. 슈어비즈(surebiz.co.kr) 로그인
2. 예약,결과 → 예약조회 메뉴 진입
3. 취소할 예약 건을 선택해 취소

라이센스

Copyright © 2026 SureM Co., Ltd. All Rights Reserved.

본 소프트웨어는 SureM Co., Ltd.의 독점 소유물입니다.

문의

• 슈어엠 고객센터: 1588-4640
• 이메일: [email protected]
• 홈페이지: surebiz.co.kr