Conectar un agente de IA con MCP

Elige tu cliente

Endpoint: https://mcp.fairvalid.com/mcp. Transporte: Streamable HTTP.

Conéctate con una clave de API o con el inicio de sesión OAuth. Las conexiones aptas de ChatGPT, Claude y Grok pueden usar OAuth; consulta a continuación los requisitos de cuenta y de rol de tu cliente. Codex, Claude Code y Hermes también admiten conexiones directas con clave de API.

Para clientes con clave de API, crea una clave de prueba con etiqueta en Claves de API como Propietario o Administrador del espacio de trabajo. Guárdala en las credenciales protegidas del cliente o en la configuración de entorno documentada. Nunca pongas una clave en un prompt, un argumento de herramienta, una URL o una configuración confirmada en el repositorio.

El flujo OAuth abre fairvalid.com para iniciar sesión y dar tu consentimiento. Eliges una clave de API Live existente que cubra los permisos solicitados y revisas su espacio de trabajo y su límite total. La aprobación concede todos los permisos solicitados a la vez, dentro de los alcances de esa clave. No se te pide pegar esa clave en el cliente de IA. Revocar la clave seleccionada también finaliza sus conexiones. OAuth utiliza claves live; para el entorno de pruebas, usa una conexión directa con una clave de prueba.

Instrucciones de clientes revisadas el 23 de octubre de 2026. El protocolo MCP alojado ha superado las pruebas de aceptación en producción con el SDK oficial. Eso no significa que se haya probado cada cliente mencionado; completa la comprobación de conexión en tu cliente antes de confiar en él.

ChatGPT

Usa la configuración de OAuth que aparece a continuación. Las conexiones MCP personalizadas actuales requieren ChatGPT Business o Enterprise/Edu en la web, con permiso para crear plugins con MCP. Business requiere un administrador o propietario; Enterprise/Edu puede autorizar a determinados miembros.

1. Abre Plugins, selecciona el botón más y luego Añadir servidor MCP personalizado. El flujo actual de Plugins no requiere el modo desarrollador.
2. Asigna a la conexión el nombre FairValid e introduce https://mcp.fairvalid.com/mcp como endpoint HTTPS público.
3. Elige OAuth con registro automático de cliente. FairValid usa registro de cliente público: no necesitas proporcionar un ID de cliente ni un secreto de cliente. Nunca introduzcas una clave de API en ninguno de esos campos.
4. Completa el inicio de sesión y el consentimiento de FairValid descritos arriba. Revisa la advertencia de ChatGPT y luego selecciona Create as a plugin e inspecciona las seis herramientas detectadas.
5. Instala el plugin, abre una conversación nueva, escribe @ y selecciona FairValid. Ejecuta la comprobación de conexión de solo lectura que aparece a continuación antes de solicitar una verificación real.

Documentación oficial: OpenAI: conectar un servidor MCP personalizado · OpenAI: autenticación OAuth

Claude web y Desktop

Usa un conector personalizado remoto con OAuth. Es la misma conexión vinculada a la cuenta en Claude web y Desktop; se ejecuta a través de los servidores de Anthropic. En Team y Enterprise, primero debe añadir el conector un Owner de la organización. Los miembros de Enterprise con un rol personalizado que gestione las bibliotecas de la organización también pueden añadirlo.

Some organizations have a Request headers beta. For that alternative, choose No sign-in and add a required Authorization header with the full value Bearer <your FairValid API key>. If Request headers is absent, use OAuth or the Claude Code instructions below. The API key is not an OAuth client secret.

