MCP server

La forma más rápida es la configuración con un solo prompt: tu agente se conecta solo y tú inicias sesión una vez en el navegador. Si aún no tienes una cuenta, puedes crearla en esa misma página y volver directamente a autorizarlo. Para configurarlo tú mismo, o con una clave de API, sigue los pasos para tu herramienta a continuación.

El MCP server está en https://api.proxymail.qa/mcp (Streamable HTTP). Envía la clave como token Bearer.

Claude Code

claude mcp add --transport http proxymail-qa https://api.proxymail.qa/mcp --header "Authorization: Bearer $PROXYMAIL_QA_API_KEY"

Cursor

La forma más rápida es Add to Cursor en la página del directorio de Cursor de Proxy Mail QA, que instala el servidor y una skill; luego inicia sesión en él desde la sección MCP de la configuración de Cursor. Para usar una clave de API en su lugar, en .cursor/mcp.json:

{
  "mcpServers": {
    "proxymail-qa": {
      "url": "https://api.proxymail.qa/mcp",
      "headers": { "Authorization": "Bearer qa_…" }
    }
  }
}

GitHub Copilot en VS Code

En .vscode/mcp.json, o en tu mcp.json de usuario. VS Code pide la clave la primera vez y la guarda de forma segura, así que nunca queda en el archivo:

{
  "inputs": [{ "id": "proxymail-qa-key", "type": "promptString", "description": "Proxy Mail QA API key", "password": true }],
  "servers": {
    "proxymail-qa": {
      "type": "http",
      "url": "https://api.proxymail.qa/mcp",
      "headers": { "Authorization": "Bearer ${input:proxymail-qa-key}" }
    }
  }
}

Agente en la nube de Copilot

En GitHub.com, guarda la clave como un secreto de Agents llamado COPILOT_MCP_PROXYMAIL_QA_KEY y luego, en el Settings → Copilot → MCP servers del repositorio:

{
  "mcpServers": {
    "proxymail-qa": {
      "type": "http",
      "url": "https://api.proxymail.qa/mcp",
      "headers": { "Authorization": "Bearer $COPILOT_MCP_PROXYMAIL_QA_KEY" },
      "tools": ["create_address", "wait_for_code", "wait_for_link", "check_delivery", "list_addresses", "update_address"]
    }
  }
}

El agente en la nube ejecuta las herramientas listadas sin preguntar, así que esta lista omite delete_address.

Google Antigravity

En el panel del agente, abre … → MCP Servers → Manage MCP Servers → View raw config, agrega el servidor y luego reinicia Antigravity. Antigravity usa serverUrl para servidores remotos. Sin headers, inicia sesión en el navegador la primera vez que se conecta; con ellos, usa la clave:

{
  "mcpServers": {
    "proxymail-qa": {
      "serverUrl": "https://api.proxymail.qa/mcp",
      "headers": { "Authorization": "Bearer qa_…" }
    }
  }
}

OpenAI Codex

Para iniciar sesión en el navegador, sin clave, ejecuta codex mcp add proxymail-qa --url https://api.proxymail.qa/mcp: Codex abre la página de inicio de sesión (o ejecuta codex mcp login proxymail-qa). Para usar una clave, Codex la lee de tu entorno:

codex mcp add proxymail-qa --url https://api.proxymail.qa/mcp --bearer-token-env-var PROXYMAIL_QA_API_KEY

Android Studio y Xcode

Gemini en Android Studio (modo agente) admite servidores MCP remotos. Agrega el servidor a su configuración de MCP como httpUrl y luego inicia sesión cuando te lo pida:

{
  "mcpServers": {
    "proxymail-qa": { "httpUrl": "https://api.proxymail.qa/mcp" }
  }
}

Xcode: Claude Code y Codex pueden usar las herramientas propias de Xcode (xcrun mcpbridge) junto con Proxy Mail QA, y Claude Code Desktop puede ejecutar tu app en su panel iOS Simulator y registrarse en ella. Los agentes integrados de Xcode también pueden agregar servidores MCP y plug-ins. Todo está en iOS apps con un agente de programación; para pruebas de UI, consulta Apps móviles.

Windsurf

