MCP · DOCX.now

Servidor MCP de conversión DOCX

Conecta Codex, Claude u otro cliente compatible con MCP a DOCX.now. Descubre convertidores, procesa archivos públicos y consulta trabajos y uso de la API desde tu asistente.

¿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

  1. 1
    Crea una clave de API

    Inicia sesión y abre Panel → Acceso API.

  2. 2
    Guarda la clave
    export DOCXNOW_API_KEY="docxnow_your_key_here"
  3. 3
    Añade el servidor remoto
    codex mcp add docx-now \
      --url https://docx.now/mcp \
      --bearer-token-env-var DOCXNOW_API_KEY
  4. 4
    Comprueba 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.

Si falla: 401 indica una clave incorrecta; 402 indica créditos insuficientes; 429 indica que se alcanzó el límite.

Herramientas MCP de DOCX.now

HerramientaFunciónCréditos
list_convertersBusca rutas y formatos válidos.No
convert_image_urlObtiene una URL pública e inicia la conversión seleccionada. El nombre se conserva por compatibilidad con la API.Sí
get_conversion_statusConsulta un trabajo y obtiene su descarga temporal.No
get_api_usageConsulta 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.