TrueDialog MCP

MCP, el Model Context Protocol, es la forma en que un cliente de IA accede a las herramientas y los datos que necesita para hacer algo de verdad. tdmcp es la infraestructura que conecta cualquier cliente compatible con MCP con la API de SMS de TrueDialog: treinta años de infraestructura de operadores, gestión de bajas, conversaciones bidireccionales, RCS, MMS y tráfico de códigos cortos, expuestos como un pequeño conjunto de herramientas con nombres claros.

La autenticación es OAuth 2.1, no credenciales pegadas. Te autorizas una vez, en el navegador, a través de auth.tdmcp.com, iniciando sesión con las mismas credenciales de TrueDialog que usas en el portal. Tu cliente de IA solo conserva un token bearer de corta duración, nunca tu contraseña, y lo envía en cada llamada. El conector valida el token y resuelve el acceso a TrueDialog en el servidor mediante un canal privado de retorno. No se guarda nada de larga duración en la configuración de tu cliente.

El entorno de ejecución es deliberadamente sencillo: Azure Container Apps detrás de una puerta de entrada administrada, contenedores AMD64, FastMCP sirviendo HTTP transmitible, sin sesiones persistentes. Terraform para todo. Nada sorprendente, nada en la ruta crítica que no hayas puesto ahí.

---

Endpoint: https://connect.tdmcp.com. HTTP transmitible, sin estado. El mismo transporte también responde en https://connect.tdmcp.com/mcp: un alias de compatibilidad para clientes que dan por sentado el patrón de ruta /mcp; cualquiera de las dos URL funciona. La autenticación es OAuth 2.1: tu cliente la detecta automáticamente y te guía durante el inicio de sesión en el navegador. No hay claves ni encabezados que pegar.

Cómo funciona la autorización

Todos los clientes que aparecen a continuación siguen los mismos cuatro pasos, y la mayoría ocurre automáticamente:

1. Añade connect.tdmcp.com a tu cliente.
2. El cliente encuentra el servidor OAuth en auth.tdmcp.com y se registra automáticamente (registro dinámico de clientes, PKCE).
3. Se abre una ventana del navegador. Inicias sesión con tus credenciales de TrueDialog.
4. Tu cliente recibe un token y queda conectado. Lo renueva automáticamente: no tendrás que volver a iniciar sesión hasta que caduque la sesión.

En Claude (aplicación de escritorio o claude.ai), abre Customize → Connectors y haz clic en + → Add custom connector. Asígnale un nombre y la URL del endpoint:

añadir conector personalizado

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

Haz clic en Add y luego en Connect. Se abre una ventana del navegador para iniciar sesión en TrueDialog; aprueba el acceso y aparecerán las nueve herramientas. Claude se registra automáticamente en el servidor OAuth, no hay nada que pegar. En Team/Enterprise, un propietario debe habilitarlo primero para la organización (Organization settings → Connectors → Add → Custom → Web); después, cada miembro lo añade desde Customize → Connectors.

---

Cada herramienta MCP corresponde a una superficie específica de la API de TrueDialog. Son deliberadamente pequeñas y claras; el razonamiento del agente está en el prompt, no en la lista de herramientas. Nueve herramientas en total: seis de solo lectura y tres que escriben.

1. whoami Devuelve el usuario y la cuenta asociados a tu sesión autorizada. Útil como comprobación puntual de autenticación. Solo lectura.
2. list_accounts Muestra todas las cuentas a las que puede acceder tu inicio de sesión. Es importante para quienes operan en varios inquilinos; no para quienes tienen una sola cuenta. Solo lectura.
3. get_account_info Obtiene un registro de una cuenta. De forma predeterminada, usa la cuenta autenticada. Solo lectura.
4. list_channels Muestra los canales —código largo, código corto, RCS, correo electrónico y voz— de una cuenta. Llámala para encontrar el id del canal antes de send_sms. Solo lectura.
5. get_contact Busca un contacto por id. Solo lectura.
6. search_contacts Busca coincidencias parciales en números de teléfono y direcciones de correo electrónico. Solo lectura.
7. create_contact Crea un contacto a partir de un número de teléfono o una dirección de correo electrónico (se requiere al menos uno). Si ese número o correo ya está asociado a un contacto, TrueDialog rechaza la creación y te indica que uses update_contact: no crea duplicados silenciosamente.
8. update_contact Actualiza el teléfono, el correo electrónico o el nombre de un contacto. Primero lee el registro y luego reescribe solo los campos que indiques, para que la actualización de TrueDialog, que sobrescribe todo, no borre el resto. Es una operación de lectura-modificación-escritura, por lo que necesita permiso de lectura de contactos además del permiso de gestión, y no es atómica frente a una edición simultánea. Escribe datos.
9. send_sms Envía un SMS saliente a uno o varios números. Es un envío real: de forma predeterminada llega a teléfonos reales (pasa execute=false para una prueba en seco). Resuelve automáticamente un canal de envío si no indicas uno. Es unidireccional: no lee las respuestas.

Habla con él.

No llamas a estas herramientas por su nombre: simplemente haces una petición y el agente elige las adecuadas. Prueba algunas de estas opciones cuando te conectes:

• «¿Con qué identidad estoy conectado?» confirma la autenticación
• «¿Qué canales están configurados en mi cuenta?» consulta los canales
• «Envía un mensaje de texto a +1 512 555 0142: tu mesa para cuatro está confirmada para las 7 p. m.» un envío, un destinatario
• «Busca el contacto del 512 555 0142 y avísale de que se ha enviado su pedido.» busca y envía

