Telinfy MCP server

Telinfy MCP 통합 가이드

AI 어시스턴트와 Telinfy MCP 서버를 연결하고 사용하는 방법

Telinfy MCP 서버는 Telinfy의 SMS, WhatsApp, RCS 메시징 기능에 대한 프로그래밍 방식의 액세스를 제공하여, AI 어시스턴트가 사용자를 대신해 메시지 전송, 연락처 관리, 캠페인 예약, 보고서 조회를 수행할 수 있게 합니다.

---

MCP란 무엇인가?

Model Context Protocol(MCP)은 AI 애플리케이션이 MCP 호환 데이터 소스 및 도구에 안전하게 연결할 수 있게 하는 개방형 표준입니다. MCP를 AI 애플리케이션을 위한 USB-C 포트라고 생각하면 됩니다. 즉, AI 앱을 다양한 서비스에 연결하는 표준화된 방식입니다.

---

Telinfy MCP 서버

Telinfy MCP 서버는 Telinfy 메시징 플랫폼에 대한 액세스를 제공하는 안전하고 인증된 서비스입니다.

기본 서버 URL: https://mcp.telinfy.com/sse

인증 필요

Telinfy MCP 서버를 사용하려면 다음이 필요합니다:

• Telinfy 사용자 이름
• Telinfy 비밀번호
• API 자격 증명 (로그인 후 자동으로 검색됨)

---

사용 가능한 도구

Telinfy MCP 서버는 포괄적인 메시징 및 캠페인 관리 도구를 제공합니다:

SMS 작업

1. send_sms - DLT 규정을 준수하는 SMS 메시지 전송
2. schedule_sms - 향후 전송을 위한 SMS 캠페인 예약
3. scheduleDynamicCampaign - Excel 파일과 템플릿 변수를 사용한 동적 SMS 캠페인 예약
4. get_sms_schedule - 예약된 모든 SMS 캠페인 조회
5. fetch_sms_campaign_report - SMS 캠페인에 대한 상세 보고서 조회

WhatsApp 작업

6. send_whatsapp_campaign - 사전 생성된 템플릿을 사용하여 WhatsApp 메시지 전송
7. whatsapp_campaign - 모든 WhatsApp 캠페인 목록 조회
8. fetch_whatsapp_smart_report - 날짜 필터링이 포함된 WhatsApp 캠페인 보고서 조회

RCS 작업

9. fetch_rcs_report - 날짜 필터링이 포함된 RCS 메시지 보고서 조회

연락처 관리

10. create_phonebook - 연락처가 포함된 새 전화번호부 그룹 생성
11. get_phonebook_groups - 모든 전화번호부 그룹 목록 조회
12. get_group_contacts - 특정 그룹 내 연락처 조회
13. edit_contact - 연락처 정보 업데이트
14. toggle_contact_status - 그룹 내 연락처 활성화/비활성화
15. delete_contact_group - 전화번호부 그룹 삭제

메시지 보고

16. getMessageReport - 전송된 메시지의 전달 보고서 및 상태 조회

인증

17. login_to_telinfy - Telinfy 플랫폼으로 인증 및 세션 설정

---

와이어 프로토콜

Telinfy MCP 서버는 SSE(Server-Sent Events) 프로토콜을 사용합니다:

SSE(Server-Sent Events) - /sse

• URL: https://mcp.telinfy.com/sse
• 공식 MCP 사양 버전
• Claude, Windsurf, Cursor 및 기타 MCP 클라이언트에서 지원
• 모든 통합에 권장

---

설정 지침

Claude Desktop/Web의 경우:

1. Claude 설정으로 이동
2. "통합" 또는 "연결"로 이동
3. 다음 세부 정보로 새 MCP 서버 추가:
   • 이름: Telinfy
     • 서버 URL: https://mcp.telinfy.com/sse
4. 구성 저장

Claude Code(명령줄)의 경우:

claude mcp add -s user -t http telinfy https://mcp.telinfy.com/sse

Windsurf, Cursor 또는 기타 MCP 클라이언트의 경우:

MCP 설정 파일에 다음 구성을 추가하세요:

{
  "mcpServers": {
    "telinfy": {
      "serverUrl": "https://mcp.telinfy.com/sse"
    }
  }
}

---

Telinfy MCP 사용

초기 설정

MCP 서버 연결 후 Telinfy 자격 증명으로 인증해야 합니다:

Claude, please log me into Telinfy using my username and password.

AI 어시스턴트는 login_to_telinfy 도구를 사용하여 보안 세션을 설정합니다.

사용 사례 예시

SMS 캠페인 전송

Send an SMS to +919876543210 with the message "Your OTP is 123456" 
using sender name "NOTIFY" and template ID "1234567890"

마케팅 캠페인 예약

Schedule an SMS campaign named "Weekend Sale" to be sent tomorrow at 10 AM 
to these numbers: +919876543210, +919876543211 with the message 
"Flash Sale this weekend! 50% off. Visit now."

연락처 그룹 생성

Create a new phonebook group called "VIP Customers" with these contacts:
- John Doe, +919876543210
- Jane Smith, +919876543211

WhatsApp 메시지 전송

Send a WhatsApp campaign using my "order_confirmation" template 
to +919876543210 with customer name "John" and order number "ORD123"

