슈어엠 SMS MCP

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

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

---

주요 기능

• 자연어 발송 — Claude에게 대화하듯 말하면 SMS/LMS를 자동 발송
• 자동 SMS/LMS 전환 — 메시지 길이(EUC-KR 기준 바이트)에 따라 자동 선택
  • 90바이트 이하 → SMS
  • 91 ~ 2,000바이트 → LMS
• 국제 SMS — 한국 외 국가로 발송 (최대 500자, ASCII/Unicode 자동 감지, 길이 초과 시 자동 concat)
• TTS 음성 통화 — 텍스트를 음성으로 변환해 수신자 휴대폰으로 통화 발송 (최대 90자)
• MMS 이미지 첨부 — 로컬(stdio) 환경에서 jpg 이미지 1~3장 첨부 발송
• 예약 발송 — 원하는 시각 지정 (미지정 시 즉시 발송)
• 메시지 길이 검증 — 발송 전 사전 거절로 API 낭비 방지
• 토큰 자동 갱신 — API 인증 토큰을 자동 캐싱/갱신

---

연결 방법 선택

두 가지 방법을 지원합니다. 대부분의 사용자는 원격 연결을 권장합니다.

방법	적합 대상	설치	Claude 플랜
🌐 원격 연결 (권장)	일반 업무 사용자	❌ 없음	Pro 이상 권장 (Free는 Custom Connector 1개 제한)
💻 로컬 stdio 설치	무료 플랜 / 개발자	Node.js + config 편집	전체 플랜

---

🌐 원격 연결 (권장)

사내 SureM MCP 서버에 OAuth 2.1로 로그인만 하면 바로 사용. 개별 PC에 Node.js 설치나 설정 파일 편집이 필요 없습니다.

사전 준비

1. 슈어비즈 계정 — surebiz.co.kr 회원가입
2. SecretKey 발급 — 로그인 후 기본정보 → 내정보 → 최하단 'REST API 인증키' 메뉴에서 발급
3. 발신번호 등록 — 기본정보 → 발신번호 에서 사용할 발신번호 등록
4. MCP 커넥터 URL — https://mcp.surem.com/mcp

ℹ️ 원격 연결 방식에서는 개인 PC의 IP 등록이 불필요합니다. 서버의 고정 IP가 슈어엠 API에 이미 등록되어 있습니다.

연결 절차

1. Claude Desktop 실행 → 설정 → 커넥터 관리 → + Custom connector 추가
2. 이름은 자유롭게 설정(예: surem-sms-mcp), URL 입력란에는 https://mcp.surem.com/mcp 입력 후 추가
3. 연결 버튼을 누르면 자동으로 열리는 브라우저 창에 UserCode(슈어엠 아이디) 와 SecretKey 입력 후 로그인
4. Claude Desktop으로 자동 복귀 → 커넥터 목록에 surem-sms-mcp 활성화 확인

📹 설정 가이드 (애니메이션)

✅ 연결 완료 화면

이제 사용 방법 으로 이동하세요.

---

💻 로컬 stdio 설치 (레거시)

💡 이 경로는 Claude 무료 플랜 사용자나 로컬 개발/테스트 환경에서 사용합니다. 원격 연결이 가능하면 그쪽을 권장합니다.

설치 4단계 펼치기

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

프로그램	설명
Claude Desktop	클라이언트
Node.js	v16 이상

확인:

node --version

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

surebiz.co.kr 회원가입 → 로그인 → 기본정보 → 내정보 → REST API 인증키 → SecretKey 발급. UserCode와 SecretKey 메모.

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

로컬 설치는 본인 PC의 IP 가 슈어엠 API에 등록되어 있어야 합니다.

3-1. 내 PC의 IP 등록

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

IP 미등록 시 "HTTP 403" 오류 발생

3-2. 발신번호 등록

슈어비즈 → 기본정보 → 발신번호 에서 사용할 발신번호 등록 (심사 완료 후 사용 가능).

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 은 PS 5.1 의 한글 파싱용으로 필요하지만 irm | iex 에서는 방해됩니다.

저장소를 로컬에 clone 한 경우엔 인자로 직접 전달도 가능:

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

🍎 Mac (터미널)

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_키

✏️ config 직접 설정

Claude Desktop 의 claude_desktop_config.json 에 직접 추가:

