RedirectBoss
Gestiona hosts, redirecciones, SSL y análisis de tráfico desde Claude y otros asistentes de IA.
Documentación
Resumen
El servidor MCP de RedirectBoss permite que asistentes de IA como Claude gestionen tus redirecciones en tu nombre. Implementa el Protocolo de Contexto de Modelo (MCP), un estándar abierto para conectar modelos de IA con herramientas externas. Cuando autorizas el servidor, el asistente de IA puede listar y modificar hosts y redirecciones en tu cuenta, y obtener análisis de tráfico y rendimiento por redirección, llamando a nuestra API pública internamente.
URL del servidor: https://mcp.redirectboss.com/mcp
Autenticación: OAuth 2.1 (código de autorización + PKCE, Documentos de Metadatos de ID de Cliente)
Transporte: HTTP Streamable
Requisitos
- Una cuenta de RedirectBoss en un plan que incluya acceso a la API. Consulta precios para ver los detalles de los planes.
- Un cliente MCP que admita Documentos de Metadatos de ID de Cliente (la especificación MCP actual), como Claude, VS Code y ChatGPT. Los clientes que aún no implementan los Documentos de Metadatos de ID de Cliente no pueden conectarse.
Herramientas Disponibles
El servidor expone las herramientas que se enumeran a continuación. Las herramientas de solo lectura son seguras de ejecutar sin confirmación; las herramientas de escritura modifican tu cuenta; las herramientas destructivas son irreversibles y la mayoría de los clientes MCP solicitarán confirmación antes de ejecutarlas.
Gestión de hosts
- list_hosts: lista todos los hosts con estado SSL/DNS (solo lectura)
- get_host: obtiene información detallada de un solo host (solo lectura)
- create_host: agrega un nuevo dominio de origen (escritura)
- update_host: actualiza la configuración del host, p. ej., manejo de www (escritura)
- delete_host: elimina un host y desactiva sus redirecciones (destructivo)
- check_dns: ejecuta una verificación de resolución DNS en vivo (solo lectura)
- check_ssl: verifica el estado de aprovisionamiento SSL (solo lectura)
- enable_ssl: activa el aprovisionamiento de certificados SSL mediante Let's Encrypt (escritura)
Gestión de redirecciones
- list_redirects: lista reglas de redirección con filtrado (solo lectura)
- get_redirect: obtiene una sola regla de redirección (solo lectura)
- create_redirect: crea una nueva regla de redirección (escritura)
- update_redirect: actualiza campos en una redirección existente (escritura)
- delete_redirect: elimina permanentemente una regla de redirección (destructivo)
Analíticas
- get_hosts_analytics: resumen por host de conteos de redirecciones, visitas y tiempo de respuesta promedio (solo lectura)
- get_traffic_trends: visitas en toda la cuenta a lo largo del tiempo con granularidad diaria o mensual (solo lectura)
- get_host_traffic_trends: visitas a lo largo del tiempo limitadas a un solo host (solo lectura)
- get_redirect_analytics: visitas totales, tiempo de respuesta promedio y desglose diario para una redirección (solo lectura)
- get_redirect_traffic_trends: visitas a lo largo del tiempo para una redirección con granularidad configurable (solo lectura)
Ámbitos de Permiso
Cuando autorizas un cliente MCP, verás una pantalla de consentimiento que enumera los ámbitos que el cliente está solicitando. Cada herramienta requiere uno de los siguientes ámbitos:
- read:hosts: requerido para
list_hosts,get_host,check_dns,check_ssl - write:hosts: requerido para
create_host,update_host,delete_host,enable_ssl - read:redirects: requerido para
list_redirects,get_redirect - write:redirects: requerido para
create_redirect,update_redirect,delete_redirect - read:analytics: requerido para
get_hosts_analytics,get_traffic_trends,get_host_traffic_trends,get_redirect_analytics,get_redirect_traffic_trends
Los tokens emitidos a un cliente MCP están limitados a tu propia cuenta. El éxito de una llamada a herramienta aún depende de tu plan. Consulta precios para ver los planes que incluyen acceso a la API.
Inicio Rápido
Claude.ai y Claude Desktop
Agrega RedirectBoss como conector personalizado desde la configuración de Claude:
- Abre la configuración de Claude y navega a la sección de Conectores.
- Agrega un nuevo conector personalizado.
- Establece la URL del servidor en
https://mcp.redirectboss.com/mcp. - Cuando se te solicite, inicia sesión en tu cuenta de RedirectBoss y aprueba los ámbitos solicitados en la pantalla de consentimiento.
Una vez conectado, las herramientas enumeradas anteriormente estarán disponibles para Claude. Puedes hacer solicitudes en lenguaje natural como "lista todos mis hosts", "crea una redirección 301 de /old a https://new.com/new en example.com", "verifica si DNS y SSL están funcionando para shop.example.com" o "muéstrame mis tendencias de tráfico de este mes" y Claude llamará a las herramientas apropiadas.
Claude Code
Agrega el servidor a la configuración MCP de un proyecto:
{
"mcpServers": {
"redirectboss": {
"url": "https://mcp.redirectboss.com/mcp"
}
}
}
Guarda esto como .mcp.json en tu proyecto, o agrega el servidor mediante claude mcp add. En el primer uso, Claude Code abrirá tu navegador para completar el flujo de autorización OAuth.
Otros clientes MCP
Los patrones anteriores (una URL de servidor para clientes alojados, o una entrada de configuración JSON que apunte a https://mcp.redirectboss.com/mcp para clientes de estilo CLI) funcionan con cualquier cliente que hable el transporte HTTP Streamable y se identifique con un Documento de Metadatos de ID de Cliente. Consulta la documentación MCP de tu cliente para conocer los pasos de configuración exactos.
Cómo Funciona la Autorización
La autorización sigue el flujo de código de autorización OAuth 2.1 con PKCE, utilizando Documentos de Metadatos de ID de Cliente para la identidad del cliente:
- El cliente MCP descubre nuestro servidor de autorización mediante metadatos de recursos protegidos OAuth publicados por el servidor MCP.
- El cliente se identifica con su propio Documento de Metadatos de ID de Cliente, una URL HTTPS que controla. Esa URL sirve JSON que declara su nombre, su sitio web y los destinos de redirección que se le permite usar, y es el identificador del cliente; no hay nada que el cliente deba registrar con nosotros.
- Inicias sesión en RedirectBoss y ves una pantalla de consentimiento que muestra el nombre del cliente y la URL de su documento de metadatos, el destino de redirección al que se te enviará de vuelta y los ámbitos que está solicitando. Puedes aprobar o denegar.
- Tras la aprobación, el cliente intercambia el código de autorización por un token de acceso limitado a tu cuenta, demostrando con PKCE que posee el secreto con el que comenzó el flujo.
- El token de acceso se incluye en cada solicitud MCP posterior y se valida en el servidor. Los tokens de acceso son de corta duración; los clientes mantienen un token de actualización para obtener nuevos sin enviarte de vuelta al inicio de sesión.
Verifica la URL del documento de metadatos en la pantalla de consentimiento antes de aprobar: es la parte de la identidad de un cliente que no puede falsificar, porque debe servir el documento desde esa dirección. El nombre que aparece junto a él es lo que el cliente dice ser. Los tokens de acceso están limitados solo a tu cuenta, y nunca se envían contraseñas ni secretos a largo plazo al cliente MCP.
¿Estás construyendo un cliente MCP? El documento de nuestro propio cliente de monitoreo es un ejemplo práctico: /.well-known/oauth/mcp-smoke-client.json.
Límites de Tasa
Las llamadas MCP comparten los mismos límites de tasa que el acceso directo a la API:
- 5,000 solicitudes por hora (entre lecturas y escrituras)
- 1,000 operaciones de escritura por día
Exceder estos límites devuelve una respuesta HTTP 429, que el cliente MCP mostrará como un error y reintentará después del intervalo de Retry-After.
Revisión y Revocación de Acceso
Puedes ver cada cliente MCP autorizado en tu cuenta y revocar el acceso en cualquier momento desde tu panel de control en Preferencias → Aplicaciones Conectadas. Revocar un cliente finaliza tu autorización para él: su token de actualización deja de funcionar de inmediato, y cualquier token de acceso ya emitido puede tardar hasta 10 minutos en dejar de ser aceptado. La revocación se aplica a tu propia cuenta. No afecta a otros usuarios que hayan autorizado el mismo cliente, y cubre todos los lugares donde usas ese cliente, porque todos usan la misma concesión para tu cuenta. Consulta la sección de Política de Privacidad sobre acceso de terceros para conocer la política completa.
Solución de Problemas
"Acceso a la API no permitido"
Tu plan actual no incluye acceso a la API. Consulta nuestra página de precios para ver los planes que lo admiten, luego contacta a support@redirectboss.com para cambiar tu plan.
La pantalla de consentimiento muestra ámbitos incorrectos
Los ámbitos mostrados en la pantalla de consentimiento son los que solicitó el cliente MCP. Puedes aprobar un subconjunto si tu cliente lo admite, o rechazar la solicitud y plantear el problema al proveedor del cliente.
La llamada a herramienta devuelve 403 "ámbito insuficiente"
El cliente autorizado no posee el ámbito requerido para esa herramienta, generalmente porque se aprobó un conjunto más restringido en la pantalla de consentimiento. Reconecta el cliente y aprueba los ámbitos que necesiten las herramientas que deseas usar.
Soporte
¿Preguntas o problemas al integrar el servidor MCP? Envía un correo a support@redirectboss.com. Para la API REST subyacente, consulta la referencia de la API.