캠페인 보고서 조회

Show me the SMS campaign report for campaign ID "12345"

메시지 전달 상태 확인

Get the delivery status for all messages sent today

---

주요 기능

DLT 규정 준수

모든 SMS 캠페인은 템플릿 ID와 발신자 이름을 통한 DLT(Distributed Ledger Technology) 규정 준수를 지원하여 인도에서의 규제 준수를 보장합니다.

동적 캠페인

변수 치환 기능이 있는 Excel 파일을 사용하여 개인화된 SMS 캠페인을 예약할 수 있으며, 대량 개인화 메시징에 적합합니다.

다중 채널 메시징

• SMS - 프로모션 및 트랜잭션 경로
• WhatsApp - 템플릿 기반 비즈니스 메시징
• RCS - RCS(Rich Communication Services)

포괄적인 보고

메시지 전달, 캠페인 성과를 추적하고 날짜 필터링이 포함된 상세 보고서를 생성합니다.

연락처 관리

연락처를 그룹으로 구성하고, 연락처를 활성화/비활성화하며, 깔끔한 전화번호부 목록을 유지합니다.

---

보안 및 인증

• 모든 API 호출은 Telinfy 자격 증명으로 인증됩니다
• 초기 로그인 후 보안 토큰 기반 인증 사용
• 대화 기간 동안 세션이 유지됩니다
• AI 어시스턴트는 자격 증명을 저장하지 않습니다

---

지원 및 리소스

• Telinfy 대시보드: https://telinfy.com
• API 문서: 상세 API 문서는 Telinfy 지원팀에 문의
• MCP 프로토콜: https://modelcontextprotocol.io
• 지원: Telinfy 계정 관리자에게 문의

---

문제 해결

인증 문제

로그인 문제가 발생하는 경우:

1. 사용자 이름과 비밀번호가 올바른지 확인
2. 계정에 API 액세스가 활성화되어 있는지 확인
3. Telinfy 지원팀에 문의하여 계정에 MCP 액세스 권한이 있는지 확인

연결 문제

MCP 서버가 연결되지 않는 경우:

1. 서버 URL이 정확히 다음과 같은지 확인: https://mcp.telinfy.com/sse
2. 인터넷 연결 확인
3. AI 클라이언트 설정에서 MCP 서버 재연결 시도

메시지 전달 문제

메시지가 전송되지 않는 경우:

1. Telinfy 계정에 충분한 크레딧이 있는지 확인
2. DLT 템플릿 ID가 올바르게 등록되었는지 확인
3. 발신자 이름이 Telinfy 계정에서 승인되었는지 확인
4. 전화번호가 올바른 형식인지 확인

---

모범 사례

1. 항상 먼저 로그인 - 각 세션 시작 시 인증 수행
2. 올바른 템플릿 ID 사용 - DLT 템플릿이 메시지 내용과 일치하는지 확인
3. 전화번호 형식 확인 - 10자리 인도 번호 또는 국가 코드가 포함된 국제 형식 사용
4. 캠페인 보고서 확인 - 전달 상태를 정기적으로 모니터링
5. 연락처를 효율적으로 관리 - 전화번호부 그룹을 체계적으로 유지
6. 대량 전송 전 테스트 - 대규모 캠페인 전에 테스트 메시지 전송

---

예시 워크플로우

캠페인 전송을 위한 전체 워크플로우는 다음과 같습니다:

1. 인증

   Log me into Telinfy with username "myuser" and password "mypass"
   

2. 연락처 그룹 생성

   Create a phonebook group "Spring Sale 2024" with my customer list
   

3. 캠페인 예약

   Schedule an SMS campaign "Spring Sale Announcement" to the "Spring Sale 2024" 
   group for tomorrow at 9 AM with message "Exclusive Spring Sale! 40% off all items. 
   Shop now at example.com" using sender "RETAIL" and template "1234567890"
   

4. 결과 모니터링

   Show me the delivery report for the Spring Sale campaign
   

---

고급 기능

동적 변수 치환

Excel 파일을 사용하여 대규모 개인화 메시지를 전송할 수 있습니다:

• Mobile, Name, OrderID, Amount 열이 포함된 Excel 업로드
• 변수 매핑: {{1}} = Name, {{2}} = OrderID, {{3}} = Amount
• 템플릿: "Hi {{1}}, your order {{2}} of Rs.{{3}} is confirmed"

다중 경로 SMS

• Route 0: 프로모션 메시지
• Route 1: 트랜잭션 메시지(OTP, 알림)

유니코드 지원

유니코드 모드를 활성화하여 지역 언어로 메시지를 전송할 수 있습니다.

---

시작 체크리스트

• Telinfy MCP 서버를 AI 어시스턴트에 연결
• Telinfy 자격 증명으로 인증
• 활성 발신자 이름과 DLT 템플릿이 있는지 확인
• 계정 잔액 및 크레딧 확인
• 대량 캠페인 전에 단일 SMS로 테스트
• 체계적인 전화번호부 그룹 생성
• 최적의 타이밍을 위한 예약 캠페인 설정
• 보고서를 정기적으로 모니터링

---

상세 API 사양 및 매개변수 참조는 Telinfy API 문서를 참조하거나 계정 관리자에게 문의하세요.