En el panel Cascade, abre … → MCPs → Open MCP config file y agrega el servidor. Windsurf usa serverUrl para servidores remotos e inicia sesión en el navegador la primera vez que se conecta:

{
  "mcpServers": {
    "proxymail-qa": { "serverUrl": "https://api.proxymail.qa/mcp" }
  }
}

Para usar una clave de API en su lugar, agrega "headers": { "Authorization": "Bearer ${env:PROXYMAIL_QA_API_KEY}" }, que lee la clave de tu entorno.

Zed

Abre Settings → AI → MCP Servers → Add Server → Add Remote Server o agrégalo a tu archivo de configuración. Sin el encabezado Authorization, Zed te pide iniciar sesión en el navegador:

{
  "context_servers": {
    "proxymail-qa": { "url": "https://api.proxymail.qa/mcp" }
  }
}

Kiro

Agrega el servidor a .kiro/settings/mcp.json en tu proyecto, o a ~/.kiro/settings/mcp.json para todos los proyectos. Kiro inicia sesión en el navegador cuando se conecta por primera vez:

{
  "mcpServers": {
    "proxymail-qa": { "url": "https://api.proxymail.qa/mcp" }
  }
}

Para usar una clave de API en su lugar, agrega "headers": { "Authorization": "Bearer ${PROXYMAIL_QA_API_KEY}" }.

Amazon Q Developer

En los IDE de VS Code y JetBrains: abre el panel de chat de Amazon Q, elige el icono de herramientas y luego +. Elige el alcance: global, guardado en ~/.aws/amazonq/default.json, o local, guardado en .amazonq/default.json en el espacio de trabajo. Nombra el servidor proxymail-qa, elige el transporte http, indica la URL https://api.proxymail.qa/mcp y elige Save. Amazon Q abre tu navegador para iniciar sesión cuando se conecta por primera vez. Para usar una clave de API en su lugar, agrega un encabezado llamado Authorization con el valor Bearer qa_…, con alcance global para que la clave quede fuera de tu repositorio.

AWS deja de dar soporte a los plugins de IDE de Amazon Q Developer el 30 de abril de 2027 y recomienda Kiro.

En la línea de comandos: la CLI de Amazon Q Developer ahora es la CLI de Kiro, que lee ~/.kiro/settings/mcp.json, así que sigue los pasos de Kiro de arriba.

OpenCode

Agrega el servidor a opencode.json en tu proyecto, o a ~/.config/opencode/opencode.json para todos los proyectos. OpenCode inicia sesión en el navegador la primera vez que el servidor lo pide, o ejecuta opencode mcp auth proxymail-qa:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "proxymail-qa": { "type": "remote", "url": "https://api.proxymail.qa/mcp" }
  }
}

Para usar una clave de API en su lugar, agrega "oauth": false y "headers": { "Authorization": "Bearer {env:PROXYMAIL_QA_API_KEY}" }, que lee la clave de tu entorno.

Kilo Code

Agrega el servidor a kilo.jsonc en tu proyecto, o a ~/.config/kilo/kilo.jsonc para todos los proyectos. Kilo Code inicia sesión en el navegador cuando se conecta:

{
  "mcp": {
    "proxymail-qa": { "type": "remote", "url": "https://api.proxymail.qa/mcp" }
  }
}

Para usar una clave de API en su lugar, agrega "oauth": false y "headers": { "Authorization": "Bearer qa_…" }, en el archivo para todos los proyectos, para que la clave quede fuera de tu repositorio.

Roo Code

En el panel Roo Code, haz clic en el icono MCP y luego en Edit Global MCP al final de la lista. Roo Code envía una clave de API en un encabezado. Edit Project MCP escribe .roo/mcp.json en el proyecto, así que deja la clave fuera si haces commit de ese archivo:

{
  "mcpServers": {
    "proxymail-qa": {
      "type": "streamable-http",
      "url": "https://api.proxymail.qa/mcp",
      "headers": { "Authorization": "Bearer qa_…" }
    }
  }
}

Augment Code

En el panel de Augment, abre el menú de opciones → Settings y, en MCP, haz clic en + Add remote MCP. Elige el tipo de conexión HTTP, nómbralo proxymail-qa, indica la dirección https://api.proxymail.qa/mcp e inicia sesión en el navegador cuando te lo pida.

