ClickSend MCP Server

이것은 ClickSend 팀이 개발한 공식 ClickSend MCP Server입니다. 보안상의 이유로 ClickSend MCP의 비공식 버전을 사용하지 마십시오.

목적

ClickSend MCP는 ClickSend의 메시징 기능을 현대 AI 생태계와 플랫폼으로 확장하도록 설계되었습니다 - 개발자가 직접 코드를 작성하지 않고도 ClickSend를 통해 SMS를 쉽게 보낼 수 있게 해줍니다.

이를 통해 채택이 가속화되고, 새로운 AI 기반 사용 사례가 가능해지며, 지능형 자동화 시대에 ClickSend가 미래를 준비하는 메시징 플랫폼으로 자리매김할 수 있습니다.

Related MCP server: Twilio MCP Server

요구 사항

• Node.js >= 18

  • 이 앱을 실행할 올바른 버전을 설정하려면 nvm(Node Version Manager)을 사용할 수 있습니다.

설치

AI 데스크톱 클라이언트를 다운로드하십시오. Claude Desktop이 한 예이며, **여기**에서 다운로드할 수 있습니다.

구성

이 서버에는 두 개의 환경 변수가 필요합니다:

• CLICKSEND_USERNAME: 귀하의 ClickSend 사용자 이름

• CLICKSEND_API_KEY: 귀하의 ClickSend API 키

ClickSend에 가입 후 https://dashboard.clicksend.com/account/subaccounts에서 사용자 이름과 키를 확인할 수 있습니다.

Claude Desktop 구성

• Claude Desktop을 엽니다

• 시스템 메뉴에서 Settings로 이동합니다

• 설정 창에서 Developer 탭으로 이동하여 Edit Config를 클릭합니다. 이렇게 하면 구성 파일이 열립니다:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

  • Windows: %APPDATA%\Claude\claude_desktop_config.json

• NPM 패키지 사용

{
  "mcpServers": {
    "clicksend": {
      "command": "npx",
      "args": [
        "-y",
        "@clicksend/clicksend-mcp-server@latest"
      ],
      "env": { 
        "CLICKSEND_USERNAME": "<username>",
         "CLICKSEND_API_KEY": "<api-key>"
      }
    }
  }
}

• 로컬 빌드 사용

{
  "mcpServers": {
    "clicksend": {
      "command": "node",
      "args": [
        "/path/to/repository/build/clicksend-mcp.js"
      ],
      "env": {
        "CLICKSEND_USERNAME": "your clicksend username",
        "CLICKSEND_API_KEY": "your API Key"
      }
    }
  }
}

그런 다음 Claude Desktop을 다시 시작하여 구성을 다시 로드합니다. 연결된 경우, hammer 아이콘을 클릭하면 clicksend-send-sms가 표시됩니다.

Claude와의 상호작용 예시

Claude를 통해 이 서버와 자연스럽게 상호 작용할 수 있는 몇 가지 방법은 다음과 같습니다:

간단한 SMS:

Send a text message to the number 61411111111 saying "I'm using ClickSend MCP server to sent SMS!"

기능

• ClickSend 사용자 이름과 API 키를 설정하여 한 번에 하나의 SMS를 전송합니다

• 연락처 목록에 메시지를 보낼 때 요금을 확인합니다

• 연락처 또는 연락처 목록을 검색하고 해당 연락처에 메시지를 보냅니다

• SMS 템플릿을 가져와 이를 사용하여 메시지를 보냅니다

• SMS 내역을 보기/검색합니다

• 지난 30일간의 SMS 통계를 확인합니다

지원되는 API

1. POST /v3/sms/send

• Operation ID: send-sms

• 요약: SMS 보내기

• 설명: 전화번호 또는 연락처 목록에 있는 연락처를 대상으로 수신자에게 메시지를 전송합니다.

2. POST /v3/sms/price

• Operation ID: calculate-sms-price

• 요약: SMS 요용 계산

• 설명: 메시지 유형과 길이에 따라 전송 요용을 계산합니다.

3. GET /v3/sms/templates

• Operation ID: view-sms-templates

• 요약: SMS 템플릿 보기

• 설명: 필섎터링 옵션을 포함하여 SMS 템플릿을 조회합니다.

4. GET /v3/sms/history

• Operation ID: view-sms-history

• 요약: SMS 내역 보기

• 설명: 필터링 및 페이징 옵션과 함께 이전에 전송한 SMS를 확인합니다.

5. GET /v3/statistics/sms

• Operation ID: view-sms-statistics

• 요약: SMS 통계 보기

• 설명: 지난 30일간의 SMS 통계를 가져옵니다.

6. GET /v3/search/contacts-lists

• Operation ID: view-contact-lists

• 요약: 연락처 목록 보기

• 설명: 검색된 연락처 목록을 조회합니다.

중요 참고 사항

1. 전화번호 형식: 모든 번호는 E.164 형식이어야 합니다 (예: +61411111111)

2. 속도 제한: ClickSend 계정의 속도 제한과 가격 조건을 잘 인지하십시오

3. 보안: ClickSend 자격 증명을 안전하게 유지하며 버전 관리 시스템에 커밋하지 마십시오

문제 해결

일반적인 오류 메시지와 해결 방법:

1. "Phone number must be in E.164 format"

   • 전화번호가 "+"와 국가 코드로 시작하는지 확인하십시오

2. "Invalid credentials"

   • CLICKSEND\_USERNAME과 CLICKSEND\_API\_KEY를 다시 확인하십시오. ClickSend 대시보드에서 복사할 수 있습니다

기여

기여는 환영합니다! 풀 리퀘스트를 제출하기 전에 당사의 기여 규칙을 읽어 주십시오.

라이선스

이 프로젝트는 MIT License의 적용을 받습니다 - 자세한 내용은 LICENSE 파일을 참조하십시오.

보안

전화번호나 ClickSend 자격 증명과 같은 민감한 정보를 GitHub 이슈나 풀 리퀘스트에 포함하지 마십시오.