Conectar con MCP | AgentsMail.io Documentation

MCP permite que un agente compatible lea tus listas, prepare una campaña o consulte sus resultados en AgentsMail. Autorizas la conexión en el navegador y eliges la organización en la que puede trabajar, sin copiar una clave API.

Activa el sonido del reproductor para escuchar la explicación.

Comandos para copiar

Claude Code

En tu terminal, añade AgentsMail a tu configuración personal. La opción --scope user permite usar esta conexión en tus proyectos.

Claude Code · terminal

claude mcp add --transport http --scope user agentsmail https://www.agentsmail.io/api/mcp

Abre o reinicia Claude Code. En su conversación, escribe:

Dentro de Claude Code

/mcp

Elige agentsmail e inicia la autenticación. El navegador abre AgentsMail para pedir tu autorización.

Codex

En tu terminal, añade el servidor:

Codex · terminal

codex mcp add agentsmail --url https://www.agentsmail.io/api/mcp

Si la autorización no se abrió automáticamente, o para volver a conectar, ejecuta:

Codex · autorización

codex mcp login agentsmail

Después del consentimiento, abre o reinicia Codex. Usa /mcp dentro de Codex para comprobar las herramientas activas.

Los comandos del terminal configuran la conexión. Para acceder a tus datos, debes autorizarla después en el navegador, donde eliges la organización. No necesitas copiar una clave API.

Para los ajustes propios de cada cliente, consulta las guías oficiales de Claude Code y Codex.

Autorizar el acceso en el navegador

Tras iniciar la autenticación desde tu cliente, inicia sesión en AgentsMail con tu cuenta habitual. Si usas autenticación de dos factores, completa también ese paso.
Comprueba el nombre de la aplicación, la dirección de retorno y los permisos. Una aplicación que se registra por sí misma aparece como Aplicación no verificada: el nombre lo proporciona la aplicación, no lo verifica AgentsMail.
En Organización, selecciona dónde debe trabajar el agente. Solo aparecen las organizaciones a las que perteneces. Si la lista está vacía, únete a una organización o crea una antes de continuar.
Elige Autorizar, o Rechazar para volver sin conceder acceso. Cambiar de cuenta permite iniciar sesión con otra cuenta antes de decidir.
Pide al agente que llame a get_account y después a list_lists. Comprueba la organización indicada y busca una lista que reconozcas antes de pedir un cambio.

Cada respuesta indica la organización autorizada. Cambiar de organización en la aplicación web no cambia la conexión del agente; renovar su acceso conserva la misma elección. Para trabajar en otra, vuelve a conectar y elígela. Si sales de la organización, el agente pierde ese acceso.

Qué autorizas al conectar

Los permisos que solicita la aplicación, también llamados scopes, determinan las familias de herramientas que puede usar esa conexión.

Permiso	Herramientas
Lectura (`mcp:read`)	`get_account`, `list_lists`, `list_contacts`, `list_tags`, `list_templates`, `list_campaigns`, `get_campaign`, `get_campaign_stats`, `list_sequences`, `list_media`
Gestión (`mcp:manage`)	`create_list`, `upsert_contact`, `create_template`, `create_campaign`, `upload_media`, `delete_media`
Envío de campañas (`mcp:send`)	`send_campaign`
Mantener la conexión (`offline_access`)	Conserva la conexión cuando caduca un token de acceso de corta duración.

Estos permisos no amplían los de tu cuenta. Los miembros pueden leer; la gestión requiere ser administrador o propietario de la organización. Iniciar campañas también requiere el permiso de envío disponible para tu cuenta. Siguen aplicándose los límites del plan y las unidades de envío disponibles. Después puedes desactivar una familia de acciones en Permisos MCP sin volver a conectar el agente. Activar Gestión ahí no añade herramientas a una conexión que solo solicitó lectura: vuelve a conectar la aplicación con los permisos necesarios. list_contacts necesita un listId: búscalo con list_lists. Las herramientas paginadas aceptan page y limit (hasta 100). create_template acepta HTML e informa de las etiquetas de combinación no compatibles. create_campaign crea un borrador y puede copiar una plantilla de la misma organización.

Añadir un contacto puede activar tus correos de confirmación y automatizaciones configuradas. Eliminar un medio es permanente. Pide al agente que explique estos efectos antes de modificar tus datos.

Aprobar cada envío

Autorizar la conexión no aprueba los envíos de campañas. Revisa el público y el contenido, y aprueba esa campaña concreta. El agente debe pasar confirmation: true a send_campaign. Aprobar una campaña no aprueba las futuras. El resultado send_requested significa que AgentsMail ha aceptado la solicitud; no que todos los correos se hayan entregado. Sigue el progreso con get_campaign y los resultados con get_campaign_stats.

Cambiar permisos sin volver a conectar

Abre el menú bajo tu nombre en la barra lateral, elige Cuenta y después la pestaña Permisos MCP. Hay tres interruptores: Lectura, Gestión y Envío de campañas. Cambia tus opciones y pulsa Guardar permisos. Se aplican a la siguiente solicitud, incluso de un agente ya conectado. Son ajustes personales: desactivar la lectura la desactiva para todas tus aplicaciones MCP, en todas las organizaciones a las que tengan acceso.

Fijar un límite diario

En la misma página, indica las Unidades de envío por día y pulsa Guardar permisos.

Valor	Efecto
Campo vacío	Sin límite MCP diario
`0`	Ningún envío de pago de campañas solicitado por MCP
Entero positivo	Máximo diario en las unidades de envío habituales

El contador es común a tus aplicaciones y sigue la zona horaria de tu cuenta. Cuenta las unidades reservadas por las solicitudes de envío; las solicitudes que ya se están procesando siguen contándose aunque el envío falle. Comprueba el contador y el límite antes de reintentar. También se aplican el saldo y las reglas de envío de la organización.

Este límite cubre campañas solicitadas por MCP. No limita las confirmaciones y automatizaciones configuradas que puede activar la incorporación de un contacto.

Revocar una aplicación

Aplicaciones conectadas muestra cada aplicación, su dirección de retorno, permisos y organizaciones autorizadas. Revocar bloquea esa aplicación en su próxima solicitud en todas esas organizaciones e impide renovar el acceso. Las solicitudes ya en curso pueden finalizar. Para bloquear una familia de acciones en todas tus aplicaciones, desactiva el permiso correspondiente. Confirma la revocación en el diálogo o elige Cancelar para mantener la conexión. Para autorizar de nuevo la aplicación, inicia otra conexión y comprueba su organización y sus permisos.

Si falla la conexión

Situación	Qué hacer
La página de autorización ha caducado	Inicia otra conexión desde el agente.
Una familia de acciones está desactivada	Activa el permiso en Permisos MCP y guarda.
La aplicación nunca solicitó ese permiso	Vuelve a conectar con los permisos necesarios.
No se encuentra una lista o campaña	Comprueba la organización con `get_account` y que sigues perteneciendo a ella.
Se ha alcanzado el límite diario de envío	Comprueba el contador; ajusta el límite o espera al día siguiente.
La aplicación fue revocada	Vuelve a conectar para conceder un nuevo acceso.

Una cuenta suspendida no puede seguir usando su conexión. Un envío también puede rechazarse si el público de la campaña cambia después de la solicitud: comprueba su público y las unidades disponibles antes de reintentar.

Ver también

El skill de AgentsMail aporta instrucciones para redactar correos y utilizar el producto. MCP ofrece las herramientas anteriores; la referencia de API describe la API más amplia.