Unmarkdown

A camada de publicação de documentos para ferramentas de IA: Crie, estilize e publique documentos formatados a partir de qualquer cliente MCP.

GitHub

Documentação

Servidor MCP Unmarkdown

Um servidor Model Context Protocol (MCP) que conecta assistentes de IA à API do Unmarkdown. Converta markdown em documentos lindamente formatados, gerencie sua biblioteca de documentos e publique páginas na web, tudo de dentro do Claude, Cursor, VS Code ou qualquer cliente compatível com MCP.

Também disponível como: Extensão do Chrome | Aplicativo Web | API REST

Recursos

Converta markdown em HTML estilizado para 8 destinos: Google Docs, Word, Slack, OneNote, E-mail, Texto Puro, HTML genérico e HTML bruto
62 modelos visuais com temas claro e escuro (Suíço, Executivo, Terminal, GitHub e outros)
Crie, leia, atualize documentos na sua biblioteca do Unmarkdown, organizados em pastas
Publique documentos em URLs públicas compartilháveis em unmarkdown.com/d/your-slug
Acompanhe o uso da API e a cota do período de cobrança atual

Instalação

Claude Desktop / Claude para macOS

Adicione isto ao seu arquivo de configuração do Claude Desktop:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "unmarkdown": {
      "command": "npx",
      "args": ["-y", "@un-markdown/mcp-server"],
      "env": {
        "UNMARKDOWN_API_KEY": "um_your_api_key_here"
      }
    }
  }
}

Cursor

Adicione às configurações MCP do seu Cursor (.cursor/mcp.json):

{
  "mcpServers": {
    "unmarkdown": {
      "command": "npx",
      "args": ["-y", "@un-markdown/mcp-server"],
      "env": {
        "UNMARKDOWN_API_KEY": "um_your_api_key_here"
      }
    }
  }
}

VS Code

Adicione às configurações MCP do seu VS Code (.vscode/mcp.json):

{
  "servers": {
    "unmarkdown": {
      "command": "npx",
      "args": ["-y", "@un-markdown/mcp-server"],
      "env": {
        "UNMARKDOWN_API_KEY": "um_your_api_key_here"
      }
    }
  }
}

Instalação Global

Se preferir instalar globalmente em vez de usar npx:

npm install -g @un-markdown/mcp-server

Em seguida, use unmarkdown-mcp como comando em vez de npx:

{
  "mcpServers": {
    "unmarkdown": {
      "command": "unmarkdown-mcp",
      "env": {
        "UNMARKDOWN_API_KEY": "um_your_api_key_here"
      }
    }
  }
}

Configuração

Obrigatório

Variável	Descrição
`UNMARKDOWN_API_KEY`	Sua chave de API do Unmarkdown (começa com `um_`). Obtenha uma em Configurações > API na sua conta do Unmarkdown.

Opcional

Variável	Descrição	Padrão
`UNMARKDOWN_API_URL`	URL base personalizada da API	`https://api.unmarkdown.com`

Exemplos de Uso

Exemplo 1: Converter um rascunho de notas de reunião para Google Docs

"Pegue este markdown e converta para Google Docs usando o modelo Executivo:

# Reunião de Planejamento do Q1

## Participantes
- Sarah Chen (Produto)
- Mike Torres (Engenharia)
- Lisa Park (Design)

