TrueDialog MCP

MCP, Model Context Protocol, — это способ, с помощью которого ИИ-клиент получает доступ к инструментам и данным, необходимым для выполнения задач. tdmcp — связующее звено между любым клиентом, поддерживающим MCP, и SMS API TrueDialog: тридцать лет инфраструктуры операторского уровня, обработка отказов от рассылки, двусторонние диалоги, RCS, MMS и трафик коротких номеров — всё это доступно через небольшой набор понятных инструментов.

Для аутентификации используется OAuth 2.1, а не вставка учётных данных. Вы один раз проходите авторизацию в браузере на auth.tdmcp.com, войдя с теми же данными TrueDialog, что и на портале. Ваш ИИ-клиент получает только краткосрочный токен Bearer, но не пароль, и отправляет его при каждом вызове. Коннектор проверяет токен и на серверной стороне получает доступ к TrueDialog через приватный обратный канал. В конфигурации клиента не сохраняются долгосрочные данные.

Среда выполнения намеренно устроена без излишеств: Azure Container Apps за управляемым внешним шлюзом, контейнеры AMD64, FastMCP с поддержкой Streamable HTTP, без привязки к сессиям. Всё развёртывается через Terraform. Ничего неожиданного и ничего в критическом пути, чего вы туда не добавили.

---

Конечная точка: https://connect.tdmcp.com. Streamable HTTP, без сохранения состояния. Транспорт также доступен по адресу https://connect.tdmcp.com/mcp — это псевдоним для совместимости с клиентами, которые предполагают соглашение о пути /mcp; работают оба URL. Используется аутентификация OAuth 2.1 — клиент автоматически обнаружит её и проведёт вас через вход в браузере. Никаких ключей или заголовков вставлять не нужно.

Как работает авторизация

Все перечисленные ниже клиенты выполняют одни и те же четыре шага, и большая часть процесса происходит автоматически:

1. Добавьте connect.tdmcp.com в свой клиент.
2. Клиент находит сервер OAuth по адресу auth.tdmcp.com и автоматически регистрируется на нём (динамическая регистрация клиента, PKCE).
3. Откроется окно браузера. Войдите, используя свои учётные данные TrueDialog.
4. Клиент получит токен, и подключение будет установлено. Токен обновляется автоматически — повторно входить не придётся, пока не истечёт срок действия сессии.

В Claude (приложении Desktop или на claude.ai) откройте Customize → Connectors и нажмите + → Add custom connector. Укажите название и URL конечной точки:

добавление пользовательского коннектора

Name:   TrueDialog
URL:    https://connect.tdmcp.com/

Нажмите Add, затем Connect. Откроется окно браузера для входа в TrueDialog; подтвердите вход, и появятся девять инструментов — Claude автоматически зарегистрируется на сервере OAuth, ничего вставлять не нужно. В Team/Enterprise владелец должен сначала включить коннектор для организации (Organization settings → Connectors → Add → Custom → Web); после этого каждый участник добавляет его через Customize → Connectors.

---

Каждый инструмент MCP соответствует определённой части API TrueDialog. Они намеренно небольшие и понятные; логика агента задаётся в промпте, а не в списке инструментов. Всего девять инструментов: шесть только для чтения и три для записи.

1. whoami Возвращает пользователя и учётную запись, связанные с авторизованной сессией. Удобно для быстрой проверки авторизации. Только чтение.
2. list_accounts Перечисляет все учётные записи, доступные вашему логину. Это важно для операторов с несколькими клиентами, но не для пользователей с одной учётной записью. Только чтение.
3. get_account_info Получает запись одной учётной записи. По умолчанию используется учётная запись, связанная с авторизацией. Только чтение.
4. list_channels Перечисляет каналы учётной записи — длинные номера, короткие номера, RCS, электронную почту и голосовую связь. Вызовите этот инструмент, чтобы узнать идентификатор канала перед вызовом send_sms. Только чтение.
5. get_contact Находит контакт по идентификатору. Только чтение.
6. search_contacts Выполняет поиск по подстроке в номерах телефонов и адресах электронной почты. Только чтение.
7. create_contact Создаёт контакт по номеру телефона или адресу электронной почты (обязательно указать хотя бы одно из них). Если этот номер или адрес уже есть у контакта, TrueDialog отклонит создание и предложит использовать update_contact — дубликат не будет создан незаметно.
8. update_contact Обновляет номер телефона, адрес электронной почты или имя контакта. Сначала считывает запись, а затем перезаписывает только переданные поля, чтобы обновление TrueDialog, которое перезаписывает все данные, не удалило остальные. Это операция чтения-изменения-записи, поэтому помимо разрешения manage требуется разрешение на чтение контактов; кроме того, она не атомарна при параллельном редактировании. Запись.
9. send_sms Отправляет исходящее SMS одному или нескольким номерам. Это реальная отправка: по умолчанию сообщение поступает на реальные телефоны (передайте execute=false для пробного запуска). Если канал отправки не указан, он определяется автоматически. Односторонняя отправка — ответы не считываются.

Общайтесь с ним.

Не нужно вызывать эти инструменты по имени — просто задайте вопрос, и агент выберет нужные. Вот несколько примеров, которые можно попробовать после подключения:

• «Кем я подключён?» — проверка авторизации
• «Какие каналы настроены в моей учётной записи?» — просмотр каналов
• «Отправь SMS на +1 512 555 0142: ваш столик на четверых подтверждён на 19:00» — одна отправка одному получателю
• «Найди контакт для 512 555 0142 и сообщи, что его заказ отправлен» — поиск контакта и отправка сообщения