1. Abre Personalizar → Conectores → Añadir conector personalizado. En una organización gestionada, un propietario o un rol Enterprise autorizado empieza en Configuración de la organización → Conectores → Añadir → Personalizado → Web.
2. Introduce FairValid y https://mcp.fairvalid.com/mcp.
3. Elige Iniciar sesión ahora. Si aparece una opción de cliente OAuth, selecciona Registrar automáticamente. Deja vacíos los campos de ID de cliente y secreto registrados manualmente.
4. Inicia sesión en fairvalid.com, revisa la clave en vivo seleccionada y sus permisos, y aprueba la conexión. Activa FairValid desde los controles de conectores de la conversación.
5. Ejecuta la comprobación de conexión de solo lectura que aparece a continuación. Usa la comprobación de sandbox solo si te conectaste con una clave de API de prueba mediante Request headers.

Documentación oficial: Anthropic: conectores personalizados y autenticación · Anthropic: disponibilidad de conectores remotos

Claude Code

Claude Code admite una conexión directa mediante clave de API. Define FAIRVALID_API_KEY en el entorno desde el que se inicia Claude Code, usando una clave de prueba para la primera verificación. No guardes el secreto real en los archivos del proyecto.

1. Combina la siguiente configuración con el archivo .mcp.json del proyecto. Conserva los servidores existentes. La referencia literal a la variable de entorno va en el archivo; el valor de la clave, no.
2. Inicia Claude Code con FAIRVALID_API_KEY disponible. Aprueba la configuración MCP del proyecto si se solicita.
3. Ejecuta claude mcp list y luego revisa /mcp en la sesión. Confirma que FairValid se conecta y expone seis herramientas; después, realiza la comprobación de sandbox que aparece a continuación.

{
  "mcpServers": {
    "fairvalid": {
      "type": "http",
      "url": "https://mcp.fairvalid.com/mcp",
      "headers": {
        "Authorization": "Bearer ${FAIRVALID_API_KEY}"
      }
    }
  }
}

Documentación oficial: Anthropic: configuración de MCP en Claude Code

Hermes Agent

Estas instrucciones son para NousResearch Hermes Agent. Su transporte HTTP remoto admite encabezados bearer. La CLI guarda la clave en el archivo .env de tu perfil activo como MCP_FAIRVALID_API_KEY y mantiene una referencia de entorno en config.yaml.

1. Ejecuta el comando add que aparece a continuación. Responde «yes» cuando se te pregunte si se requiere autenticación y, después, introduce una clave de API de prueba en el campo oculto API key / Bearer token.
2. Revisa las herramientas detectadas y activa las herramientas de FairValid que necesites. La configuración debe conectarse correctamente; guardar una conexión desactivada tras un error no constituye una configuración correcta.
3. Ejecuta hermes mcp test fairvalid y luego inicia una nueva sesión o ejecuta /reload-mcp. Realiza la comprobación de sandbox que aparece a continuación. Es posible que Hermes añada el prefijo del nombre del servidor a los nombres de las herramientas.

hermes mcp add fairvalid \
  --url https://mcp.fairvalid.com/mcp \
  --auth header

hermes mcp test fairvalid

Documentación oficial: NousResearch: configuración de MCP · NousResearch: comprobaciones de conexión MCP · NousResearch: implementación de CLI con autenticación por encabezado

Grok Bot y Grok

Grok Bot y Grok.com se configuran en lugares distintos. En un Grok Bot personal, pídele al Bot que añada FairValid con la solicitud que aparece a continuación. Esta opción también funciona cuando el panel de información solo muestra Detalles, Biblioteca y Ordenador, sin una sección de Configuración.

Los Team Bots muestran además panel de información → Setup → Plugins al propietario o a los administradores del Bot. Esa sección de configuración requiere acceso a Team Bot en la aplicación de escritorio. Cada miembro del equipo inicia sesión con su propia cuenta cuando se usa OAuth.

Grok.com usa grok.com/connectors → New Connector → Custom. Introduce https://mcp.fairvalid.com/mcp y completa la autenticación. Es posible que, en los equipos Business y Enterprise, un administrador deba habilitar primero el conector. Esta conexión es independiente de un plugin de Grok Bot.

