Telinfy MCP server

официальный

Отправляйте SMS, WhatsApp и RCS-сообщения программно с соблюдением DLT. Управляйте контактами, планируйте кампании и отслеживайте отчеты о доставке.

GitHub

Документация

Руководство по интеграции Telinfy MCP

Как подключить и использовать сервер Telinfy MCP с AI-ассистентами

Сервер Telinfy MCP предоставляет программный доступ к возможностям SMS, WhatsApp и RCS-рассылок Telinfy, позволяя AI-ассистентам отправлять сообщения, управлять контактами, планировать кампании и получать отчёты от вашего имени.

Что такое MCP?

Model Context Protocol (MCP) — это открытый стандарт, который позволяет AI-приложениям безопасно подключаться к MCP-совместимым источникам данных и инструментам. Представьте MCP как порт USB-C для AI-приложений — стандартизированный способ подключения AI-приложений к различным сервисам.

Сервер Telinfy MCP

Сервер Telinfy MCP — это безопасный, аутентифицированный сервис, предоставляющий доступ к вашей платформе обмена сообщениями Telinfy.

Базовый URL-адрес сервера: https://mcp.telinfy.com/sse

Требуется аутентификация

Для использования сервера Telinfy MCP вам потребуется:

  • Имя пользователя Telinfy
  • Пароль Telinfy
  • Учётные данные API (автоматически извлекаются после входа в систему)

Доступные инструменты

Сервер Telinfy MCP предлагает комплексные инструменты для обмена сообщениями и управления кампаниями:

Операции с SMS

  1. send_sms - Отправка SMS-сообщений с соблюдением DLT
  2. schedule_sms - Планирование SMS-кампаний для будущей доставки
  3. scheduleDynamicCampaign - Планирование динамических SMS-кампаний с использованием файлов Excel и переменных шаблона
  4. get_sms_schedule - Просмотр всех запланированных SMS-кампаний
  5. fetch_sms_campaign_report - Получение подробных отчётов по SMS-кампаниям

Операции с WhatsApp

  1. send_whatsapp_campaign - Отправка сообщений WhatsApp с использованием предварительно созданных шаблонов
  2. whatsapp_campaign - Список всех кампаний WhatsApp
  3. fetch_whatsapp_smart_report - Получение отчётов по кампаниям WhatsApp с фильтрацией по дате

Операции с RCS

  1. fetch_rcs_report - Получение отчётов по сообщениям RCS с фильтрацией по дате

Управление контактами

  1. create_phonebook - Создание новых групп в телефонной книге с контактами
  2. get_phonebook_groups - Список всех групп телефонной книги
  3. get_group_contacts - Просмотр контактов в определённой группе
  4. edit_contact - Обновление информации о контакте
  5. toggle_contact_status - Включение/отключение контактов в группе
  6. delete_contact_group - Удаление групп телефонной книги

Отчётность по сообщениям

  1. getMessageReport - Получение отчётов о доставке сообщений и статуса отправленных сообщений

Аутентификация

  1. 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-кампании поддерживают соответствие DLT (Distributed Ledger Technology) с идентификаторами шаблонов и именами отправителей, обеспечивая соблюдение нормативных требований в Индии.

Динамические кампании

Планируйте персонализированные SMS-кампании с использованием файлов Excel и подстановкой переменных, что идеально подходит для массовой персонализированной рассылки.

Многоканальный обмен сообщениями

  • SMS - Рекламные и транзакционные маршруты
  • WhatsApp - Деловые сообщения на основе шаблонов
  • RCS - Rich Communication Services

Комплексная отчётность

Отслеживайте доставку сообщений, эффективность кампаний и создавайте подробные отчёты с фильтрацией по дате.

Организуйте контакты по группам, включайте/отключайте контакты и поддерживайте аккуратные списки телефонной книги.

