¿Qué es el servidor MCP de DOCX.now?
Es una interfaz para que un asistente de IA use los convertidores de DOCX.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://docx.now/mcp
El servidor utiliza transporte HTTP Streamable sin estado. El cliente debe admitir servidores HTTP remotos y encabezados de autenticación personalizados.
Conectar DOCX.now con Codex
- 1Crea una clave de API
Inicia sesión y abre Panel → Acceso API.
- 2Guarda la clave
export DOCXNOW_API_KEY="docxnow_your_key_here" - 3Añade el servidor remoto
codex mcp add docx-now \ --url https://docx.now/mcp \ --bearer-token-env-var DOCXNOW_API_KEY - 4Comprueba la conexión
codex mcp get docx-now
Conectar otros clientes MCP
Los nombres de configuración varían, pero la URL y el encabezado son los mismos:
{
"mcpServers": {
"docx-now": {
"url": "https://docx.now/mcp",
"headers": { "X-Api-Key": "docxnow_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 DOCX.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 DOCX.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 docx-to-pdf 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 DOCX.now.
¿Prefieres una integración HTTP directa? Consulta la documentación de la API REST de DOCX.now.