Unplain

Convierte un documento o un borrador de IA en un PDF listo para publicar, con portada automática, índice, paginación y tu marca guardada.

Documentación

Unplain MCP

Tu asistente escribe el ebook o informe. Unplain lo diseña y te entrega 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 hayas guardado), genera una portada y exporta un PDF terminado con una portada compuesta, una tabla de contenidos construida 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 eso se derivan dos cosas, y son la razón para usar esto en lugar de pedirle directamente un PDF a un modelo:

  • Siempre sale igual. Los temas de marca se almacenan, 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 pidiéndole al modelo que regenere el archivo.

Unplain no escribe tu contenido y, a través de MCP, no acepta cargas de 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: HTTP transmisible
  • Autenticación: Authorization: Bearer <api-key> (también se acepta un Authorization: <api-key> simple)
  • Instalación: nada que instalar
  • Documentación: https://unplain.io/mcp
  • Precios: incluido en todos los planes, gratuito y Pro. https://unplain.io/pricing

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

Publicación en el registro oficial de MCP: consulta 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 funciona 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 un encabezado 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.

Herramientas

Doce herramientas. Los nombres y el comportamiento están actualizados según la versión en CHANGELOG.md.

HerramientaQué hace
get_accountInforma del plan al que pertenece esta clave y de los límites aplicables. Vale la pena llamarla antes de escribir algo largo.
get_design_optionsEl catálogo de fuentes, los ajustes predefinidos integrados y el rango permitido de cada ajuste de tipografía y espaciado.
list_brand_themesLista los temas de marca guardados.
create_brand_themeGuarda un nuevo tema de marca: colores, fuentes, enlaces.
update_brand_themeCambia el nombre, los colores, las fuentes o los enlaces de un tema.
create_ebookCrea un proyecto a partir de un título y Markdown.
list_ebooksEncuentra los proyectos del llamante.
get_ebookLee un proyecto como un esquema estructurado.
update_ebookReescribe párrafos, encabezados y listas, cambia el texto y el estilo de la portada, aplica un tema o reemplaza el cuerpo.
generate_cover_imageArte de portada con IA, generado a partir de los encabezados de sección o de tus indicaciones.
export_ebookRenderiza el PDF diseñado.
get_export_statusConsulta una exportación en curso y obtén el enlace de descarga.

Notas que importan en la práctica

  • Las ediciones son atómicas y verificadas por 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 sobrio" 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 separada de MCP. Sobrescribir una portada existente requiere una aprobación explícita, por lo 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.

GratuitoPro
Páginas de contenido por PDF exportado5Ilimitado
Proyectos guardados5Ilimitado
Temas de marca125
Portadas con IA1 de por vida30 por período
Insignia "Hecho con Unplain"SiempreSe puede quitar

La portada, el contenido y las páginas 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.

Mantener 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 comprometas una clave real en él. Usa un marcador de posición y haz 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 alterar las demás.

Solución de problemas

SíntomaCausa
Cada llamada a una herramienta fallaLa clave no llega al servidor. El encabezado debe ser Bearer (con el espacio) y luego la clave, y la URL debe terminar en /api/mcp sin barra final. Una clave incorrecta devuelve 401, que la mayoría de los clientes informan como una conexión fallida.
Las herramientas no aparecenReinicia el cliente. Los servidores nuevos se detectan al inicio de la sesión.
Codex no encuentra la claveLa lee del entorno al iniciarse. Expórtala en tu perfil de shell e inicia Codex desde un shell que la tenga.
"Sin temas de marca"La conexión funciona, no has guardado uno. Tu asistente puede crear uno o diseñar desde los ajustes predefinidos integrados.
La exportación dice que el ebook es demasiado largoLas exportaciones gratuitas admiten hasta 5 páginas de contenido. Acórtalo o mejora el plan. El proyecto se guarda de cualquier manera.
Demasiadas solicitudesLímites de velocidad por cuenta en creaciones y exportaciones. Espera un minuto.

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


Soporte

Licencia

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