## Itens de Ação
- [ ] Finalizar o roadmap até sexta-feira
- [ ] Agendar revisão de design para o novo painel
- [ ] Atualizar a apresentação para as partes interessadas
```"

O Claude usará a ferramenta convert_markdown com destination: "google-docs" e template_id: "executive", retornando HTML estilizado pronto para colar no Google Docs com cabeçalhos, fontes e cores adequados.

Exemplo 2: Criar um documento em uma pasta

"Crie um novo documento chamado 'Changelog da API - Fevereiro de 2026' na minha pasta Notas de Lançamento com este conteúdo e depois publique-o."

O Claude irá:

Chamar create_document com o título, conteúdo markdown e folder: "Release Notes"
Chamar publish_document com o ID do documento retornado

O documento é criado diretamente na pasta especificada, e você recebe uma URL ativa como https://unmarkdown.com/d/api-changelog-february-2026.

Exemplo 3: Atualizar e mover um documento

"Mova o relatório do Q4 para a pasta Arquivo e atualize o título dele."

O Claude irá:

Chamar list_documents para encontrar o documento
Chamar update_document com o novo título e folder: "Archive"

Exemplo 4: Formatar markdown para Slack

"Converta esta atualização de projeto para o formato Slack para que fique boa quando eu colar no canal da nossa equipe."

O Claude usa convert_markdown com destination: "slack", produzindo uma saída otimizada para a renderização do Slack (negrito, listas, blocos de código, suporte a emojis).

Exemplo 5: Verificar o uso da API

"Quantas chamadas de API eu usei este mês?"

O Claude chama get_usage e retorna sua contagem de uso atual, limite mensal e período de cobrança.

Referência de Ferramentas

Ferramenta	Descrição	Somente leitura	Idempotente
`convert_markdown`	Converte markdown em HTML estilizado para qualquer um dos 8 destinos	Sim	Sim
`create_document`	Cria um novo documento na sua biblioteca (opcionalmente em uma pasta)	Não	Não
`list_documents`	Lista documentos salvos com paginação (opcionalmente filtrando por pasta)	Sim	Sim
`get_document`	Busca um documento por ID com conteúdo completo	Sim	Sim
`update_document`	Modifica o título, conteúdo, modelo, metadados ou pasta de um documento	Não	Sim
`publish_document`	Publica um documento em uma URL pública compartilhável	Não	Sim
`get_usage`	Verifica a cota da API para o mês de cobrança atual	Sim	Sim

Destinos

A ferramenta convert_markdown suporta estes formatos de saída:

Destino	Descrição
`google-docs`	Otimizado para colar no Google Docs
`word`	Formatado para Microsoft Word
`slack`	Formatação compatível com Slack
`onenote`	Compatível com Microsoft OneNote
`email`	HTML amigável para clientes de e-mail
`plain-text`	Texto puro com formatação ASCII
`generic`	HTML estilizado de uso geral
`html`	Saída HTML bruta

Modelos

Passe qualquer ID de modelo para convert_markdown, create_document ou update_document. Os modelos populares incluem:

Modelo	Categoria
`swiss`	Gratuito (padrão)
`mono`	Gratuito
`github`	Gratuito
`terminal`	Gratuito
`executive`	Empresarial (Pro)
`consulting`	Empresarial (Pro)
`startup`	Empresarial (Pro)

Navegue por todos os 62 modelos em unmarkdown.com/templates.

Limites da API

Plano	Chamadas de API Mensais	Limite de Taxa
Gratuito	1.000	10 req/seg
Pro ($8/mês anual)	10.000	30 req/seg

Excedente: US$ 1,00 por 1.000 chamadas adicionais (somente Pro). O plano gratuito tem um limite rígido.

Privacidade

Este servidor MCP envia seu conteúdo markdown e dados de documentos para a API do Unmarkdown (api.unmarkdown.com) para processamento. Nenhum dado é armazenado localmente pelo próprio servidor MCP. Todo o tratamento de dados é regido pela Política de Privacidade do Unmarkdown.

Especificamente:

Conteúdo markdown enviado via convert_markdown é processado e retornado imediatamente. Não é armazenado nos servidores do Unmarkdown.
Documentos criados via create_document ou update_document são armazenados na sua conta do Unmarkdown e podem ser excluídos a qualquer momento.
Chaves de API autenticam solicitações e nunca são registradas ou compartilhadas.

Para a política de privacidade completa, visite unmarkdown.com/privacy.

Suporte

Problemas: github.com/UnMarkdown/mcp-server/issues
Documentação: docs.unmarkdown.com
Referência da API: docs.unmarkdown.com/api/overview
Contato: unmarkdown.com/contact

Desenvolvimento

# Clone the repo
git clone https://github.com/UnMarkdown/mcp-server.git
cd mcp-server

# Install dependencies
npm install

# Build
npm run build

# Run locally (requires API key)
UNMARKDOWN_API_KEY=um_your_key node build/index.js

Veja Também

Extensão do Chrome — Detecte e converta markdown em qualquer página de chat de IA (ChatGPT, Claude, Gemini)
Aplicativo Web — Editor completo com 62 modelos, publicação, ações de IA e análises
API REST — Acesso programático a todos os recursos de conversão e documentos
Smithery — Instale via registro MCP do Smithery
npm — @un-markdown/mcp-server no npm

Licença

MIT. Consulte LICENSE para detalhes.