Trae

Abre Settings → MCP, luego Add → Create Manually, y pega el servidor. Trae envía una clave de API en un encabezado. Los servidores propios de un proyecto van en .trae/mcp.json cuando Enable Project MCP está activado, así que deja la clave fuera de ese archivo si haces commit:

{
  "mcpServers": {
    "proxymail-qa": {
      "url": "https://api.proxymail.qa/mcp",
      "headers": { "Authorization": "Bearer qa_…" }
    }
  }
}

Qoder

Conéctalo desde Qoder Marketplace: abre Proxy Mail QA en la pestaña Connectors (en el sitio global o el sitio de China), conéctalo, luego inicia sesión en Proxy Mail QA en tu navegador y elige el proyecto que puede usar el agente. El plugin de Qoder agrega ocho skills más. Para agregar el servidor a mano, abre Qoder IDE Settings → MCP, elige + Add en la pestaña My Servers y agrégalo en mcpServers con "type": "http" y la dirección https://api.proxymail.qa/mcp. Los prompts y una regla para el agente están en la guía de Qoder.

Mistral Vibe

Vibe agrega el servidor a tu config.toml y abre tu navegador para iniciar sesión:

vibe mcp add proxymail-qa --url https://api.proxymail.qa/mcp

Para usar una clave de API en su lugar, agrega --api-key-env PROXYMAIL_QA_API_KEY, que lee la clave de tu entorno y la envía como token Bearer.

Qwen Code

Agrega el servidor para todos los proyectos, luego abre /mcp en Qwen Code e inicia sesión en el navegador:

qwen mcp add --transport http --scope user proxymail-qa https://api.proxymail.qa/mcp

Para usar una clave de API en su lugar, agrega --header "Authorization: Bearer $PROXYMAIL_QA_API_KEY".

Kimi CLI

Agrega el servidor con inicio de sesión en el navegador y luego inicia sesión una vez:

kimi mcp add --transport http --auth oauth proxymail-qa https://api.proxymail.qa/mcp
kimi mcp auth proxymail-qa

Para usar una clave de API en su lugar, omite --auth oauth y agrega --header "Authorization: Bearer $PROXYMAIL_QA_API_KEY".

Otros clientes

Cualquier cliente que se conecte a servidores MCP remotos por Streamable HTTP funciona igual: dale https://api.proxymail.qa/mcp e inicia sesión en el navegador cuando te lo pida, o envía una clave de API como Authorization: Bearer qa_… si no puede iniciar sesión. En los IDE de JetBrains, AI Assistant agrega uno en Settings → Tools → AI Assistant → Model Context Protocol (MCP) → Add, como servidor HTTP con esa dirección.

Claude y ChatGPT

Claude (claude.ai y las apps de Claude) y ChatGPT inician sesión en el navegador, sin clave que copiar. En ChatGPT y en Codex, instálalo desde la página de Proxy Mail QA en el directorio de plugins de ChatGPT. En Claude, agrega un conector personalizado con la dirección https://api.proxymail.qa/mcp en Settings → Connectors → Add custom connector. En cualquier caso, te enviaremos a Proxy Mail QA para iniciar sesión (o crear una cuenta allí), elegir el proyecto que puede usar (o nombrar uno primero) y darle permiso.

En un chat, el registro lo haces tú: pide una dirección de prueba (“Dame un email de prueba para el registro de staging y dime el código cuando llegue”), regístrate con ella y el asistente te da el código o enlace cuando llegue. También puede decirte por qué no llega un email, o revisar uno que sí llegó.

Una nueva dirección de prueba viene con una tarjeta de bandeja de entrada en la conversación: la dirección y su persona con botones Copiar (la contraseña solo como Copiar contraseña), y luego el código o enlace en cuanto llega, con las comprobaciones del email. La tarjeta espera el correo por sí sola durante 10 minutos y le dice al asistente qué llegó, así que no necesitas volver a preguntar. Si te conectaste antes de que existiera la tarjeta, vuelve a conectar el conector en Claude, o actualízalo en ChatGPT, para verla. Las herramientas que no muestran tarjetas reciben las mismas respuestas en texto.

