Integración MCP

DMARC Examiner es compatible con el Model Context Protocol (MCP), un estándar abierto que permite a los asistentes de IA interactuar con herramientas y fuentes de datos externas. Con la integración MCP, consultas tus datos DMARC directamente desde asistentes de IA como Claude Desktop, Claude Code y Cursor.

Qué puedes hacer

Una vez conectado, puedes hacer preguntas en lenguaje natural a tu asistente de IA sobre tus datos DMARC:

"Muéstrame todos mis dominios monitorizados"
"¿Cuál es la tasa de aprobación del último informe de example.com?"
"¿Hay alguna alerta crítica que deba revisar?"
"Exporta el último informe a CSV"
"¿Qué países envían más correos que fallan?"

El asistente de IA usa las herramientas de DMARC Examiner por detrás para obtener y presentar los datos.

Configuración

Claude Desktop

Añade lo siguiente al archivo de configuración de Claude Desktop:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "dmarc-examiner": {
      "url": "https://mcp.dmarc-examiner.com/mcp"
    }
  }
}

Reinicia Claude Desktop después de guardar.

Claude Code

Ejecuta este comando en tu terminal:

claude mcp add dmarc-examiner --transport http https://mcp.dmarc-examiner.com/mcp

Cursor

Añade esto a la configuración MCP de Cursor (Settings > MCP):

{
  "mcpServers": {
    "dmarc-examiner": {
      "url": "https://mcp.dmarc-examiner.com/mcp"
    }
  }
}

Alternativa: npx (para clientes sin soporte de HTTP remoto)

Si tu cliente MCP no admite servidores HTTP remotos, puedes instalarlo directamente desde GitHub:

{
  "mcpServers": {
    "dmarc-examiner": {
      "command": "npx",
      "args": ["-y", "github:dmarc-examiner/mcp"]
    }
  }
}

Flujo de autorización

La primera vez que uses las herramientas de DMARC Examiner en tu asistente de IA, pasarás por un flujo de autorización:

Se abre el navegador: tu cliente de IA abre una ventana del navegador con la página de autorización de DMARC Examiner
Inicia sesión: si no tienes la sesión iniciada, te pedirá que entres en tu cuenta de DMARC Examiner
Selecciona la organización: elige a qué datos de organización quieres acceder
Aprueba los scopes: revisa y aprueba los permisos que solicita el asistente de IA
Conectado: el navegador te redirige de vuelta y tu asistente de IA ya está listo

Tu cliente MCP guarda la autorización en local. No tendrás que volver a autorizar salvo que tu token caduque o revoques el acceso.

Scopes

Durante la autorización, se te pedirá que apruebes uno o varios scopes. Cada scope da acceso a herramientas concretas:

Scope	Descripción	Herramientas
`domains:read`	Ver los dominios monitorizados	`list_domains`, `get_domain`
`reports:read`	Ver informes y estadísticas	`list_reports`, `get_report`, `get_report_statistics`
`reports:export`	Exportar informes a CSV	`export_report_csv`
`alerts:read`	Ver alertas	`list_alerts`
`alerts:manage`	Gestionar alertas	`dismiss_alert`

Puedes desmarcar los scopes que no quieras conceder. Si más adelante necesitas una herramienta que requiere un scope no aprobado, tu asistente de IA te pedirá que vuelvas a autorizar con ese scope adicional.

Herramientas disponibles

list_domains

Lista todos los dominios monitorizados de tu organización.

Parámetro	Tipo	Obligatorio	Descripción
`page`	number	No	Número de página
`per_page`	number	No	Resultados por página

get_domain

Obtiene el detalle de un dominio concreto.

Parámetro	Tipo	Obligatorio	Descripción
`domain_id`	string	Sí	El UUID del dominio

list_reports

Lista los informes DMARC con filtros opcionales.

Parámetro	Tipo	Obligatorio	Descripción
`domain_id`	string	No	Filtrar por dominio
`date_from`	string	No	Fecha de inicio (ISO 8601)
`date_to`	string	No	Fecha de fin (ISO 8601)
`page`	number	No	Número de página

get_report

Obtiene un informe detallado con todos sus registros individuales y la geolocalización.

Parámetro	Tipo	Obligatorio	Descripción
`report_id`	string	Sí	El UUID del informe

get_report_statistics

Obtiene las estadísticas agregadas de un informe, agrupadas por país, ASN y resultado de autenticación.

Parámetro	Tipo	Obligatorio	Descripción
`report_id`	string	Sí	El UUID del informe

export_report_csv

Exporta los registros de un informe como archivo CSV.

Parámetro	Tipo	Obligatorio	Descripción
`report_id`	string	Sí	El UUID del informe

list_alerts

Lista las alertas de seguridad con filtros opcionales.

Parámetro	Tipo	Obligatorio	Descripción
`severity`	string	No	Filtro: `info`, `warning`, `critical`
`status`	string	No	Filtro: `pending`, `sent`, `dismissed`
`page`	number	No	Número de página

dismiss_alert

Descarta una alerta concreta.

Parámetro	Tipo	Obligatorio	Descripción
`alert_id`	string	Sí	El UUID de la alerta

Solución de problemas

"Authorization failed" o "401 Unauthorized"

Comprueba que completaste el flujo de autorización en el navegador
Prueba a eliminar el servidor MCP y añadirlo de nuevo en la configuración de tu cliente
Comprueba que tu cuenta de DMARC Examiner está activa

No aparecen las herramientas

Reinicia tu cliente de IA después de añadir la configuración del servidor MCP
Verifica que la URL es correcta: https://mcp.dmarc-examiner.com/mcp
Revisa los logs MCP de tu cliente para buscar errores de conexión

Error "Insufficient scope"

Aprobaste la conexión sin conceder todos los scopes. Vuelve a autorizar eliminando el servidor MCP y añadiéndolo de nuevo, o deja que tu asistente de IA te pida automáticamente aprobar el scope que falta.

Tiempo de espera de conexión agotado

Comprueba tu conexión a internet
Verifica que mcp.dmarc-examiner.com es accesible
Si estás detrás de un firewall corporativo, asegúrate de que se permite el tráfico HTTPS saliente al puerto 443

Revocar el acceso

Para desconectar tu asistente de IA de DMARC Examiner:

Elimina la entrada dmarc-examiner de la configuración de tu cliente MCP
Reinicia el cliente

Los tokens de acceso guardados en local dejan de usarse. Los tokens caducan automáticamente tras 30 días de inactividad.