Un bot creado con la API de xAI también es independiente: su desarrollador configura los encabezados MCP remotos en el código del servidor. Estas instrucciones no afirman que Grok Bot ofrezca un campo genérico para el encabezado Authorization.

1. Pide a tu Bot que añada la conexión MCP HTTPS remota personalizada con la solicitud siguiente. En un Team Bot, su propietario o gestor también puede usar Setup → Plugins.
2. When the Bot shows the FairValid authorization card, select Authorize to open OAuth sign-in. Keep API keys out of the request and any server command.
3. Completa el consentimiento de FairValid en fairvalid.com. Cada compañero conecta su propia cuenta cuando sea necesario.
4. Pide al Bot que enumere las herramientas de FairValid y ejecute la comprobación de conexión de solo lectura que aparece a continuación. Detectar las herramientas no demuestra por sí solo que se haya completado una verificación.

Add FairValid as a custom Remote HTTPS MCP server at
https://mcp.fairvalid.com/mcp using OAuth.
Show me the sign-in flow, then list its tools.
Do not submit any email verification yet.

Documentación oficial: xAI: plugins de Grok Bot y HTTPS remoto · xAI: conectores personalizados de Grok.com · xAI: MCP remoto para desarrolladores de API

Codex

Usa una conexión directa con clave de API desde Codex. Define FAIRVALID_API_KEY en el entorno disponible para el proceso de Codex y usa una clave Test para tu primera verificación. Es posible que una aplicación de escritorio iniciada de forma independiente no herede el entorno de tu terminal.

1. Ejecuta el comando siguiente para registrar el servidor remoto Streamable HTTP. El comando guarda el nombre de la variable de entorno, no la clave de API.
2. Ejecuta codex mcp list e inicia una nueva sesión de Codex para que cargue la conexión. Confirma que FairValid aparece entre las herramientas MCP de la sesión.
3. Si usas la app de Codex, haz que la variable esté disponible en su host de ejecución y reinicia la app o abre una sesión nueva según sea necesario. No des por hecho que una configuración correcta en la CLI haya cambiado el entorno de una app que ya estaba en ejecución.
4. Confirma las seis herramientas detectadas y realiza la comprobación en el entorno de pruebas que aparece a continuación.

codex mcp add fairvalid \
  --url https://mcp.fairvalid.com/mcp \
  --bearer-token-env-var FAIRVALID_API_KEY

codex mcp list

Documentación oficial: OpenAI: configuración MCP de Codex

Comprueba la conexión antes de enviar trabajos

Confirma que se detectan las seis herramientas que se indican abajo. Un cliente puede añadir su propio prefijo a los nombres de las herramientas. La detección confirma una conexión, no una verificación correcta.

Con OAuth o una clave de API Live, concede el permiso de saldo y pide primero al agente que llame a fairvalid_get_balance sin argumentos. Consultar el saldo no usa créditos de verificación. No envíes los ejemplos de sandbox a través de una conexión en vivo.

Con una clave de API Test, sigue en su lugar la verificación de sandbox que aparece abajo. La verificación en vivo puede reservar y gastar créditos; elige una dirección que tengas autorización para verificar y solicita el envío de forma explícita.

Si una conexión falla, revisa los permisos del conector de la cuenta, el endpoint, las variables de entorno que falten y si se ha revocado la clave o la autorización. Ante errores de permisos o de límite de gasto, revisa los alcances concedidos o el límite antes de reintentar; una nueva clave de idempotencia no resuelve la causa.

Empieza con una verificación gratuita en el entorno de pruebas

Usa una clave fv_test_ y llama a fairvalid_verify_email con el ejemplo siguiente. La verificación de una sola dirección con clave de prueba devuelve directamente un resultado simulado. No realiza llamadas al proveedor, no crea ninguna verificación real y no usa créditos.

Otros ejemplos reservados son undeliverable@example.com, risky@example.com, unknown@example.com, pending@example.com y error@example.com. Pending y error son simulaciones intencionadas, no comprobaciones reales de buzones. El ejemplo pending de una sola dirección no tiene ningún trabajo que consultar.