Una app conectada recibe un token para ese único proyecto: puede crear y eliminar direcciones de prueba, darle a una nueva una contraseña para un formulario de registro y leer sus códigos y enlaces, pero no contraseñas guardadas antes. Aparece en Project settings → API keys como app conectada; desconéctala allí cuando quieras. Otros clientes MCP que admiten inicio de sesión con OAuth funcionan igual.

Busca en la documentación sin cuenta

Cualquier agente puede buscar en esta documentación y guías, sin iniciar sesión, en https://search.proxymail.qa/mcp. Tiene una herramienta, search, que devuelve los fragmentos que coinciden con una pregunta junto con las direcciones de sus páginas. Las conexiones con sesión iniciada tienen la misma búsqueda que search_docs.

claude mcp add --transport http proxymail-qa-docs https://search.proxymail.qa/mcp

Las personas pueden hacer preguntas a la documentación en proxymail.qa/ask.

Herramientas

Herramienta	Qué hace
get_project	El proyecto en el que trabaja: dominio de correo predeterminado y los demás, prefijo de email, límites
create_address	Una nueva dirección de prueba, con un nombre ficticio y nombre de usuario para formularios de registro, una fecha de nacimiento para una age (como under13), un country (como GB) y una contraseña si se pide (password: true). site y environment registran dónde se usa, como hace la extensión Chrome, y aparecen en la cuenta en la app
form_values	Para un formulario que pide algo más que el email: dale lo que dice la página sobre cada campo y obtén qué escribir o elegir en cada uno, a partir de una nueva dirección creada para él (un nombre de usuario y contraseña que cumplen las reglas, la fecha de nacimiento en el formato del campo, un país que ofrece la lista). El agente rellena el formulario
wait_for_code	Espera hasta 30 segundos un código de verificación o de inicio de sesión y lo devuelve. unused: true omite un código ya usado; kind: coupon espera un cupón o código promocional, con su descuento y fecha de validez, y after_seconds indica cuánto tiempo después de since llegó
wait_for_link	Lo mismo para un enlace de verificación, inicio de sesión mágico, invitación o restablecimiento de contraseña. app: true pide el enlace que abre una app móvil (myapp://…) cuando el email también tiene uno web; kind: unsubscribe (o list_unsubscribe) da un enlace para cancelar la suscripción que usará el agente, que Proxy Mail QA nunca abre
get_address_variants	Versiones inusuales de una dirección para probar formularios de registro: algunas cuyo correo sí llega (mayúsculas, etiquetas con + y caracteres especiales), válidas que los servidores de correo rechazan, e inválidas (más)
search_docs	Busca en esta documentación y guías cómo hacer algo (query, limit), como configurar un framework de pruebas o por qué no llegó un email, y devuelve los fragmentos que mejor coinciden con las direcciones de sus páginas
get_name_variants	Nombres difíciles para el campo de nombre de un formulario (field, max_length): algunos para aceptar (apóstrofos, acentos, otros alfabetos, una letra, exactamente el máximo), otros para rechazar, HTML o SQL para guardar como texto, y otros en los que las apps difieren (más)
get_password_variants	Contraseñas difíciles dentro de las reglas del campo (min_length, max_length, symbols): el mínimo y el máximo, cada clase de símbolo, espacios, caracteres no ASCII y otras en las que las apps difieren; nuevas en cada llamada (más)
check_delivery	Explica el correo de una dirección sin esperar: qué llegó, lo que rechazamos o lo que los servidores de correo de Cloudflare no aceptaron (por ejemplo, por fallar DMARC) y la causa probable si no llegó nada
list_addresses	Las direcciones del proyecto, cada una con su persona, etiquetas y código o enlace más reciente. Los filtros encuentran una cuenta de prueba creada antes: tags, country, min_age y max_age, has_password, search, site y environment
update_address	Su nombre, apellido, nombre de usuario, fecha de nacimiento o país, si la app los cambió, y notas, etiquetas o una etiqueta de nombre: para qué era la cuenta de prueba
set_password	Guarda la contraseña que usa ahora la cuenta de prueba, después de que la app la cambió o restableció; omítela para generar una
delete_address	Elimina una dirección y su correo
get_saved_password	Solo para claves con permiso para leer contraseñas guardadas
get_sign_in	Vuelve a iniciar sesión como una cuenta de prueba guardada en una sola llamada: la cuenta para este site (con cualquier tags y environment indicados) y su contraseña, tal como la elige la lista de inicio de sesión de la extensión. Solo para claves con permiso para leer contraseñas guardadas
mark_dev_host	Marca un host como localhost:3000 como entorno de desarrollo del proyecto, para que check_email acepte los enlaces a él en lugar de marcarlos como fallidos
update_project	Cambia el nombre, sitio web, entornos, prefijo de email o dominio de correo predeterminado del proyecto, como en la configuración del proyecto. Requiere al responsable del proyecto, o a un propietario o administrador de la organización, y cada cambio queda en el registro de actividad. Archivar y eliminar siguen en la app
check_email	Revisa un email que llegó: SPF, DKIM y DMARC, enlaces a localhost o a http sin cifrar, adónde lleva su enlace (expect_host), una caducidad indicada, cuándo termina un cupón, una parte en texto plano, su tamaño, frases dadas (expect_text), su idioma (expect_language), cuánto tardó en llegar después de since (expect_within) y sus adjuntos (expect_attachment); en un email de marketing, sus encabezados List-Unsubscribe, enlace para cancelar la suscripción y texto de vista previa; en todos los emails, adjuntos que las bandejas de entrada bloquean o desconfían (harmful_attachment) y una estimación de si llega a spam (spam_risk). Las comprobaciones de marketing, harmful_attachment y spam_risk están en Labs. Solo veredictos, nunca el email
count_emails	Cuántos emails llegaron (since, type, subtype, category: autenticación, transaccional o marketing), cada uno resumido sin su contenido: para “exactamente un email de verificación”
expect_no_email	Vigila hasta 30 segundos y pasa si no llega nada: para “un usuario dado de baja no recibe nada”, con category: marketing para que los recibos sigan llegando. until mantiene una ventana abierta hasta una hora entre llamadas
mark_unsubscribed	Labs. Registra que la dirección canceló la suscripción a un remitente, después de que el agente lo hizo en su propio navegador: cualquier email de marketing posterior de ese remitente falla after_unsubscribe, sin importar cuánto tiempo después. grace (2h, 1d) deja pasar el correo que ya estaba en camino
mark_resubscribed	Labs. Registra que la dirección se volvió a suscribir, lo que termina la vigilancia
record_consent	Labs. Registra lo que la cuenta aceptó en el registro (marketing, una casilla premarcada, doble opt-in), para que check_email juzgue su marketing según las reglas del lugar donde vive la persona
record_coupon_result	Labs. Registra qué hizo el checkout con un cupón que aplicó el agente (en staging con pagos de prueba): aceptado, rechazado o un error, con el mensaje de la app, y da el veredicto de coupon_result
check_sequence	Labs. Si una serie de bienvenida o campaña por goteo llegó en orden y a tiempo después del registro: pasa, temprano, tarde, falta o esperando para cada email
check_offers	Labs. Los cupones de cada remitente y a qué versión de la dirección (normal, mayúsculas, +tag) fue cada uno; falla la ejecución cuando una persona recibió una oferta dos veces
check_unsubscribe	Labs. Cada baja de suscripción y los emails de marketing que llegaron después, por id y cuánto tiempo después; falla la ejecución si llegó alguno
check_out_account, extend_checkout, return_account	Toma prestada una cuenta de prueba en un estado conocido (por tags, country, edad o una contraseña guardada) que ninguna otra prueba tenga, y devuélvela, registrando qué cambió (más)
start_run, add_run_note, finish_run	Registra una sesión como ejecución: pasa run_id (y test, el paso al que pertenece) a las herramientas y finish_run devuelve el informe en Markdown, para la persona o un pull request, incluido cuántos emails revisados probablemente llegarían a spam (con las comprobaciones de Spam score y adjuntos activadas en Labs) (más)

Las herramientas marcadas con Labs forman parte de Emails de marketing y ofertas, una función de Labs: la persona que conectó el agente la activa en la app en Account settings → Labs. Hasta entonces no se muestran al agente (y, si se llaman, responden con un error que lo indica), y check_email omite las comprobaciones de las funciones de Labs que están desactivadas.

La lista se ajusta al proyecto. Un agente solo ve las herramientas y prompts que puede usar allí, así que tiene menos entre los que elegir:

• las herramientas de cupones (record_coupon_result, check_offers) y sus prompts aparecen cuando el proyecto prueba Ofertas;
• las herramientas de baja, consentimiento y secuencias (mark_unsubscribed, mark_resubscribed, check_unsubscribe, record_consent, check_sequence) y sus prompts, cuando prueba Marketing;
• ambas necesitan activar Marketing y correos de ofertas en Labs, hasta que esté disponible para todos; después aparecen en cada proyecto que prueba esas áreas.

Elige qué prueba un proyecto en Project settings → What you test. Las instrucciones del agente dicen qué está oculto y cómo mostrarlo, y get_project devuelve el areas del proyecto. Un cliente ve el cambio la próxima vez que se conecta.

Prompts

Listas de verificación listas para usar que el agente sigue con estas herramientas y sus propias herramientas de navegador. Las pruebas terminan en el informe de una ejecución. Elige una donde tu cliente lista los prompts de MCP (en Claude Code, escribe / y busca proxymail-qa):

Prompt	Qué hace
test_signup_flow	Se registra en la página que indiques con una dirección nueva, completa la verificación, revisa el correo y cuenta los duplicados
test_password_reset	Toma prestada una cuenta verificada, restablece su contraseña desde la app, revisa el correo de restablecimiento, guarda la nueva contraseña y devuelve la cuenta
test_sign_in_code	Toma prestada una cuenta verificada e inicia sesión con el código o enlace mágico que la app envía por correo
prepare_account	Toma prestada una cuenta con las etiquetas que indiques, confirma en la app que está en el estado que necesita la prueba (“en el plan premium, sin pedidos”), crea una nueva en la página de registro que indiques si no hay ninguna libre y la devuelve después de la prueba
auth_regression_pack	Los mismos pasos cada vez para registro, restablecimiento de contraseña e invitaciones, incluidos enlaces reutilizados y reemplazados, con cada paso nombrado en la ejecución; el informe dice qué cambió desde las últimas ejecuciones del paquete. También es una skill de agente
audit_auth_emails	Activa cada correo de cuenta que envía la app (verificación, restablecimiento, inicio de sesión, cambio de correo), revisa cada uno y lista lo que hay que corregir
audit_marketing_consent	Labs. Para cada país indicado, registra cuentas que rechazan, aceptan y dejan una casilla premarcada, registra cada una, activa el marketing e informa qué correos incumplen las reglas, con fuentes
test_coupon_checkout	Labs. Se registra en una oferta, aplica el cupón en el pago en staging con pagos de prueba, registra lo que pasó, lo vuelve a intentar e informa cada intento
test_offer_reuse	Labs. Se registra en una oferta de bienvenida o de un solo uso con una dirección y variantes que llegan a la misma bandeja de entrada, e informa si la app dio la oferta más de una vez
test_unsubscribe	Labs. Suscribe una dirección nueva, se da de baja con el enlace del propio correo, lo registra, activa más marketing y comprueba que no llegue ninguno mientras los recibos sí llegan
audit_marketing_emails	Labs. Acepta las ofertas y el boletín de la app, activa cada correo de marketing al que puede llegar, comprueba cómo darse de baja de cada uno, su texto de vista previa y su cupón, y lista lo que hay que corregir. La skill de pruebas de correos de marketing cubre esto y los cuatro prompts anteriores de una vez

Úsalo

Luego pide en palabras sencillas: “Regístrate en localhost:3000 con una dirección nueva de Proxy Mail QA y confirma el correo.”

Algunos agentes de IA, incluido Claude, solo se registran en una app que se ejecuta en tu computadora (localhost). Para un sitio de staging o producción, pide al agente que escriba una prueba de Playwright o Cypress que use el API, y ejecútala tú o en CI. Para probar algo a mano, Proxy Mail QA for Chrome llena el formulario de registro con una cuenta de prueba y muestra el código o enlace en la misma página.

Una skill para Claude Code y otros agentes describe todo el flujo, y más skills cubren escribir pruebas, auditorías y apps móviles.