Servidor MCP

El servidor MCP de ReallyQuickEmails expone tu proyecto mediante el Model Context Protocol. Conéctalo a claude.ai, Claude Desktop, Cursor o Claude Code y tu asistente podrá consultar tus contactos, campañas, métricas y automatizaciones respondiendo en lenguaje natural.

Tu asistente puede consultar datos, modificar contactos y segmentos, crear campañas en borrador (que tú revisas y envías desde la app), inscribir contactos en automatizaciones e incluso enviar correo — cada capacidad detrás de su propio permiso, que tú concedes al crear la clave. Crear automatizaciones completas por chat llega próximamente.

La conexión es segura por diseño:

El servidor no guarda credenciales de tu base de datos. Autentica cada llamada con tu clave MCP y la reenvía a la API; el proyecto se resuelve desde la clave, nunca desde lo que pida el asistente. Una clave de un proyecto no puede leer otro.
Cada clave lleva sus propios permisos. El asistente solo ve y solo puede usar las herramientas que sus permisos habilitan.
La revocas cuando quieras y el acceso se corta en la siguiente llamada.

Desde claude.ai (lo más rápido)

En claude.ai no necesitas crear ninguna clave a mano ni editar archivos de configuración:

Agregar el conector

Abre Configuración → Conectores → Agregar conector personalizado y pega la URL:

https://mcp.reallyquickemails.com/mcp

Autorizar

Claude te lleva a una pantalla de ReallyQuickEmails. Inicia sesión si no lo estabas, elige el proyecto que quieres conectar, marca si además de leer quieres permitir crear y editar, y pulsa Autorizar.Eso es todo: la app emite la clave por ti y el conector queda listo.

La clave que se emite aparece en Integraciones → API Keys → Claves MCP, con el nombre del cliente que conectaste. Para desconectar el conector, revócala ahí.

Por esta vía nunca se concede sends:execute (enviar correo real). Si quieres que tu asistente envíe por ti, crea la clave a mano con ese permiso y conéctalo por el método de abajo.

Con una clave (Claude Desktop, Cursor, Claude Code)

Los clientes que aceptan headers en su configuración usan tu clave MCP directamente.

Crear una clave MCP

Entra al dashboard y selecciona tu proyecto.
En el menú lateral abre Integraciones → API Keys.
Baja hasta la sección Claves MCP y pulsa Crear clave.
Ponle un nombre y marca los permisos que quieres conceder (ver Permisos). Concede solo los que el asistente necesite.
Copia la clave (rqe_mcp_...).

La clave completa se muestra una sola vez. Si la pierdes, revócala y crea una nueva. No la pegues en código del lado del cliente ni en repositorios.

Las claves del API REST (sk_proj_...) no funcionan en el MCP — devuelven 401. El MCP usa su propio tipo de clave (rqe_mcp_...), con permisos granulares, que se crea en esta misma sección.

Conectar tu cliente de IA

Usa el endpoint https://mcp.reallyquickemails.com/mcp con tu clave en el header X-API-Key.

Claude Desktop
Cursor
Claude Code

Abre Settings → Developer → Edit Config y agrega tu servidor. También puedes editar claude_desktop_config.json a mano:

{
  "mcpServers": {
    "reallyquickemails": {
      "url": "https://mcp.reallyquickemails.com/mcp",
      "headers": { "X-API-Key": "rqe_mcp_tu_clave" }
    }
  }
}

Reinicia Claude Desktop. El servidor aparece en el selector de herramientas.

Edita ~/.cursor/mcp.json (global) o .cursor/mcp.json (por proyecto):

{
  "mcpServers": {
    "reallyquickemails": {
      "url": "https://mcp.reallyquickemails.com/mcp",
      "headers": { "X-API-Key": "rqe_mcp_tu_clave" }
    }
  }
}

Actívalo en Settings → MCP.

Agrégalo con un comando:

claude mcp add reallyquickemails \
  --transport http \
  https://mcp.reallyquickemails.com/mcp \
  --header "X-API-Key: rqe_mcp_tu_clave"

Verifícalo con claude mcp list.

Verificar la conexión

Pídele a tu asistente algo simple, por ejemplo:

¿A qué proyecto de ReallyQuickEmails estoy conectado?

Llamará a la herramienta whoami y responderá con el nombre de tu proyecto y los permisos de la clave. Si en cambio ves un error de autorización, revisa que copiaste la clave completa y que no está revocada.