OS	경로
Windows (Microsoft Store)	%LOCALAPPDATA%\Packages\Claude_pzs8sxrjxfjjc\LocalCache\Roaming\Claude\claude_desktop_config.json
Windows (일반 설치)	%APPDATA%\Claude\claude_desktop_config.json
Mac	~/Library/Application Support/Claude/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층 대회의실에서 세미나가 진행됩니다."

⚠️ 예약 취소는 슈어비즈 사이트에서 수동으로: 슈어비즈 → 예약,결과 → 예약조회 메뉴에서 취소

국제 메시지

한국 외 국가로 SMS 보낼 때:

"일본 9012345678 한테 'Hello from Korea' 보내줘. 발신번호는 15884640."

"국가코드 86 132xxxxxxxx 에 짧은 안내 보내줘. 발신: 15884640"

ℹ️ 자동 처리: ASCII 만이면 160 byte / SMS 기준, 유니코드 포함 시 70자 / SMS 기준이고 초과 분량은 서버에서 자동으로 concat(다중 SMS) 처리. 중국(86)은 머리말 특수문자 정책으로 항상 유니코드 모드로 계산됩니다.

ℹ️ 발신번호: 국제 발송은 슈어비즈 사전 등록 강제 없음 — 국내 send_message 와 다른 점.

⚠️ 한국(82)은 일반 [send_message] 로 보내야 합니다 (국제 도구는 한국 거절).

TTS 음성 통화

텍스트를 음성으로 변환해 전화 통화를 거는 기능:

"010-1234-5678 한테 '안녕하세요. 배송이 도착했습니다.' 음성으로 안내해줘. 발신번호 15884640."

"TTS 로 010-0000-0000 에 전화 걸어서 '오늘 오후 3시 회의 시작합니다' 안내."

🔊 수신자 휴대폰으로 전화가 걸리며 입력한 텍스트가 음성 안내로 재생됩니다. 최대 90자.

MMS (이미지 첨부) — stdio 모드 전용

"F:/photos/menu.jpg 이미지로 010-1234-5678 에 '오늘의 메뉴입니다' MMS 보내줘. 발신번호 15884640."

⚠️ 원격 OAuth 모드에서는 이미지 도구가 비활성화되어 있습니다 (Claude Desktop 의 이미지 transcoding 으로 깨진 이미지가 발송될 수 있어). 이미지 첨부 발송은 로컬 stdio 설치 환경에서만 사용 가능합니다.

---

제공 도구 (Tools)

도구	용도	모드
send_message	국내 SMS / LMS / MMS 발송 + 예약	모두
send_international_message	한국 외 국가로 SMS 발송	모두
send_tts	텍스트→음성 변환 후 전화 통화 발송	모두
upload_mms_image	MMS 첨부용 이미지 업로드 (jpg)	stdio 전용

send_message

수신번호·내용·발신번호를 받아 국내 SMS / LMS / MMS 발송. 메시지 길이로 타입 자동 선택. imageKey 첨부 시 MMS.

파라미터	필수	설명
to	✅	수신자 전화번호 (예: 01012345678)
text	✅	발송할 메시지 내용
reqPhone	✅	발신번호 (슈어비즈에 사전 등록된 번호, 예: 15884640)
subject	⬜	LMS/MMS 제목 — 90바이트 초과 또는 이미지 첨부 시 사용 (기본값: 메시지)
reservedTime	⬜	예약 발송 시각 — yyyyMMddhhmmss 14자리 (예: 20260420150000). 미입력 시 즉시 발송
imageKey	⬜	MMS 첨부 이미지 키 (upload_mms_image 결과). stdio 모드에서만 노출

발송 결과는 슈어비즈 결과조회 메뉴에서 확인. 예약 취소는 예약,결과 → 예약조회 에서.

send_international_message

한국이 아닌 국가로 국제 SMS 발송. 한국(82) 은 send_message 사용.

파라미터	필수	설명
country	✅	국가 코드 — 숫자만 (예: 81 일본, 86 중국, 1 미국, 44 영국). +/00/- 제외
to	✅	수신자 전화번호 — 국가코드 제외 (예: 일본 9012345678)
text	✅	메시지 내용 (최대 500자)
reqPhone	✅	발신번호 — 슈어비즈 사전 등록 강제 없음 (국내 send_message 와 다른 점)

길이 처리: ASCII 160 byte / 유니코드 70자 기준 SMS, 초과 시 서버에서 자동 concat. 중국(86)은 항상 유니코드 모드.

send_tts

텍스트를 음성으로 변환해 수신자 휴대폰으로 통화 발송.

