ClickSend MCP Server

Это официальный ClickSend MCP Server, разработанный командой ClickSend. По соображениям безопасности не используйте неофициальные версии ClickSend MCP.

Назначение

ClickSend MCP предназначен для расширения возможностей обмена сообщениями ClickSend в современных экосистемах ИИ и платформах — он позволяет разработчикам легко отправлять SMS через ClickSend без необходимости писать пользовательский код.

Это ускоряет внедрение, открывает новые сценарии использования на основе ИИ и позиционирует ClickSend как готовую к будущему платформу обмена сообщениями в эпоху интеллектуальной автоматизации.

Related MCP server: Twilio MCP Server

Требования

• Node.js >= 18

  • вы можете использовать nvm (Node Version Manager), чтобы установить нужную версию для работы с этим приложением

Установка

Загрузите AI десктопный клиент. Примером может быть Claude для Desktop, который можно скачать здесь.

Конфигурация

Сервер требует две переменные окружения:

• CLICKSEND_USERNAME: ваше имя пользователя ClickSend

• CLICKSEND_API_KEY: ваш API-ключ ClickSend

Имя пользователя и ключ можно найти на https://dashboard.clicksend.com/account/subaccounts после регистрации в ClickSend.

Настройка Claude Desktop

• Откройте Claude для Desktop

• Перейдите в Настройки в системном меню

• В окне настроек перейдите на вкладку Разработчик и нажмите Изменить конфигурацию. Это откроет файл конфигурации, расположенный по адресу:

  • 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, чтобы перезагрузить конфигурацию. Если подключение установлено, вы должны увидеть clicksend-send-sms при нажатии на значок молотка.

Примеры взаимодействий с Claude

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

Простое SMS:

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

Возможности

• Отправка одного SMS за раз с помощью настройки имени пользователя clicksend и API-ключа

• Получение цены на отправку сообщения в список контактов

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

• Получение шаблонов SMS и использование их для отправки сообщения

• Просмотр/получение истории SMS

• Получение статистики SMS за последние 30 дней

Поддерживаемые API

1. POST /v3/sms/send

• Идентификатор операции: send-sms

• Краткое описание: Отправить SMS

• Описание: Отправка сообщений получателям — либо по номерам телефонов, либо по контактам из списка контактов.

2. POST /v3/sms/price

• Идентификатор операции: calculate-sms-price

• Краткое описание: Рассчитать цену SMS

• Описание: Расчёт стоимости отправки сообщений на основе типа и длины сообщения.

3. GET /v3/sms/templates

• Идентификатор операции: view-sms-templates

• Краткое описание: Просмотр шаблонов SMS

• Описание: Получение шаблонов SMS с параметрами фильтрации.

4. GET /v3/sms/history

• Идентификатор операции: view-sms-history

• Краткое описание: Просмотр истории SMS

• Описание: Просмотр ранее отправленных SMS с параметрами фильтрации и постраничного вывода.

5. GET /v3/statistics/sms

• Идентификатор операции: view-sms-statistics

• Краткое описание: Просмотр статистики SMS

• Описание: Получение статистики SMS за последние 24 дня.

6. GET /v3/search/contacts-lists

• Идентификатор операции: view-contact-lists

• Краткое описание: Просмотр списков контактов

• Описание: Получение списка найденных списков контактов.

Важные замечания

1. Формат номера телефона: Все номера телефонов должны быть в формате E.164 (например, +61411111111)

2. Лимиты скорости: Учитывайте лимиты скорости и тарифы вашего аккаунта ClickSend

3. Безопасность: Храните свои учетные данные ClickSend в безопасном месте и никогда не коммитьте их в систему контроля версий

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

Распространенные сообщения об ошибках и их решения:

1. "Номер телефона должен быть в формате E.164"

   • Убедитесь, что номер телефона начинается с "+" и кода PAI

2. "Неверные учетные данные"

   • Перепроверьте CLICKSEND_USERNAME и CLICKSEND_API_KEY. Вы можете скопировать их из панели ClickSend.com)

Вклад в разработку

Приветствуется! Пожалуйста, прочитайте наши правила внесения вклада перед отправкой pull request.

Лицензия

Этот проект лицензирован в соответствии с MIT License - details см. файл LICENSE.

Безопасность