Para que veas todo lo que tu asistente puede hacer con esta clave —incluido lo que le falta y cómo habilitarlo— pídele que llame a get_capabilities (ver Capacidades y workflows guiados).

Permisos

Cada clave concede uno o más permisos. El asistente no ve las herramientas cuya autorización no le diste, y si intenta usarlas de todos modos, la llamada se rechaza.

Permiso	Habilita
`contacts:read`	Contactos, su actividad, eventos, remitentes, dominios y lista de supresión
`contacts:write`	Crear/actualizar contactos, tags, atributos, eventos y supresión
`campaigns:read`	Campañas y sus reportes de métricas
`campaigns:write`	Crear campañas en borrador (nunca las envía) y cancelar una que esté en curso o programada
`reports:read`	Métricas agregadas del proyecto en un rango de fechas
`segments:read`	Segmentos y sus reglas
`segments:write`	Crear segmentos
`templates:read`	Plantillas (metadatos, no el cuerpo del email)
`templates:write`	Crear y editar plantillas de email desde HTML
`automations:read`	Automatizaciones y sus reportes
`automations:write`	Inscribir contactos en automatizaciones activas, y pausarlas/reanudarlas
`sends:execute`	Enviar correo real (incluye copias de prueba). El permiso más sensible — concédelo solo si quieres que el asistente envíe por ti

Empieza con el mínimo. Si solo quieres que el asistente analice el desempeño de tus campañas, campaigns:read y reports:read bastan. Los permisos de escritura (:write) concédelos solo si quieres que el asistente modifique tus datos.

Los permisos de escritura modifican tus datos reales. Solo sends:execute envía correo directamente, pero ten presente que agregar un tag, registrar un evento o inscribir en una automatización activa puede resultar en un envío si tienes flujos configurados con esos triggers. Concédelos con intención.

Capacidades y workflows guiados

Cualquier clave válida puede llamar a get_capabilities (sin permiso, igual que whoami) y recibe el catálogo completo del servidor: todas las tools que existen —marcando cuáles están available para tu clave y, si no, cómo habilitarlas—, qué habilita cada permiso, los límites duros de la API (paginación, destinatarios máximos de send_email, ventana de idempotencia) y una serie de workflows guiados paso a paso para las tareas que de verdad se piden. Los mismos workflows están registrados como prompts MCP (prompts/list, prompts/get): un cliente que los soporta los ofrece directo, sin pasar por una tool.

Workflow	Qué guía
`launch_email_campaign`	Diseñar, probar y lanzar una campaña a una audiencia existente, con aprobación humana antes del envío
`import_design_and_send`	Convertir un HTML ya diseñado en una campaña enviada
`set_up_domain`	Autenticar un dominio de envío para que las campañas lleguen a la bandeja de entrada
`improve_deliverability`	Diagnosticar por qué la entrega, las aperturas o los clics están bajos, y arreglar lo que se puede desde el chat
`automate`	Auditar una automatización, inscribir un contacto en ella, o resolver por qué no disparó
`report_issue`	Escalar un flujo roto a un humano con el contexto necesario para actuar

Ante una tarea que no conoces bien, pide a tu asistente que llame a get_capabilities antes que whoami — sale más barato que descubrir un límite por prueba y error.

Herramientas disponibles

Todas las herramientas de escritura aceptan idempotency_key (opcional, en el body o en el header Idempotency-Key): la misma clave con el mismo cuerpo, dentro de 24 horas, repite la respuesta original sin ejecutar nada de nuevo. La misma clave con un cuerpo distinto responde 409 IDEMPOTENCY_CONFLICT — un UUID nuevo por cada acción real basta.

Los resultados de escritura y las lecturas de una entidad puntual (una campaña, plantilla, segmento o automatización) incluyen view_in_app: el link directo a esa pantalla en la app.

Contactos — contacts:read

Herramienta	Qué hace
`list_contacts`	Lista contactos con búsqueda por email o nombre
`get_contact`	Un contacto por su UUID, con sus datos y segmentos
`get_contact_activity`	Qué le pasó a un contacto: emails recibidos y eventos
`list_events`	Eventos personalizados registrados en el proyecto
`get_suppression_list`	Direcciones suprimidas que no recibirán email
`list_senders`	Remitentes verificados del proyecto
`list_domains`	Dominios de envío y su estado de autenticación