파라미터	필수	설명
to	✅	수신자 전화번호 (예: 01012345678)
text	✅	음성으로 변환할 메시지 (최대 90자)
reqPhone	✅	발신번호 (슈어비즈에 사전 등록된 번호)

upload_mms_image (stdio 모드 전용)

서버 프로세스가 접근 가능한 로컬 jpg 파일을 슈어엠에 업로드하고 단일 imageKey 를 반환. 받은 키를 send_message 의 imageKey 에 전달해 MMS 발송.

파라미터	필수	설명
images[].path	✅	jpg 파일 경로 (1~3개)
images[].filename	⬜	파일명 override

이미지 규격: 확장자 jpg / 한 장 500KB 이하 / 가로·세로 1000px 이하 / 합산 1MB 미만.

⚠️ 원격 OAuth 모드에서는 이 도구와 send_message.imageKey 가 활성화되어 있지 않습니다. Claude Desktop 의 이미지 첨부 transcoding 으로 깨진 jpg 가 발송될 수 있어 안전상 비활성화. 이미지 첨부 발송이 필요하면 stdio 환경에서 사용하세요.

---

자주 묻는 질문

원격 연결 / 로컬 설치 중 뭘 써야 하나요?

• 일반 업무 사용자(영업/마케팅 등): 원격 연결. 설치·설정 필요 없음.
• Claude 무료 플랜이라 Custom Connector 를 쓸 수 없거나 이미 다른 커넥터를 쓰고 있는 경우: 로컬 stdio.

SureM 에서 SecretKey 를 재발급 받았어요 — 어떻게 갱신하나요?

관리자 개입 없이 사용자가 직접 갱신 가능합니다:

1. 브라우저에서 https://mcp.surem.com/account 접속
2. UserCode 와 새 SecretKey 입력 후 제출
3. 서버가 슈어엠 API 로 검증 통과 → DB 에 즉시 반영
4. Claude Desktop 그대로 사용하면 다음 문자 발송부터 새 SecretKey 로 자동 전송됩니다 (재로그인 불필요)

UserCode 가 처음 쓰는 경우라도 이 페이지로 등록 가능합니다. 이후 Claude Desktop OAuth 로그인 폼도 스킵되고 바로 사용 가능.

"인증 실패" / "403" 오류가 발생해요

원격 연결

• 브라우저에 재로그인 (쿠키 만료 가능)
• UserCode·SecretKey 가 현재 유효한지 슈어비즈 로그인으로 확인

로컬 설치

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

"요청 성공인데 문자가 오지 않아요"

발송 요청은 성공했지만 실제 수신이 되지 않는 경우:

1. 슈어비즈 결과조회 메뉴에서 실패 사유 확인
2. 실패 사유 후보:
   • 발신번호 미등록 / 승인 대기
   • 수신자의 080 수신거부 등록
   • 이동통신사 스팸 필터링
   • 잘못된 수신번호 형식

"메시지가 너무 깁니다" 오류가 발생해요

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

Claude Desktop 커넥터 목록에 나타나지 않아요

공통

• Claude Desktop 완전 종료 후 재시작 (트레이 아이콘까지)

원격 연결

• URL 을 HTTPS 로 정확히 입력했는지
• 관리자에게 MCP 서버 상태 확인 요청

로컬 설치

• claude_desktop_config.json 의 JSON 문법이 올바른지
• Node.js 설치 및 node --version 동작 확인
• npm cache clean --force 후 재시작

예약 발송을 취소하고 싶어요

MCP 에서는 예약 취소를 제공하지 않습니다. 슈어비즈에서 직접 취소:

1. 슈어비즈 로그인
2. 예약,결과 → 예약조회 진입
3. 건 선택 후 취소

(로컬 설치) 업데이트했는데 이전 버전처럼 동작해요

Claude Desktop 이 MCP 서버의 캐시된 버전을 재사용합니다:

1. (가장 간단) 채팅창 + 버튼 → 커넥터 에서 surem-sms-mcp 토글 off → on
2. Claude Desktop 완전 종료 후 재시작
3. npm 캐시 정리:

npm cache clean --force
Remove-Item -Recurse -Force "$env:LOCALAPPDATA\npm-cache\_npx" -ErrorAction SilentlyContinue

---

라이센스

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

본 소프트웨어는 SureM Co., Ltd.의 독점 소유물입니다. 자세한 이용 조건은 LICENSE 파일을 참고하세요.

---

문의

• 슈어엠 고객센터: 1588-4640
• 이메일: suremapp@surem.com
• 홈페이지: surebiz.co.kr