{
  "email": "deliverable@example.com",
  "idempotency_key": "agent-demo-2026-10-23"
}

Herramientas y permisos

fairvalid_verify_email recibe email e idempotency_key. fairvalid_submit_job recibe emails, idempotency_key y un name opcional, para entre 1 y 5.000 direcciones. Los envíos en modo live requieren el ámbito submit.

fairvalid_get_job recibe job_id para leer el estado. fairvalid_get_results recibe job_id y, opcionalmente, cursor, filter y search para leer hasta 50 resultados cada vez. Las lecturas en modo live requieren el ámbito read.

fairvalid_cancel_job recibe job_id y solicita la cancelación; las comprobaciones en curso pueden finalizar. La cancelación en modo live requiere el alcance submit. fairvalid_get_balance no recibe argumentos y requiere una clave live con el alcance balance. Las claves de prueba no pueden leer un saldo de créditos live.

Las claves determinan el espacio de trabajo. Las herramientas no aceptan argumentos de clave de API ni de espacio de trabajo. Las comprobaciones de alcance, la revocación, los límites de gasto y las reglas de créditos del espacio de trabajo se aplican a MCP igual que a la API para clientes.

Sigue un trabajo en directo hasta sus resultados

Con OAuth o una clave fv_live_, tanto la verificación individual como la masiva envían trabajos asíncronos. Una respuesta accepted y un job_id indican que el trabajo se admitió, no que la verificación del buzón haya finalizado. El tiempo de procesamiento depende de la cola y del proveedor de verificación.

Para ensayar el flujo de trabajos en el sandbox, llama a fairvalid_submit_job con direcciones de ejemplo reservadas. Los trabajos en el sandbox admiten estado, resultados, cancelación y repetición sin llamadas a proveedores ni consumo de créditos.

1. Envía una sola vez con un idempotency_key estable y conserva el job_id devuelto.
2. Llama a fairvalid_get_job con ese job_id. Espacia las solicitudes de sondeo y aumenta los intervalos durante los fallos temporales.
3. Llama a fairvalid_get_results con el mismo job_id. Pasa cada next_cursor como cursor hasta que next_cursor sea null. Un cursor conserva el filtro y la búsqueda originales.
4. Revisa tanto el estado del trabajo como cada resultado. Los resultados desconocidos, catch-all y en verificación no demuestran que un buzón sea válido.

Reintenta sin generar trabajo duplicado

Ambas herramientas de envío requieren una idempotency_key de 8 a 128 caracteres entre letras, dígitos, puntos, dos puntos, guiones bajos o guiones. Reintenta una respuesta incierta con la misma clave de API o conexión OAuth, la misma idempotency_key y la entrada sin cambios. La repetición está vinculada a la clave de API subyacente: rotar un token de acceso OAuth mantiene esa identidad, pero seleccionar otra clave de API y volver a enviar puede crear otra ejecución. Se rechaza una carga útil de trabajo modificada con una clave de idempotencia existente. Usa una nueva clave de idempotencia solo cuando quieras realizar una nueva ejecución de forma intencionada.

Comprueba isError antes de leer el resultado. Las llamadas que llegan a la API de clientes incluyen su respuesta y su estado HTTP en structuredContent; los errores de validación de argumentos pueden devolver solo contenido de texto. Revisa el código de cualquier error de la API y respeta cualquier indicación de reintento. Un tiempo de espera agotado o un error temporal no demuestra que el envío original no se haya realizado.

Las claves en vivo pueden gastar créditos del espacio de trabajo. Fija un límite total antes de conectar un agente autónomo: cuentan tanto los créditos descontados como los reservados. Las comprobaciones válidas y no válidas completadas usan un crédito; los resultados desconocidos, los catch-all sin resolver y los fallos técnicos no tienen cargo neto de verificación.