✨ imsend MCP v1.0

시작하기

imsend MCP를 사용하면 OpenClaw, Claude, ChatGPT 등 AI 에이전트에서
자연어 명령만으로 문자·이메일을 즉시 발송할 수 있습니다.

📌 MCP(Model Context Protocol)란?
AI 에이전트가 외부 서비스를 직접 호출할 수 있게 해주는 표준 프로토콜입니다. imsend MCP를 연동하면 에이전트가 imsend의 발송 기능을 도구(Tool)로 사용할 수 있습니다.

무엇을 할 수 있나요?

💬 문자 발송
SMS, LMS, MMS를 AI에게 말하는 것만으로 즉시 발송
10원~/건
📧 이메일 발송
HTML 이메일 단건·대량 발송 지원
2원/건
📤 대량 발송
수신자 목록을 전달하면 자동으로 대량 발송
건당 동일
💳 포인트 관리
잔액 조회, 발송 이력, 카카오페이 충전
무료

빠른 시작

API 키를 발급받고 에이전트에 연동하는 데 5분이면 충분합니다.

1
imsend 계정으로 API 키 발급
imsend.kr에 로그인 후 왼쪽 메뉴 → AI 에이전트 → MCP API 키에서 발급합니다.
가입 즉시 웰컴 포인트가 지급됩니다.
2
사용할 에이전트에 MCP 서버 등록
아래 연동 가이드를 참고하여 사용하는 AI 도구에 imsend MCP 서버를 등록합니다.
3
자연어로 발송 요청
에이전트에게 "01012345678로 행사 안내 문자 보내줘"라고 말하면 즉시 발송됩니다.

API 키 발급

imsend 계정이 있으면 즉시 발급받을 수 있습니다. 소셜 로그인(카카오/네이버/구글)을 지원합니다.

⚠️ API 키는 외부에 노출되지 않도록 주의하세요. 키가 노출된 경우 즉시 재발급하세요.
  1. imsend.kr에 로그인
  2. 왼쪽 사이드바 → AI 에이전트 섹션 → MCP API 키
  3. MCP API 키 발급받기 버튼 클릭
  4. 발급된 64자리 키를 복사

OpenClaw 연동

OpenClaw는 imsend MCP를 네이티브로 지원합니다. mcporter를 통해 연동합니다.

1. mcporter CLI로 등록

mcporter config add imsend-mcp https://mcp.imsend.kr/mcp --auth bearer
# 프롬프트에서 API 키 입력

2. 설정 파일로 등록

~/.mcporter/mcporter.json에 직접 추가:

{
  "servers": {
    "imsend-mcp": {
      "url": "https://mcp.imsend.kr/mcp",
      "auth": {
        "type": "bearer",
        "token": "여기에_API_키_입력"
      }
    }
  }
}

3. 사용 예시

사용자: "01012345678로 '내일 오전 10시 미팅 안내드립니다' 문자 보내줘"
서진:   ✅ SMS 발송 완료 (잔액: 4,990원)

사용자: "고객 리스트에 있는 50명한테 공지 문자 보내줘"
서진:   ✅ LMS 50건 대량 발송 완료 (차감: 1,500원)

사용자: "잔여 포인트 얼마야?"
서진:   현재 잔액: 3,490원입니다.

Claude Desktop 연동

Claude Desktop의 설정 파일에 MCP 서버를 추가합니다.

설정 파일 경로: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "imsend-mcp": {
      "url": "https://mcp.imsend.kr/mcp",
      "headers": {
        "Authorization": "Bearer 여기에_API_키_입력"
      }
    }
  }
}

설정 파일 경로: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "imsend-mcp": {
      "url": "https://mcp.imsend.kr/mcp",
      "headers": {
        "Authorization": "Bearer 여기에_API_키_입력"
      }
    }
  }
}
✅ 설정 후 Claude Desktop을 재시작하면 imsend MCP 도구가 자동으로 활성화됩니다.

ChatGPT 연동

ChatGPT의 MCP 연동은 Actions 또는 Connectors를 통해 설정합니다.

