¿Qué es el servidor MCP de XML.now?
Es una interfaz para que un asistente de IA use los convertidores de XML.now como herramientas estructuradas. El cliente puede descubrir rutas compatibles, iniciar una conversión, consultar su estado y devolver una URL de descarga segura.
Punto de conexión MCP
https://xml.now/mcp
El servidor utiliza transporte HTTP Streamable sin estado. El cliente debe admitir servidores HTTP remotos y encabezados de autenticación personalizados.
Conectar XML.now con Codex
- 1Crea una clave de API
Inicia sesión y abre Panel → Acceso API.
- 2Guarda la clave
export XMLNOW_API_KEY="xmlnow_your_key_here" - 3Añade el servidor remoto
codex mcp add xml-now \ --url https://xml.now/mcp \ --bearer-token-env-var XMLNOW_API_KEY - 4Comprueba la conexión
codex mcp get xml-now
Conectar otros clientes MCP
Los nombres de configuración varían, pero la URL y el encabezado son los mismos:
{
"mcpServers": {
"xml-now": {
"url": "https://xml.now/mcp",
"headers": { "X-Api-Key": "xmlnow_your_key_here" }
}
}
}
Autenticación
Crea o regenera la clave en el panel de API. También puedes enviarla como Authorization: Bearer …. La clave utiliza los mismos créditos, límites y reglas de propiedad que la API REST y nunca se devuelve en los resultados.
Verificar la conexión MCP
Pide al cliente: «Enumera los convertidores disponibles de XML.now». Esto ejecuta list_converters sin consumir créditos. Después, solicita el uso de la API para confirmar la autenticación.
401 indica una clave incorrecta; 402 indica créditos insuficientes; 429 indica que se alcanzó el límite.Herramientas MCP de XML.now
| Herramienta | Función | Créditos |
|---|---|---|
list_converters | Busca rutas y formatos válidos. | No |
convert_image_url | Obtiene una URL pública e inicia la conversión seleccionada. El nombre se conserva por compatibilidad con la API. | Sí |
get_conversion_status | Consulta un trabajo y obtiene su descarga temporal. | No |
get_api_usage | Consulta créditos, uso reciente y límites. | No |
Flujo de ejemplo
Pide a tu asistente:
Usa el convertidor xml-to-json para el archivo de esta URL pública, espera a que termine y devuélveme el enlace de descarga.
Seguridad y límites
- Solo se aceptan URL públicas HTTP y HTTPS.
- Se bloquean direcciones privadas, locales y reservadas.
- Cada redirección se valida antes de continuar.
- Las descargas tienen límite de tamaño y se procesan en almacenamiento temporal.
- Los archivos respetan la política de retención de XML.now.
¿Prefieres una integración HTTP directa? Consulta la documentación de la API REST de XML.now.