Безопасность и аутентификация

  • Все вызовы API аутентифицируются с использованием ваших учётных данных Telinfy
  • Безопасная аутентификация на основе токенов после первоначального входа в систему
  • Сеансы сохраняются на протяжении всего вашего разговора
  • AI-ассистент не хранит учётные данные

Поддержка и ресурсы

  • Панель управления Telinfy: https://telinfy.com
  • Документация по API: Свяжитесь со службой поддержки Telinfy для получения подробной документации по API
  • Протокол MCP: https://modelcontextprotocol.io
  • Поддержка: Свяжитесь с вашим менеджером по работе с клиентами Telinfy

Устранение неполадок

Проблемы с аутентификацией

Если у вас возникли проблемы со входом в систему:

  1. Убедитесь, что ваше имя пользователя и пароль верны
  2. Проверьте, включён ли в вашей учётной записи доступ к API
  3. Свяжитесь со службой поддержки Telinfy, чтобы убедиться, что у вашей учётной записи есть доступ к MCP

Проблемы с подключением

Если сервер MCP не подключается:

  1. Убедитесь, что URL-адрес сервера точно: https://mcp.telinfy.com/sse
  2. Проверьте подключение к интернету
  3. Попробуйте переподключить сервер MCP в настройках вашего AI-клиента

Проблемы с доставкой сообщений

Если сообщения не отправляются:

  1. Убедитесь, что на вашем счёте Telinfy достаточно кредитов
  2. Убедитесь, что идентификаторы шаблонов DLT зарегистрированы правильно
  3. Проверьте, что имена отправителей одобрены в вашей учётной записи Telinfy
  4. Убедитесь, что номера телефонов указаны в правильном формате

Рекомендации

  1. Всегда сначала входите в систему - Аутентифицируйтесь в начале каждого сеанса
  2. Используйте правильные идентификаторы шаблонов - Убедитесь, что шаблоны DLT соответствуют содержанию вашего сообщения
  3. Проверяйте форматы телефонов - Используйте 10-значные индийские номера или международный формат с кодом страны
  4. Проверяйте отчёты по кампаниям - Регулярно отслеживайте статус доставки
  5. Эффективно управляйте контактами - Поддерживайте порядок в группах телефонной книги
  6. Тестируйте перед массовой рассылкой - Отправляйте тестовые сообщения перед крупными кампаниями

Пример рабочего процесса

Вот полный рабочий процесс для отправки кампании:

  1. Аутентификация
Log me into Telinfy with username "myuser" and password "mypass"
  1. Создание группы контактов
Create a phonebook group "Spring Sale 2024" with my customer list
  1. Планирование кампании
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"
  1. Мониторинг результатов
Show me the delivery report for the Spring Sale campaign

Расширенные возможности

Динамическая подстановка переменных

Используйте файлы Excel для массовой отправки персонализированных сообщений:

  • Загрузите Excel со столбцами: Mobile, Name, OrderID, Amount
  • Сопоставьте переменные: {{1}} = Name, {{2}} = OrderID, {{3}} = Amount
  • Шаблон: «Здравствуйте, {{1}}, ваш заказ {{2}} на сумму {{3}} руб. подтверждён»

Многомаршрутные SMS

  • Маршрут 0: Рекламные сообщения
  • Маршрут 1: Транзакционные сообщения (OTP, оповещения)

Поддержка Unicode

Отправляйте сообщения на региональных языках, включив режим Unicode.

Контрольный список для начала работы

  • Подключите сервер Telinfy MCP к вашему AI-ассистенту
  • Аутентифицируйтесь с помощью учётных данных Telinfy
  • Убедитесь, что у вас есть активные имена отправителей и шаблоны DLT
  • Проверьте баланс счёта и кредиты
  • Протестируйте с одним SMS перед массовыми кампаниями
  • Создайте организованные группы в телефонной книге
  • Настройте запланированные кампании для оптимального времени
  • Регулярно отслеживайте отчёты

Подробные спецификации API и справочную информацию по параметрам см. в документации Telinfy API или обратитесь к вашему менеджеру по работе с клиентами.