Campañas — campaigns:read

Herramienta	Qué hace
`list_campaigns`	Campañas con su estado y contadores
`get_campaign_report`	Métricas de una campaña: enviados, entregados, aperturas, clics, rebotes

Métricas, segmentos, plantillas y automatizaciones

Herramienta	Permiso	Qué hace
`get_metrics`	`reports:read`	Métricas agregadas del proyecto en un rango
`list_segments`	`segments:read`	Segmentos con su tamaño y su regla
`list_templates`	`templates:read`	Plantillas del proyecto (metadatos)
`get_template`	`templates:read`	Una plantilla CON su contenido: HTML final y fuente editable — para verificar asunto, preheader, links y cuerpo contra la base
`list_automations`	`automations:read`	Automatizaciones con su estado y su disparador real
`get_automation`	`automations:read`	Una automatización CON su grafo de nodos y conexiones — para auditar un flujo antes de activarlo
`get_automation_report`	`automations:read`	Desempeño de una automatización: enviados, abiertos, clics
`get_automation_runs`	`automations:read`	Los runs de una automatización: para quién disparó, cuándo y en qué terminó

Diagnóstico — integrations:read

Para responder “¿por qué no disparó mi flujo?” sin esperar a soporte.

Herramienta	Qué hace
`get_shopify_integration_status`	Salud de la integración Shopify: webhooks suscritos vs esperados, eventos recibidos, entregas rechazadas
`list_checkout_events`	Checkouts de Shopify que llegaron a la plataforma, con su estado de procesamiento
`diagnose_automation`	Camina la cadena completa del carrito abandonado y nombra el primer eslabón roto

Escritura — contacts:write / segments:write / templates:write / campaigns:write / automations:write

Modifican datos reales. Ninguna de estas envía correo directamente, pero las marcadas pueden disparar automatizaciones activas que sí envíen.

Herramienta	Permiso	Qué hace
`upsert_contacts`	`contacts:write`	Crea o actualiza hasta 1000 contactos por email, con atributos y segmentos. Puede disparar flujos de contacto nuevo
`add_tags`	`contacts:write`	Agrega tags a un contacto existente (unión, sin duplicados). Puede disparar flujos por tag
`set_attributes`	`contacts:write`	Agrega o actualiza atributos de un contacto existente (los demás se conservan)
`track_event`	`contacts:write`	Registra un evento personalizado (compra, registro…). Puede disparar flujos por evento
`suppress_email`	`contacts:write`	Agrega direcciones a la lista de supresión (dejan de recibir correo)
`create_segment`	`segments:write`	Crea un segmento vacío; se llena después desde la app
`create_template`	`templates:write`	Crea una plantilla de email desde HTML y devuelve el link para abrirla en el editor. Las imágenes deben ser URLs públicas
`update_template`	`templates:write`	Edita una plantilla existente conservando su id — cualquier campaña que ya la use sale con el contenido nuevo. Se puede cambiar HTML, asunto y/o nombre
`generate_template`	`templates:write`	El motor de diseño escribe un email completo a partir de un brief, con la identidad de marca del proyecto, y lo guarda como plantilla. Tarda entre 30 y 90 segundos y consume el tope diario de IA del proyecto
`edit_template_with_ai`	`templates:write`	Reescribe una plantilla existente siguiendo una instrucción en lenguaje natural, conservando su id. Solo para plantillas con diseño editable (las importadas como HTML crudo usan `update_template`)
`create_campaign`	`campaigns:write`	Crea una campaña siempre en borrador — tú la revisas, completas y envías desde la app
`cancel_campaign`	`campaigns:write`	Frena una campaña en curso o programada antes de que termine de enviar. No dispara nada — solo detiene
`enroll_in_automation`	`automations:write`	Inscribe un contacto en una automatización activa — el flujo corre de inmediato y puede enviarle correo
`pause_automation`	`automations:write`	Pausa una automatización activa: deja de inscribir contactos nuevos; las corridas ya en curso terminan sus pasos
`resume_automation`	`automations:write`	Reactiva una automatización pausada

Envío — sends:execute