---

Los archivos se gestionan mediante las herramientas de correo electrónico. inbox_send_message e inbox_reply_to_message aceptan una lista de adjuntos; inbox_forward_message, en cambio, incluye los archivos originales (include_attachments, activado de forma predeterminada). Cada elemento de una lista de adjuntos identifica exactamente una fuente de bytes, y la fuente que elijas determina si el archivo llega o no.

Estas herramientas pertenecen al paquete Inbox, que se habilita por implementación. El conector de connect.tdmcp.com anuncia actualmente las nueve herramientas de TrueDialog anteriores; los adjuntos están disponibles con las herramientas de correo electrónico, dondequiera que esté activado el paquete Inbox.

1. attachment_id Identifica un adjunto que la plataforma ya conserva en un mensaje de esta bandeja de entrada: los ids se obtienen de inbox_get_thread. El servidor vuelve a adjuntar los bytes almacenados, así que no se transmite nada en base64 a través del modelo. Esta es la opción adecuada para cualquier archivo que no sea diminuto y la vía natural cuando los bytes ya están en el hilo al que respondes. filename y content_type se heredan de los bytes almacenados y se pueden sobrescribir. Elimina el límite de transcripción, no el límite de tamaño. (Ni siquiera hace falta para los reenvíos: inbox_forward_message incluye los adjuntos originales de forma predeterminada.)
2. upload_id Identifica bytes ya preparados en el almacenamiento: la opción para un archivo nuevo realmente grande. POST a /v1/inboxes/{inbox_id}/attachments/uploads con el nombre del archivo, el tipo MIME y la longitud exacta en bytes; PUT los bytes sin procesar a la upload_url prefirmada que devuelve; luego incluye el upload_id en el envío. Dondequiera que esté activado el paquete Inbox, inbox_create_attachment_upload realiza el primer paso y devuelve el upload_id y la upload_url. Ninguna herramienta realiza PUT, así que un agente cuyo único acceso sea este conector sigue sin poder preparar bytes nuevos; la carga debe realizarla un cliente o una aplicación que pueda PUT por otro medio.
3. content Base64 en línea, proporcionado con filename y content_type. Solo es fiable para archivos muy pequeños: aproximadamente 2 KB, unos 2700 caracteres en base64, porque hay que emitir la cadena completa, carácter por carácter, en la llamada a la herramienta, y un solo carácter incorrecto hace que el envío falle con un error opaco de relleno de base64. Es un límite de fiabilidad, no un límite validado: nada te rechaza al llegar a 2 KB. El envío se acepta y falla más tarde, durante la decodificación.

Qué aplica el servidor

Tres límites, todos comprobados en el servidor:

1. 10 MB por mensaje, sumados entre todos los elementos, sea cual sea su formato: los bytes referenciados cuentan íntegramente, igual que los incluidos en línea. Referenciar un archivo evita tener que transcribirlo; no reduce su tamaño.
2. 10 MB por archivo, aplicados al size_bytes declarado cuando se crea el espacio de carga, de modo que nunca se emite una URL capaz de almacenar un objeto demasiado grande.
3. 100 elementos en una lista de adjuntos.

El total se comprueba a partir de los metadatos almacenados antes de obtener los bytes y de nuevo una vez resuelto todo, así que un envío que supere el límite se rechaza con un 422 en lugar de entregarse parcialmente. Divide en varios envíos cualquier conjunto que supere alguno de los límites.

Los tres formatos se pueden combinar libremente en una misma lista. Las URL de carga prefirmadas tienen una duración limitada —15 minutos de forma predeterminada— y PUT debe enviar exactamente el Content-Type y el Content-Length que recibió, porque la firma cubre ambos. Una carga es de un solo uso: el primer envío que la referencia la consume. GET …/attachments/uploads/{upload_id} indica si el espacio sigue pendiente, cuándo caduca y qué mensaje lo consumió; no comprueba si PUT se cargó correctamente. Si se intenta enviar antes de que estén los bytes, la operación se rechaza con un 422 y no consume la carga, así que puedes volver a intentarlo cuando termine PUT. En sentido inverso, inbox_get_attachment devuelve los bytes de un adjunto codificados en base64.

---

El servidor MCP es la puerta de entrada. El trabajo de producto interesante se construye sobre él: un entorno de ejecución de agentes que convierte las conversaciones por SMS en resultados.

Cuando llega una respuesta por SMS, activa el agente adecuado con todo el contexto de la conversación: el mensaje saliente que la inició, el historial del cliente y el objetivo del hilo. Webhooks, pero para agentes.

Vende objetivos, no minutos. Confirmación y reprogramación de citas en varios turnos, profundización de NPS en puntuaciones bajas, calificación de clientes potenciales B2B y clasificación de solicitudes de soporte. El agente lleva la conversación de principio a fin.

La propiedad intelectual de cumplimiento normativo de TrueDialog aplicada a la capa de respuestas. «No me envíes mensajes por la noche» se convierte en una oferta de horario silencioso, no en una baja total. El registro de auditoría defendible conforme a la TCPA viene incluido.

No sustituyas a tus representantes de soporte. Ayúdalos. Respuestas redactadas, resúmenes de hilos y sugerencias de la siguiente mejor acción, todo integrado en la consola de agentes que ya usan.

---

Stack

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

Licencia

MIT.

Tipografía

Lato, JetBrains Mono.