---

Файлы передаются через инструменты электронной почты. inbox_send_message и inbox_reply_to_message принимают список вложений; inbox_forward_message вместо этого переносит исходные файлы (include_attachments включён по умолчанию). Каждый элемент списка вложений указывает ровно на один источник данных, и от выбранного источника зависит, дойдёт ли файл до получателя.

Эти инструменты входят в пакет Inbox, который включается отдельно для каждого развёртывания. Сейчас коннектор по адресу connect.tdmcp.com предоставляет девять перечисленных выше инструментов TrueDialog; вложения доступны через инструменты электронной почты в тех развёртываниях, где включён пакет Inbox.

1. attachment_id Указывает на вложение, которое платформа уже хранит в сообщении этого почтового ящика; идентификаторы можно получить через inbox_get_thread. Сервер сам повторно прикрепляет сохранённые данные, поэтому модели не нужно передавать base64. Это подходящий вариант для всего, что не является совсем маленьким файлом, и естественный выбор, если данные уже есть в цепочке сообщений, на которое вы отвечаете. filename и content_type наследуются от сохранённых данных, но их можно переопределить. Это снимает ограничение на объём текста для расшифровки, но не ограничение на размер файла. (Для пересылки этот идентификатор вообще не нужен: inbox_forward_message по умолчанию переносит исходные вложения.)
2. upload_id Указывает на данные, уже загруженные во временное хранилище; этот способ подходит для действительно нового большого файла. POST на /v1/inboxes/{inbox_id}/attachments/uploads с именем файла, MIME-типом и точным размером в байтах; PUT необработанные данные по возвращённому предварительно подписанному адресу upload_url; затем укажите upload_id при отправке. Везде, где включён пакет Inbox, inbox_create_attachment_upload выполняет первый шаг и возвращает upload_id и upload_url. Ни один инструмент не выполняет PUT, поэтому агент, имеющий доступ только к этому коннектору, всё равно не может загрузить новые данные; загрузку должен выполнить клиент или приложение, способное PUT вне этого канала.
3. content Данные в формате base64, передаваемые непосредственно вместе с filename и content_type. Надёжно работает только для очень маленьких файлов — примерно до 2 КБ, или около 2700 символов base64, — поскольку всю строку нужно посимвольно передать в вызове инструмента, а одна неверная буква приводит к сбою отправки с непонятной ошибкой заполнения base64. Это предел надёжности, а не проверяемое ограничение: при размере 2 КБ запрос не отклоняется. Отправка принимается, но позже завершается ошибкой при декодировании.

Ограничения на стороне сервера

Три ограничения, все проверяются на сервере:

1. 10 МБ на сообщение суммарно по всем элементам, независимо от их формата; учитываются все байты вложений, в том числе указанных ссылками, точно так же, как и встроенных. Ссылка избавляет от необходимости передавать содержимое файла текстом, но не уменьшает его размер.
2. 10 МБ на файл; ограничение применяется к заявленному значению size_bytes при создании слота загрузки, поэтому URL, позволяющий сохранить файл сверх допустимого размера, не выдаётся.
3. 100 элементов в одном списке вложений.

Общий размер проверяется по сохранённым метаданным до получения данных и повторно после разрешения всех ссылок, поэтому отправка сверх лимита отклоняется с 422, а не доставляется частично. Если набор превышает любое из ограничений, разделите его на несколько отправок.

Все три формата можно свободно сочетать в одном списке. Срок действия предварительно подписанных URL для загрузки ограничен — по умолчанию 15 минут, — а PUT должен отправить точно те значения Content-Type и Content-Length, которые были переданы, поскольку подпись учитывает оба заголовка. Загрузка одноразовая: первая отправка, в которой указан этот идентификатор, использует его. GET …/attachments/uploads/{upload_id} сообщает, ожидает ли слот загрузки, когда истекает его срок действия и какое сообщение его использовало; этот запрос не проверяет, что ваш PUT был загружен. Если отправить сообщение до загрузки данных, запрос будет отклонён с 422, а слот останется доступным для повторной попытки после завершения PUT. Для чтения в обратном направлении inbox_get_attachment возвращает данные вложения в кодировке base64.

---

MCP-сервер — это точка входа. Самая интересная работа над продуктом начинается поверх него: среда выполнения агента, превращающая SMS-диалоги в результат.

Когда приходит ответ на SMS, запускайте нужного агента с полным контекстом диалога: исходным сообщением, которое вызвало ответ, историей клиента и целью переписки. Вебхуки, но для агентов.

Продавайте достижение целей, а не минуты. Подтверждение и перенос записи в ходе многоэтапного диалога, уточнение низких оценок NPS, квалификация B2B-лидов, сортировка обращений в поддержку. Агент ведёт диалог от начала до конца.

Применяйте наработки TrueDialog в области соблюдения требований к обработке ответов. «Не пишите мне ночью» превращается в предложение соблюдать тихие часы, а не в полную отписку. Аудиторский след, обосновывающий соблюдение TCPA, предоставляется бесплатно.

Не заменяйте сотрудников поддержки — помогайте им. Черновики ответов, сводки переписок и рекомендации следующего наилучшего действия — всё это доступно в консоли агента, которой они уже пользуются.

---

Стек

FastMCP / httpx / Python 3.14
Azure Container Apps / ACR / Static Web Apps / Azure DNS
Terraform / Docker

Лицензия

MIT.

Шрифт

Lato, JetBrains Mono.