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 unAuthorization: <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.
| Herramienta | Qué hace |
|---|---|
get_account | Informa del plan al que pertenece esta clave y de los límites aplicables. Vale la pena llamarla antes de escribir algo largo. |
get_design_options | El catálogo de fuentes, los ajustes predefinidos integrados y el rango permitido de cada ajuste de tipografía y espaciado. |
list_brand_themes | Lista los temas de marca guardados. |
create_brand_theme | Guarda un nuevo tema de marca: colores, fuentes, enlaces. |
update_brand_theme | Cambia el nombre, los colores, las fuentes o los enlaces de un tema. |
create_ebook | Crea un proyecto a partir de un título y Markdown. |
list_ebooks | Encuentra los proyectos del llamante. |
get_ebook | Lee un proyecto como un esquema estructurado. |
update_ebook | Reescribe párrafos, encabezados y listas, cambia el texto y el estilo de la portada, aplica un tema o reemplaza el cuerpo. |
generate_cover_image | Arte de portada con IA, generado a partir de los encabezados de sección o de tus indicaciones. |
export_ebook | Renderiza el PDF diseñado. |
get_export_status | Consulta 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.
| Gratuito | Pro | |
|---|---|---|
| Páginas de contenido por PDF exportado | 5 | Ilimitado |
| Proyectos guardados | 5 | Ilimitado |
| Temas de marca | 1 | 25 |
| Portadas con IA | 1 de por vida | 30 por período |
| Insignia "Hecho con Unplain" | Siempre | Se 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 projectde Claude Code escribe un.mcp.jsonen 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íntoma | Causa |
|---|---|
| Cada llamada a una herramienta falla | La 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 aparecen | Reinicia el cliente. Los servidores nuevos se detectan al inicio de la sesión. |
| Codex no encuentra la clave | La 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 largo | Las exportaciones gratuitas admiten hasta 5 páginas de contenido. Acórtalo o mejora el plan. El proyecto se guarda de cualquier manera. |
| Demasiadas solicitudes | Límites de velocidad por cuenta en creaciones y exportaciones. Espera un minuto. |
Soporte
- Documentación: https://unplain.io/mcp
- Correo electrónico: info@unplain.io
- Problemas: usa este repositorio
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.