Unplain

Unplain MCP

Seu assistente escreve o ebook ou relatório. O Unplain o projeta e entrega um PDF pronto para publicação.

O Unplain é um servidor Model Context Protocol hospedado. Peça um documento e seu assistente o escreve, escolhe um design (ou aplica uma marca que você salvou), gera uma capa e exporta um PDF finalizado com capa composta, sumário construído a partir dos títulos, paginação real e uma página final de chamada para ação. Você nunca sai do chat e nunca abre uma ferramenta de design.

Duas coisas decorrem disso, e são o motivo para usar isto em vez de pedir um PDF diretamente a um modelo:

• O resultado é o mesmo toda vez. Os Temas de Marca são armazenados, então o décimo documento corresponde ao primeiro. Seu assistente pode criar um e reutilizá-lo.
• Revisões não custam tokens. Todo documento é um projeto real na sua conta Unplain, e as ferramentas retornam um link do editor. Corrija uma frase clicando nele, não pedindo ao modelo para regenerar o arquivo.

O Unplain não escreve seu conteúdo e, por meio do MCP, não aceita uploads de arquivos: seu assistente fornece as palavras como Markdown. Enviar um .docx ou um .txt é um recurso do aplicativo web, não do MCP.

• Endpoint: https://app.unplain.io/api/mcp
• Transporte: HTTP Streamable
• Autenticação: Authorization: Bearer <api-key> (um Authorization: <api-key> simples também é aceito)
• Instalação: nada para instalar
• Documentação: https://unplain.io/mcp
• Preços: incluídos em todos os planos, gratuito e Pro. https://unplain.io/pricing

Este repositório é documentação. O servidor é hospedado, portanto não há pacote para instalar nem código-fonte para executar. Problemas e perguntas são bem-vindos aqui.

Publicação no Registro Oficial do MCP: veja PUBLISHING.md. O manifesto é server.json.

---

Início rápido

1. Obtenha uma chave de API

Crie uma em configurações da conta. Ela é exibida apenas uma vez. Uma conta gratuita funciona para tudo abaixo.

2. Adicione o servidor

Claude Code

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

Guia completo: 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

Guia completo: https://unplain.io/mcp/codex

Qualquer outra coisa

Qualquer cliente que possa adicionar um servidor MCP remoto e enviar um cabeçalho Authorization funciona. Você precisa de dois valores:

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

Um cliente que só suporta servidores executados na sua própria máquina ainda não pode se conectar.

3. Diga olá

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

Uma lista vazia ainda é um sucesso: a conexão está ativa, você ainda não salvou um tema.

4. Crie 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.

---

Ferramentas

Doze ferramentas. Nomes e comportamento são atuais conforme a versão em CHANGELOG.md.

Ferramenta	O que faz
get_account	Informa o plano ao qual esta chave pertence e os limites aplicáveis. Vale a pena chamar antes de escrever algo longo.
get_design_options	O catálogo de fontes, os predefinidos integrados e a faixa permitida de cada configuração de tipografia e espaçamento.
list_brand_themes	Lista os Temas de Marca salvos.
create_brand_theme	Salva um novo Tema de Marca: cores, fontes, links.
update_brand_theme	Altera o nome, as cores, as fontes ou os links de um tema.
create_ebook	Cria um projeto a partir de um título e Markdown.
list_ebooks	Encontra os projetos do chamador.
get_ebook	Lê um projeto de volta como um esboço estruturado.
update_ebook	Reescreve parágrafos, títulos e listas, altera o texto e o estilo da capa, aplica um tema ou substitui o corpo.
generate_cover_image	Arte de capa por IA, gerada a partir dos títulos das seções ou da sua orientação.
export_ebook	Renderiza o PDF projetado.
get_export_status	Consulta uma exportação em andamento e obtém o link de download.

Observações que importam na prática

• As edições são atômicas e verificadas por versão. Um assistente não pode sobrescrever uma alteração que você fez no aplicativo web nesse meio tempo; uma escrita desatualizada é rejeitada em vez de aplicada sobre o seu trabalho.
• O design pode ser descrito em vez de especificado. "Um relatório monocromático austero" ou "um periódico literário independente elegante" é resolvido em configurações reais, escolhidas a partir do que o Unplain realmente suporta, em vez de adivinhadas.
• Fontes fora do catálogo são recusadas, não substituídas. O que você vê no aplicativo é o que chega ao PDF.
• A geração de capa usa sua cota existente, a mesma que o botão no aplicativo utiliza. Não há cota separada do MCP. Sobrescrever uma capa existente exige uma autorização explícita, para que uma solicitação repetida não gaste silenciosamente uma segunda geração.
• Os links de download são assinados e expiram. O projeto é salvo, então exporte novamente em vez de guardar a URL.

---

Planos e limites

O MCP é uma interface, não um nível. Uma chave carrega exatamente as capacidades da conta por trás dela, e os mesmos limites se aplicam, seja no aplicativo web ou por meio de um assistente.

	Gratuito	Pro
Páginas de conteúdo por PDF exportado	5	Ilimitado
Projetos salvos	5	Ilimitado
Temas de Marca	1	25
Capas por IA	1 vitalícia	30 por período
Selo "Feito com Unplain"	Sempre	Removível

Capa, sumário e páginas de chamada para ação nunca contam para o limite de páginas. Preços atuais: https://unplain.io/pricing

---

Exemplos de prompts

Veja examples/prompts.md para um conjunto mais completo. Alguns para começar:

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.

---

Mantendo sua chave segura

Trate-a como uma senha.

• O Codex a lê de uma variável de ambiente, o que a mantém fora dos arquivos de configuração.
• O -s project do Claude Code grava um .mcp.json na raiz do projeto. Não faça commit de uma chave real nele. Use um espaço reservado e faça cada pessoa fornecer a sua própria; uma chave age na conta à qual pertence.
• Revogue em configurações da conta. A revogação tem efeito imediato. Mantenha uma chave por cliente para poder revogar uma sem perturbar as demais.

---

Solução de problemas

Sintoma	Causa
Toda chamada de ferramenta falha	A chave não está chegando ao servidor. O cabeçalho deve ser Bearer (com o espaço) seguido da chave, e a URL deve terminar em /api/mcp sem barra final. Uma chave inválida retorna 401, que a maioria dos clientes relata como falha de conexão.
As ferramentas não aparecem	Reinicie o cliente. Novos servidores são detectados no início da sessão.
O Codex não encontra a chave	Ele lê o ambiente na inicialização. Exporte-a no seu perfil de shell e inicie o Codex a partir de um shell que a tenha.
"Nenhum Tema de Marca"	A conexão funciona, você ainda não salvou um. Seu assistente pode criar um ou projetar a partir dos predefinidos integrados.
A exportação diz que o ebook é longo demais	Exportações gratuitas têm até 5 páginas de conteúdo. Encurte ou faça upgrade. O projeto é salvo de qualquer forma.
Muitas solicitações	Limites de taxa por conta em criações e exportações. Aguarde um minuto.

Mais: https://unplain.io/mcp

---

Suporte

• Documentação: https://unplain.io/mcp
• E-mail: info@unplain.io
• Problemas: use este repositório

Licença

A documentação e os exemplos neste repositório são licenciados sob MIT. O serviço Unplain em si é regido pelos seus termos e política de privacidade.