Conectá WhatsApp.
Respetá sus permisos.

Integrar una aplicación propia con MCP

Enlazá publica un servidor MCP remoto en https://enlaza.chat/mcp, con transporte HTTP stateless. Tu producto funciona como cliente MCP y cada usuario autoriza su propia cuenta mediante OAuth o una clave personal con permisos elegidos por usuario.

Descubrimiento y autorización con OAuth

1. Usá la URI de recurso https://enlaza.chat/mcp y seguí los metadatos de Protected Resource publicados en https://enlaza.chat/.well-known/oauth-protected-resource/mcp (o la URL indicada en el desafío WWW-Authenticate). Descubrí allí el servidor de autorización y sus endpoints; no supongas rutas.
2. Si elegís OAuth, implementá Authorization Code con PKCE S256 y registro dinámico de cliente (DCR). Enlazá no habilita CIMD. Usá un flujo de consentimiento por usuario y la audiencia/recurso exacta https://enlaza.chat/mcp.
3. Pedí permisos mínimos: whatsapp:read para cuentas, mensajes y estados; sumá whatsapp:send si el usuario necesita enviar; sumá whatsapp:events solo si tu cliente puede recibir callbacks y verificar webhooks firmados. offline_access es opcional para renovar acceso.
4. Conservá cada token cifrado y separado por usuario. Enviá el token solo en el header Authorization: Bearer …; nunca en una URL ni en logs. No pidas ni guardes contraseñas de Enlazá, códigos de Meta ni tokens copiados en el chat.

Inicialización y herramientas

Usá un SDK MCP con transporte Streamable HTTP: inicializá y negociá la versión, enviá notifications/initialized, descubrí capacidades con tools/list y ejecutá únicamente las herramientas anunciadas con tools/call. El servidor espera solicitudes MCP por POST; GET y DELETE no son un canal de streaming.

• whatsapp_accounts {}: números propios y estado. ready confirma la conexión y el webhook configurado; verificá una entrega con whatsapp_message_status después de enviar.
• whatsapp_mark_read {connection_id, message_id, typing?}: marca un mensaje entrante como leído; con typing: true muestra también «escribiendo…» durante un máximo de 25 segundos. Es visible para el contacto, puede marcar mensajes anteriores del chat y requiere autorización del titular y permisos de lectura y envío. Usá esta herramienta para mostrar esos estados cuando estén autorizados.
• whatsapp_notifications_status {connection_id}: consulta el estado real de los avisos de este asistente, sus filtros y vencimiento. Para activar avisos, comprobá el estado y luego suscribite mediante events/subscribe.
• whatsapp_messages {connection_id, contact?, before?, cursor?, message_id?, include_images?}: hasta 50 mensajes por página. Usá next_cursor para seguir. Esta herramienta ofrece texto compatible y attachment.display_url para cada foto o sticker, con una ruta de lectura consistente entre asistentes. El agente puede abrir el enlace con su lector de imágenes y ofrecértelo como «Ver imagen». Al actualizar el enlace privado, consultá los mensajes otra vez. Para contenido visual MCP directo, usá whatsapp_media en los asistentes compatibles; este recorrido mantiene la compatibilidad visual en Dots y evita el error «Unexpected response type». El enlace privado vence en 15 minutos: compartilo en el chat privado del titular y describí la imagen después de abrirla.
• whatsapp_message_status {connection_id, message_id}: consulta el estado de un mensaje enviado desde Enlazá.
• whatsapp_media {connection_id,message_id,display_to_user:true}: entrega la imagen real y un enlace privado de 15 minutos para mostrarla al titular si el chat no admite adjuntos. Usar primero la presentación nativa de imágenes. No confundir ver con enviar.
• whatsapp_send_image {connection_id,to,source_message_id OR image_url,caption?,request_id}: enviar una foto JPEG/PNG de hasta 5 MB a WhatsApp. Usar el mensaje propio de origen o un archivo HTTPS directo; no rutas locales ni URLs con login. Requiere autorización para esa foto y destinatario, permisos de lectura y envío y la ventana de 24 horas. Reutilizar UUID en reintentos y comprobar entrega. Para imágenes subidas al chat, el host debe poder ofrecer el archivo. Ver los tres recorridos y límites.
• whatsapp_templates {connection_id}: catálogo español con estado actual, variables y condición de uso. whatsapp_send_template {connection_id,to,name,values,recipient_opt_in,purpose_confirmed,request_id}: enviar solo una plantilla aprobada y adecuada. Consentimiento del destinatario y motivo real deben estar confirmados; no inventarlos. Respetar la autorización vigente del titular. Fuera de 24 horas o ante WINDOW_24H_EXPIRED, explicar brevemente, elegir y enviar si esas condiciones se cumplen. La plantilla no abre las 24 horas: esperar la respuesta del contacto.
• whatsapp_send_text {connection_id, to, text, request_id}: texto de hasta 4096 caracteres, destino internacional en dígitos y request_id UUID. Para reintentar el mismo mensaje, reutilizá el mismo UUID y los mismos datos; para un nuevo mensaje, creá otro.

El connection_id debe pertenecer a la cuenta autenticada actual. Para texto libre, el contacto debe haber enviado un mensaje real en las últimas 24 horas. Un resultado en cola no confirma entrega; consultá el estado. Fuera de la ventana se necesita una plantilla aprobada para ese número, con consentimiento del destinatario.

Eventos opcionales

Para activar avisos de eventos, usá un cliente que implemente la extensión MCP Events y tenga un callback HTTPS público. Descubrí server/discover y events/list, comprobá el desafío y verificá las firmas Standard Webhooks antes de suscribirte. whatsapp.message.received avisa cuando llegan mensajes entrantes nuevos. Deduplicá eventId, renová antes de refreshBefore (duración máxima: 24 horas) y consultá el contenido con whatsapp_messages.

Referencias oficiales: autorización MCP · transporte HTTP MCP.