Herramienta	Qué hace
`send_email`	Envía un correo real de inmediato (hasta 50 destinatarios), desde un remitente verificado del proyecto
`send_campaign_test`	Envía una copia de prueba real de una campaña a una sola dirección — mismo asunto, plantilla y remitente que usará el envío real, sin contar en la audiencia ni en las métricas de la campaña. Recomendado antes de `send_campaign`
`send_campaign`	Lanza una campaña en borrador a toda su audiencia, ahora o en una fecha futura, en dos pasos: la primera llamada no envía nada y devuelve un resumen (asunto, remitente, plantilla y cuántos contactos recibirán el correo, o qué falta por completar); solo con `confirm: true`, después de que apruebes ese resumen, la envía por el mismo camino que la app. Con `scheduled_at` (ISO 8601, hasta 90 días a futuro) programa el envío en vez de lanzarlo ya — se puede frenar con `cancel_campaign` mientras no haya llegado la hora

Todas soportan idempotency_key: la misma clave dentro de 24 h devuelve el resultado anterior en vez de enviar de nuevo.

send_email, send_campaign_test y send_campaign (con confirm: true) envían correo real y no se pueden deshacer una vez entregado. Una campaña programada con scheduled_at sí se puede frenar con cancel_campaign mientras no llegue su hora. Concede sends:execute solo a claves cuyo asistente deba enviar por ti, y revócala si dejas de necesitarlo.

Identidad y utilidades — sin permiso

Herramienta	Qué hace
`whoami`	El proyecto al que pertenece la clave y sus permisos. Cualquier clave válida puede llamarla
`get_capabilities`	El catálogo completo del servidor: tools, permisos, límites y workflows guiados
`get_usage`	El cupo de envío del proyecto: plan, límite, usado, restante y si el envío está bloqueado (y por qué)
`send_flare`	Reporta un flujo roto a un humano: el objetivo del usuario, qué pasó y la cadena de llamadas que llevó ahí. Devuelve un `flare_id`

Errores

Toda respuesta que no sea 2xx trae la misma forma:

{
  "code": "CAMPAIGN_INCOMPLETE",
  "error": "Campaign is not ready for a test send. Missing: template_id.",
  "suggestion": "Fix everything listed in `missing` and call send_campaign_test again.",
  "request_id": "3f2a1c9e-7b44-4e21-9a2f-6c1d0a8b5e77"
}

code es estable: sirve para decidir el siguiente paso sin parsear texto.
suggestion es el remedio concreto (en inglés, como el resto de la superficie MCP) — con eso tu asistente puede resolverlo en la misma vuelta, sin que tengas que intervenir.
request_id identifica esa llamada y viaja también en el header X-Request-Id de toda respuesta, éxito o error. Pásalo si necesitas soporte.

Código	Cuándo aparece
`INVALID_INPUT`	Un campo no pasa la validación — revisa `suggestion` (y `param`, si viene) para saber cuál
`NOT_FOUND`	El id no existe en tu proyecto
`FORBIDDEN`	La clave no tiene el permiso que esa herramienta necesita
`UNAUTHORIZED`	La clave no es válida o fue revocada
`RATE_LIMITED`	Demasiadas llamadas seguidas — reintenta en unos segundos
`QUOTA_EXCEEDED`	El proyecto llegó al límite de su plan para el período — revisa `get_usage`
`IDEMPOTENCY_CONFLICT`	La misma `idempotency_key` ya se usó con un cuerpo distinto
`CONFLICT`	El recurso no está en un estado que permita la operación
`CAMPAIGN_NOT_CANCELLABLE`	La campaña ya no se puede frenar (por ejemplo, ya terminó de enviar)
`CAMPAIGN_INCOMPLETE`	Falta algo (plantilla, remitente, asunto) para enviar o probar la campaña
`AUTOMATION_STATE`	La automatización ya está en el estado pedido (pausarla si ya está pausada, y viceversa)
`PROJECT_DISABLED`	El proyecto no puede operar ahora mismo — contacta soporte
`AI_QUOTA_EXCEEDED`	El proyecto agotó sus generaciones por IA de hoy (se reinicia a las 00:00 UTC) — escribe el HTML con `create_template` o `update_template`, o reintenta mañana
`INTERNAL_ERROR`	Algo falló de nuestro lado — reintenta, y si persiste repórtalo con `send_flare` incluyendo el `request_id`

Modo partner (gestiona tu cartera de clientes)

Si eres un partner que administra varios clientes (cada uno un proyecto RQE), puedes conectar el MCP con tu partner-key (sk_partner_...) en vez de una key de proyecto. En ese modo, una sola conexión opera a nivel organización y expone 3 herramientas para gestionar tu cartera:

Herramienta	Qué hace
`list_clients`	Lista tus proyectos-cliente (id, nombre, slug, estado).
`create_client`	Crea un proyecto-cliente nuevo y devuelve su `api_key` (`sk_proj_`) para operarlo.
`get_client_stats`	Métricas 30 días (envíos, entregas, aperturas, clics) de un cliente.

{
  "mcpServers": {
    "reallyquickemails-partner": {
      "url": "https://mcp.reallyquickemails.com/mcp",
      "headers": { "Authorization": "Bearer sk_partner_xxxxxxxxxxxx" }
    }
  }
}

El modo partner opera por organización: list_clients/get_client_stats solo ven proyectos de tu org, y create_client los crea dentro de ella. Para operar un cliente en detalle (enviar, contactos, campañas), usa su api_key de proyecto con el MCP normal. Detalle de los endpoints en Partner / Provisioning.

Revocar una clave

En Integraciones → API Keys → Claves MCP, pulsa Revocar en la clave. El acceso se corta en la siguiente llamada; el asistente que la use recibirá un error de autorización. La clave revocada queda listada para tu registro, sin poder reactivarse.

Preguntas frecuentes

¿En qué se diferencia de mi API Key normal?

Tu API Key (sk_...) da acceso completo a la API, incluido el envío de correo, y está pensada para tu propio backend. La clave MCP (rqe_mcp_...) tiene permisos granulares y está pensada para conectar un asistente de IA de terceros con exactamente el acceso que decidas. Nunca pegues tu sk_... en un cliente de IA.

¿El asistente puede enviar correos o borrar datos?

Puede enviar correo solo si le concediste sends:execute — sin ese permiso, ni siquiera ve las herramientas de envío. Las campañas que crea nacen siempre en borrador; las envías tú desde la app o, si concediste sends:execute, con send_campaign (que primero te muestra el resumen, se puede programar con scheduled_at, y espera tu aprobación) — send_campaign_test manda una copia de prueba antes de lanzarla, y cancel_campaign frena una que ya está en curso o programada. No borra contactos ni datos: no existen herramientas de borrado. Cada capacidad es un permiso separado que concedes explícitamente al crear la clave.

¿Puede crear automatizaciones (flujos) completas?

Todavía no — llega próximamente. Hoy puede inscribir contactos en automatizaciones que ya construiste (con automations:write), pausarlas y reanudarlas, y consultar su desempeño, pero el diseño del flujo (nodos, triggers, condiciones) se hace desde la app.

¿Qué pasa si mi asistente se traba o algo no funciona?

Puede llamar a send_flare (sin permiso, cualquier clave) para reportarlo con contexto completo: qué querías hacer, qué pasó y la cadena de llamadas que llevó ahí. Te devuelve un flare_id — pásaselo a soporte si necesitas seguimiento.

¿Puedo tener varias claves?

Sí. Es buena práctica una clave por cliente o por uso, cada una con el mínimo de permisos, para poder revocar una sin afectar al resto.

¿Por qué claude.ai no me deja pegar la clave?

Porque no la necesita. Los conectores de claude.ai no tienen campo para headers: se conectan por OAuth, así que en vez de pedirte una clave te llevan a una pantalla de ReallyQuickEmails donde eliges proyecto y permisos, y la app emite la clave por ti. Es el mismo tipo de clave (rqe_mcp_...) y la ves y revocas en el mismo lugar.

Guías

La app

Conceptos

API Reference

Desde claude.ai (lo más rápido)

Con una clave (Claude Desktop, Cursor, Claude Code)

Permisos

Capacidades y workflows guiados

Herramientas disponibles

Errores

Modo partner (gestiona tu cartera de clientes)

Revocar una clave

Preguntas frecuentes

​Desde claude.ai (lo más rápido)

​Con una clave (Claude Desktop, Cursor, Claude Code)

​Permisos

​Capacidades y workflows guiados

​Herramientas disponibles

​Errores

​Modo partner (gestiona tu cartera de clientes)

​Revocar una clave

​Preguntas frecuentes

Desde claude.ai (lo más rápido)

Con una clave (Claude Desktop, Cursor, Claude Code)

Permisos

Capacidades y workflows guiados

Herramientas disponibles

Errores

Modo partner (gestiona tu cartera de clientes)

Revocar una clave

Preguntas frecuentes