Unplain MCP

Tu asistente escribe el ebook o informe. Unplain lo diseña y te devuelve un PDF listo para publicar.

Unplain es un servidor alojado de Model Context Protocol. Pide un documento y tu asistente lo escribe, elige un diseño (o aplica una marca que tengas guardada), genera una portada y exporta un PDF terminado con una portada compuesta, un índice de contenidos construido a partir de los encabezados, paginación real y una página final de llamada a la acción. Nunca sales del chat y nunca abres una herramienta de diseño.

De ahí se derivan dos cosas, y son la razón para usar esto en lugar de pedirle a un modelo un PDF directamente:

• Sale igual cada vez. Los Brand Themes se guardan, así que el décimo documento coincide con el primero. Tu asistente puede crear uno y reutilizarlo.

• Las revisiones no cuestan tokens. Cada documento es un proyecto real en tu cuenta de Unplain, y las herramientas devuelven un enlace al editor. Corrige una frase haciendo clic en él, no pidiendo al modelo que regenere el archivo.

Unplain no escribe tu contenido y, a través de MCP, no acepta archivos: tu asistente proporciona las palabras como Markdown. Subir un .docx o un .txt es una función de la aplicación web, no de MCP.

• Endpoint: https://app.unplain.io/api/mcp

• Transporte: Streamable HTTP

• Autenticación: Authorization: Bearer <api-key> (también se acepta un Authorization: <api-key> sin Bearer)

• Instalación: nada que instalar

• Documentación: https://unplain.io/mcp

• Precios: incluido en todos los planes, gratis y Pro. https://unplain.io/pricing

Este repositorio es documentación. El servidor está alojado, así que no hay paquete que instalar ni código que ejecutar. Aquí se aceptan incidencias y preguntas.

Publicación en el registro oficial de MCP: ver PUBLISHING.md. El manifiesto es server.json.

Inicio rápido

1. Obtén una clave de API

Crea una en configuración de la cuenta. Se muestra una sola vez. Una cuenta gratuita sirve para todo lo siguiente.

2. Añade el servidor

Claude Code

claude mcp add --transport http unplain https://app.unplain.io/api/mcp \
  --header "Authorization: Bearer unp_your_key_here"

Guía completa: https://unplain.io/mcp/claude-code

Codex

export UNPLAIN_API_KEY="unp_your_key_here"

codex mcp add unplain \
  --url https://app.unplain.io/api/mcp \
  --bearer-token-env-var UNPLAIN_API_KEY

Guía completa: https://unplain.io/mcp/codex

Cualquier otra cosa

Cualquier cliente que pueda añadir un servidor MCP remoto y enviar una cabecera Authorization funciona. Necesitas dos valores:

Server URL:  https://app.unplain.io/api/mcp
Header:      Authorization: Bearer unp_your_key_here

Un cliente que solo admita servidores que se ejecutan en tu propia máquina aún no puede conectarse.

3. Saluda

List the Brand Themes in my Unplain account and tell me which one is the default.

Una lista vacía sigue siendo un éxito: la conexión está activa, aún no has guardado un tema.

4. Crea algo

Write a short ebook called "The Email Welcome Sequence Playbook" with an intro
and five chapters. Use my default Brand Theme, then export the PDF.

Related MCP server: MCP MD2PDF Server

Herramientas

Doce herramientas. Nombres y comportamiento vigentes según la versión en CHANGELOG.md.

Notas que importan en la práctica

• Las ediciones son atómicas y con verificación de versión. Un asistente no puede sobrescribir un cambio que hayas hecho en la aplicación web mientras tanto; una escritura obsoleta se rechaza en lugar de aplicarse sobre tu trabajo.

• El diseño se puede describir en lugar de especificar. "Un informe monocromo austero" o "una revista literaria independiente elegante" se resuelve en ajustes reales, elegidos de lo que Unplain realmente admite en lugar de adivinados.

• Las fuentes fuera del catálogo se rechazan, no se sustituyen. Lo que ves en la aplicación es lo que llega al PDF.

• La generación de portadas usa tu asignación existente, la misma que usa el botón de la aplicación. No hay una asignación MCP separada. Sobrescribir una portada existente requiere una aprobación explícita, así que una solicitud repetida no puede gastar silenciosamente una segunda generación.

• Los enlaces de descarga están firmados y caducan. El proyecto se guarda, así que exporta de nuevo en lugar de acumular la URL.

Planes y límites

El MCP es una interfaz, no un nivel. Una clave lleva exactamente las capacidades de la cuenta detrás de ella, y se aplican los mismos límites tanto si trabajas en la aplicación web como a través de un asistente.

La portada, el índice y la página de llamada a la acción nunca cuentan para el límite de páginas. Precios actuales: https://unplain.io/pricing

Ejemplos de indicaciones

Consulta examples/prompts.md para un conjunto más completo. Algunos para empezar:

Take the Markdown in notes.md and create an Unplain ebook called "Q3 Growth
Report". Use my default Brand Theme, then wait for the export and give me the
PDF link.

Open my Unplain ebook "Q3 Growth Report", read the outline, rewrite the
introduction so it opens with a concrete number instead of a general claim,
then export a fresh PDF.

Analyse the churn data in ./data, write it up as a report with an executive
summary, three findings and a recommendation, then create it in Unplain using
my "Acme" theme and export the PDF.

Mantén tu clave segura

Trátala como una contraseña.

• Codex la lee de una variable de entorno, lo que la mantiene fuera de los archivos de configuración.

• El -s project de Claude Code escribe un .mcp.json en la raíz del proyecto. No confirmes una clave real en él. Usa un marcador de posición y que cada persona proporcione la suya; una clave actúa en la cuenta a la que pertenece.

• Revócala desde configuración de la cuenta. La revocación tiene efecto inmediato. Mantén una clave por cliente para poder revocar una sin afectar a las demás.

Solución de problemas

Más: https://unplain.io/mcp

Soporte

• Documentación: https://unplain.io/mcp

• Correo electrónico: info@unplain.io

• Incidencias: usa este repositorio

Licencia

La documentación y los ejemplos de este repositorio tienen licencia MIT. El servicio Unplain en sí se rige por sus términos y su política de privacidad.