Пожалуйста, не вкincudeйте никакую конфиденциальную информацию (например, номера телефонов или данные ClickSend) в issues или pull request на GitHub.# ClickSend MCP Server

Это официальный ClickSend MCP Server, разработанный командой ClickSend. По соображениям безопасности не используйте неофициальные версии ClickSend MCP.

Назначение

ClickSend MCP предназначен для расширения возможностей обмена сообщениями ClickSend в современных экосистемах ИИ и связанных платформах — он позволяет разработчикам легко отправлять SMS через ClickSend без необходимости писать пользовательский код.

Это ускоряет внедрение, открывает новые сценарии использования на основе ИИ и позиционирует ClickSend как платформу обмена сообщениями, готовую к будущему, в эпоху интеллектуальной автоматизации.

Требования

• Node.js >= 18

  • Вы можете использовать nvm (Node Version Manager), чтобы выбрать нужную версию для запуска приложения

Установка

Скачайте ИИ-десктоп-клиент. Например, Claude для Desktop, который можно скачать здесь.

Конфигурация

Сервер требует две переменные:

• CLICKSEND_USERNAME: ваше имя пользователя ClickSend

• CLICKSEND_API_KEY: ваш API-ключ ClickSend

Имя пользователя и ключ можно найти по адресу https://dashboard.click.send/account/subaccounts после регистрации в ClickSend.

Конфигурация Claude Desktop

• Откройте Claude for Desktop

• Перейдите в Настройки через меню системы.

• В окне настроек перейдите на вкладку Разработчик и нажмите Изменить конфигурацию. Откроется файл конфигурации, расположенный по адресу:

  • 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, чтобы перезагрузить конфигурацию. Если подключение установлено, вы увидите clicksend-send-sms при нажатии на иконку.

Примеры взаимодействия с Claude

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

Простое SMS:

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

Возможности

• Отправка одного SMS за раз с помощью настроек имена пользователя и API-ключа ClickSend

• Получение цены за отправку сообщения в список контактов

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

• Получение SMS-шаблонов и их использование для отправки сообщений

• Просмотр/получение SMS-истории

• Получение статистики SMS за последние 30 дней

Поддерживаемые API

1. POST /v3/sms/send

• Операция: send-sms

• Краткое описание: Отправка SMS-

• Описание: Отправляет сообщения получателям — либо на телефонные номера, либо контактам из списка контактов.

2. POST /v3/sms/price

• Операция: calculate-sms-price

• Краткое описание: Расчет цены SMS

• Описание: Рассчитывает цену отправки сообщений на основе типа и длины сообщения.

3. GET /v3/sms/templates

• Операция: view-sms-templates

• Краткое описание: Просмотр шаблонов SMS

• Описание: Получение шаблонов SMS с возможными вариантами фильтрами.

4. GET /v3/sms/history

• Операция: view-sms-history

• Краткое описание: Просмотр истории SMS

• Описание: Просмотр ранее отправленных SMS с фильтрацией и пагинацией.

5. GET /v3/statistics/sms

• Операция: view-sms-statistics

• Краткое описание: Просмотр статистики SMS

• Описание: Получение статистики SMS за последние 30 дней.

6. GET /v3/search/contacts-lists

• Операция: view-contact-lists

• Краткое описание: Просмотр списков контактов

• Описание: Получение списка найденных списков.

Important Notes

1. Номер телефона: Все номера телефонов должны быть в формате E.164 (например, +61411111111)

2. Лимиты и тарифы: Учитывайте лимиты и тарифы вашего аккаунта ClickSend

3. Безопасность: Храните свои учетные данные ClickSend в безопасности и никогда не передавайте их в систему контроля версий

Возможные проблемы

Распространенные сообщения об ошибках и действия:

1. "Phone number must be in E.164 format" (Номер телефона должен быть в формате E.164)

   • Убедитесь, что номер начинается с "+" и кода страны.

2. "Invalid credentials" (Неверные данные)

   • Проверьте CLICKSEND_USERNAME и CLICKSEND_API_KEY. Их можно скопировать из панели ClickSend.

Участие в разработке

Приглашаем к участию! Пожалуйста, прочитайте наши рекомендации перед отправкой pull request.

Лицензия

Этот проект лицензионован на условиях MIT License — см. файл LICENSE.

Безопасность

Пожалуйста, не включайте никаую конфиденциальную информацию (например, номера телефонов или данные ClickSend) в issues или pull request GitHub.