MCP 서버 URL: https://mcp.imsend.kr/mcp
인증 방식: Bearer Token
토큰: 발급받은 API 키
  1. ChatGPT 설정 → Connectors 또는 Custom Actions
  2. MCP 서버 URL 입력: https://mcp.imsend.kr/mcp
  3. 인증 타입: Bearer Token 선택
  4. API 키 입력 후 저장

Cursor / VS Code 연동

.cursor/mcp.json 또는 .vscode/mcp.json에 추가합니다.

{
  "servers": {
    "imsend-mcp": {
      "type": "http",
      "url": "https://mcp.imsend.kr/mcp",
      "headers": {
        "Authorization": "Bearer 여기에_API_키_입력"
      }
    }
  }
}

도구(Tool) 목록

imsend MCP가 제공하는 도구 목록입니다. AI 에이전트가 자동으로 적절한 도구를 선택하여 호출합니다.

send_sms — 단문 문자 발송

90자 이내의 단문 문자(SMS)를 발송합니다.

{
  "receiver": "01012345678",  // 수신번호
  "message": "안녕하세요, 내일 오전 10시 미팅입니다."  // 최대 90자
}

💰 단가: 10원/건

send_lms — 장문 문자 발송

2,000자 이내의 장문 문자(LMS)를 발송합니다.

{
  "receiver": "01012345678",
  "message": "안녕하세요.\n\n이번 행사 안내를 드립니다.\n..."  // 최대 2000자
}

💰 단가: 30원/건

send_bulk — 대량 문자 발송

여러 수신자에게 동일한 문자를 한 번에 발송합니다.

{
  "receivers": ["01012345678", "01087654321", "01099998888"],
  "message": "공지 내용입니다.",
  "type": "SMS"  // "SMS" 또는 "LMS"
}

💰 단가: 타입에 따라 건당 동일 요금

send_email — 이메일 발송

HTML을 지원하는 이메일을 발송합니다.

{
  "to": "user@example.com",
  "subject": "이메일 제목",
  "content": "
안녕하세요
이메일 내용입니다.
"
}

💰 단가: 2원/건

check_balance — 잔여 포인트 조회

현재 잔여 포인트를 조회합니다.

// 파라미터 없음
// 응답 예시
{
  "balance": 4980,
  "unit": "KRW"
}

💰 무료

get_history — 발송 이력 조회

최근 발송 이력을 조회합니다.

{
  "limit": 20  // 조회 건수 (기본 20)
}

💰 무료

charge_point — 포인트 충전

카카오페이로 포인트를 충전하는 링크를 생성합니다.

{
  "amount": 10000  // 충전 금액 (최소 5,000원)
}

💰 무료 (결제 수수료는 충전 금액에 포함)

요금 안내

선불 포인트 방식으로 운영됩니다. 최소 충전 금액은 5,000원이며, 가입 즉시 웰컴 포인트가 지급됩니다.

발송 유형 단가 제한
SMS (단문)10원/건90자
LMS (장문)30원/건2,000자
MMS100원/건이미지 포함
이메일2원/건HTML 지원

에러 코드

코드 설명 해결 방법
UNAUTHORIZEDAPI 키 인증 실패API 키 확인 및 재발급
INSUFFICIENT_BALANCE포인트 부족charge_point로 충전
INVALID_PHONE수신번호 형식 오류01012345678 형식 사용
BANNED_WORD금칙어 포함스팸성 문구 제거

자주 묻는 질문

발신번호는 어떻게 되나요?

현재는 임팩시스 대표번호(033-911-6510)로 발송됩니다. 추후 hisms API 연동 후 본인 번호 등록 기능이 추가될 예정입니다.

포인트 유효기간이 있나요?

충전일로부터 1년간 유효합니다.

API 키를 잃어버렸어요.

imsend.kr/Home/mcp/apikey에서 재발급받을 수 있습니다. 기존 키는 즉시 무효화됩니다.

대량 발송 한도가 있나요?

분당 60건의 기본 한도가 있습니다. 더 많은 발송이 필요하면 info@imcorp.kr로 문의주세요.

(주)임팩시스 · imsend MCP v1.0 info@imcorp.kr