SuperMailbox · guía de integración con CRM

Conecta SuperMailbox a tu CRM

Cada usuario del CRM obtiene una conexión segura, autorizada con OAuth, a los buzones que elija. El CRM puede encontrar conversaciones con clientes, mostrar contexto de correo verificado y preparar o enviar respuestas mediante el servidor MCP de SuperMailbox.

Cómo funciona la conexión

01

Conecta un buzón

El usuario conecta Gmail, Outlook u otro buzón compatible a SuperMailbox. El inicio de sesión del proveedor de correo es independiente de la autorización del CRM.

02

Autoriza el CRM

El CRM abre OAuth de SuperMailbox en el navegador. El usuario inicia sesión, revisa el cliente y los permisos solicitados y aprueba la conexión.

03

Usa las herramientas MCP

El CRM llama al servidor MCP remoto con el token del usuario. El usuario elige un buzón autorizado y el CRM opera dentro de ese acceso.

Configuración de conexión

Usa un cliente o SDK de MCP compatible con Streamable HTTP remoto y descubrimiento de OAuth. Debe gestionar la autorización en el navegador y enviar el token de acceso con las solicitudes MCP.

URL del servidor MCP
https://api.supermailbox.app/mcp
Autorización
OAuth 2.0 · Authorization Code · PKCE S256
Permisos
openid email mail.accounts.read mail.messages.read mail.send

Solicita solo el acceso que necesita tu flujo. Un CRM que lee conversaciones y envía respuestas puede solicitar:

Encuentra y verifica una conversación

  • Llama a list_mail_accounts para que el usuario elija un buzón disponible. canSend es una indicación; el permiso para enviar se comprueba de nuevo al ejecutar la acción.
  • Busca candidatos con search_emails o search_threads_by_recipient. La búsqueda por destinatario devuelve solo metadatos; obtén y verifica el hilo elegido antes de vincularlo a un registro del CRM.
  • Los resultados pueden estar limitados o incompletos. Respeta los campos coverage y completeness; un resultado parcial vacío no demuestra que no haya mensajes.
  • Los IDs de buzón, mensaje e hilo son opacos y pertenecen al acceso del usuario actual. Resuélvelos y verifícalos con esa misma conexión.

Prepara y envía respuestas de forma segura

  • Antes de confirmar el envío, muestra en el CRM el buzón, el destinatario y el texto de respuesta seleccionados.
  • send_email y reply_to_email devuelven una operación en cola. Consulta get_mail_action con el mismo ID de operación y los permisos necesarios hasta obtener un estado final.
  • Una confirmación de cola no demuestra que el correo se haya entregado. Si el envío queda en estado incierto, consulta esa operación; nunca la repitas automáticamente con otro ID.

Seguridad y control de acceso

  • Usa el flujo OAuth de código de autorización con PKCE S256 mediante el descubrimiento compatible del cliente MCP. Guarda secretos y tokens en el servidor; nunca los expongas al navegador ni a los registros.
  • Crea una conexión independiente para cada usuario del CRM. No compartas el token ni los identificadores opacos de correo entre usuarios.
  • Solicita mail.send solo si el CRM necesita enviar. El usuario puede revocar la conexión del CRM desde los ajustes de aplicaciones conectadas de SuperMailbox.