MD2Doc

npx add-mcp 'https://md2doc.com/mcp'

Converta Markdown para Word Dentro do Seu Agente de IA

O servidor MCP do MD2Doc permite que Claude Code, Cursor, Windsurf e outros agentes de IA convertam markdown para documentos Word diretamente — sem navegador, sem copiar e colar, sem alternância de contexto.

claude mcp add --transport http md2doc https://md2doc.com/mcp

Endpoint: https://md2doc.com/mcp · HTTP Streamable · Grátis · Sem chave de API

Por que usar o MD2Doc via MCP?

A ferramenta de navegador é ótima para conversões pontuais. O servidor MCP é para desenvolvedores e usuários avançados que trabalham em ambientes de codificação de IA todos os dias.

⚡

Zero Alternância de Contexto

Fique no Claude Code, Cursor ou Windsurf. Peça um documento Word e receba um link de download sem sair do seu editor.

🤖

Totalmente Automatizado

Os agentes podem converter markdown para Word como parte de uma tarefa maior — escrever documentação, gerar relatórios, resumir pesquisas — sem nenhuma etapa manual.

☁️

Nada para Instalar Localmente

O servidor MCP roda em md2doc.com. Sem binário, sem Docker, sem atualizações. Adicione a URL uma vez e funciona — em todas as máquinas que você usa.

Como Funciona

1

Adicione o servidor uma vez

Execute o comando de instalação no seu terminal. Leva 10 segundos. A URL é registrada na configuração do seu agente.

claude mcp add --transport http md2doc https://md2doc.com/mcp

2

Peça ao seu agente de forma natural

Sem sintaxe especial. Basta descrever o que você quer e o agente chama o MD2Doc automaticamente.

"Converta este markdown para um arquivo Word e salve na minha Área de Trabalho"

3

Obtenha um link de download

O MD2Doc converte o arquivo no servidor e retorna um link de download de uso único. Válido por 10 minutos. Clique e salve.

https://md2doc.com/mcp/download/abc123

Instalação por Agente

O MD2Doc funciona com qualquer agente compatível com MCP. Escolha o seu abaixo.

Claude Desktop

Edite o arquivo de configuração do Claude Desktop e adicione o servidor md2doc:

Mac: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows: %APPDATA%\Claude\claude_desktop_config.json

{ "mcpServers": { "md2doc": { "type": "http", "url": "https://md2doc.com/mcp" } } }

Reinicie o Claude Desktop após salvar. Use "type": "http" — não SSE.

Cursor

Adicione o MD2Doc à sua configuração global de MCP do Cursor. Crie ou edite o arquivo:

~/.cursor/mcp.json

{ "mcpServers": { "md2doc": { "type": "http", "url": "https://md2doc.com/mcp" } } }

Ou adicione a um .cursor/mcp.json no diretório do seu projeto para acesso restrito ao projeto.

Windsurf

Edite o arquivo de configuração MCP do Windsurf:

~/.codeium/windsurf/mcp_config.json

{ "mcpServers": { "md2doc": { "url": "https://md2doc.com/mcp" } } }

Recarregue o Windsurf após salvar a configuração. Aponte para /mcp, não para /mcp/sse.

Hermes

O Hermes e outros agentes somente HTTP devem usar a URL Streamable HTTP — este é o padrão, não um fallback:

mcp_servers: md2doc: url: "https://md2doc.com/mcp"

Envie JSON-RPC via POST para essa URL. Não use /mcp/sse.

OpenClaw

O OpenClaw registra servidores MCP pela CLI. Um comando e o md2doc está disponível em qualquer sessão:

openclaw mcp set md2doc '{"url":"https://md2doc.com/mcp"}'

Use Streamable HTTP em https://md2doc.com/mcp. Use /mcp/sse apenas se o cliente não conseguir falar HTTP.

Qualquer agente compatível com MCP

Use Streamable HTTP, a menos que seu cliente não consiga. SSE é um fallback obsoleto.

Recomendado — Streamable HTTP:

https://md2doc.com/mcp

SSE legado (apenas se HTTP falhar):

https://md2doc.com/mcp/sse

Para configurações JSON (Cline, Continue, Zed, etc.), adicione o servidor em "mcpServers" com "type": "http" e "url": "https://md2doc.com/mcp".

Arquivos Markdown Grandes

Para markdown acima de ~50KB, os agentes podem enviar o arquivo fora de banda para que o conteúdo nunca entre no orçamento de tokens de chamada de ferramenta do agente. O agente executa um comando de shell, recebe um ID curto e passa esse ID para convert_to_docx:

# 1. Upload (os bytes do arquivo fluem do disco → servidor, o agente nunca os lê) curl -F [email protected] https://md2doc.com/mcp/upload # → {"id":"abc..."} # 2. Chame a ferramenta com markdown_upload_id em vez de markdown convert_to_docx({ markdown_upload_id: "abc...", filename: "report" })

Os IDs de upload são de uso único, máx. 5MB e expiram após 10 minutos.

Ferramentas Disponíveis

O servidor MCP do MD2Doc expõe quatro ferramentas que seu agente pode chamar:

convert_to_docx

Converte markdown para um arquivo Microsoft Word (.docx). Retorna uma URL de download temporária válida por 10 minutos.

{ "name": "convert_to_docx", "arguments": { "markdown": "# Title\n\nContent...", "filename": "my-report" } }

Retorna: URL de download + tamanho do arquivo

convert_to_pdf

Converte markdown para PDF, renderizado via Chrome headless para que tabelas, blocos de código e tipografia correspondam à pré-visualização no site. Retorna uma URL de download temporária válida por 10 minutos. Ideal para documentos polidos e somente leitura para compartilhar, imprimir ou arquivar.

{ "name": "convert_to_pdf", "arguments": { "markdown": "# Title\n\nContent...", "filename": "my-report" } }

Retorna: URL de download + tamanho do arquivo

convert_to_html

Converte markdown para um documento HTML independente com estilo e CSS embutido. Retorna uma URL de download temporária válida por 10 minutos. Use para incorporar em um site, colar em um CMS ou enviar como corpo de e-mail.

{ "name": "convert_to_html", "arguments": { "markdown": "# Title\n\nContent...", "filename": "my-report" } }

Retorna: URL de download + tamanho do arquivo

preview_markdown

Converte markdown para uma pré-visualização em HTML mostrando exatamente como o documento Word ficará. Útil para agentes que precisam verificar a saída antes de baixar.

{ "name": "preview_markdown", "arguments": { "markdown": "# Title\n\nContent..." } }

Retorna: string HTML

O Que Pedir ao Seu Agente

Depois que o MD2Doc estiver conectado, você pode pedir documentos Word naturalmente. Aqui estão prompts que funcionam bem:

• Converta este markdown para um arquivo Word e salve na minha Área de Trabalho
• Pegue a saída do Claude e transforme em um .docx que eu possa enviar para minha equipe
• Escreva uma proposta de projeto em markdown e baixe como documento Word
• Resuma esta pesquisa e exporte como um arquivo Word formatado
• Converta meu README.md para um documento Word para a apresentação ao cliente
• Gere notas de reunião a partir desta transcrição e baixe como .docx

FAQ do MCP

O que é MCP e por que isso importa?

MCP (Model Context Protocol) é um padrão aberto da Anthropic que permite que agentes de IA se conectem a ferramentas e serviços externos. Em vez de descrever como usar uma ferramenta, os agentes a chamam diretamente — como uma chamada de função. Isso torna os fluxos de trabalho mais rápidos, mais confiáveis e totalmente automatizados.

Preciso de uma chave de API?

Não. O servidor MCP do MD2Doc é gratuito e aberto. Basta adicionar a URL do servidor e começar a usar. Sem registro, sem cartão de crédito.

Qual URL devo usar?

Use https://md2doc.com/mcp (Streamable HTTP). Esse é o transporte remoto atual do MCP e o único que conectores somente HTTP (Hermes, Estate, bots personalizados) conseguem carregar. A URL SSE antiga em https://md2doc.com/mcp/sse ainda funciona para algumas configurações do Claude Code / Cursor, mas está obsoleta — não a forneça a um cliente que falhou com SSE.

SSE não está funcionando. E agora?

Troque a URL para https://md2doc.com/mcp e defina o transporte como HTTP / Streamable HTTP. Não acesse essa URL no navegador esperando JSON — o protocolo MCP usa POST. O conversor do site em md2doc.com ainda funciona se você pular o MCP completamente.

Quais formatos de arquivo o MD2Doc produz?

A ferramenta convert_to_docx produz um arquivo .docx padrão compatível com Microsoft Word 2010 e versões posteriores, Google Docs, LibreOffice e todos os principais editores de documentos.

Quais recursos de markdown são suportados?

Cabeçalhos (H1–H6), negrito, itálico, tachado, listas ordenadas e não ordenadas, tabelas, blocos de código cercados, código inline, citações em bloco e hiperlinks. Os mesmos recursos do conversor web.

Existe limite de taxa?

Atualmente não há limite de taxa para uso razoável. O serviço foi projetado para fluxos de trabalho de desenvolvedores e uso individual. Se você precisar de conversão em alto volume, entre em contato conosco.

Posso usar isso no meu próprio aplicativo?

Sim. A API REST em https://md2doc.com/convert e https://md2doc.com/download-docx também está disponível para uso programático. Veja LLM.md para documentação completa da API.

A outra metade da história de markdown para agentes

FolderMD é o leitor de desktop que criamos para markdown de formato longo que os agentes produzem. Chega de apertar os olhos para respostas de 400 linhas em um terminal ou janela de chat — os agentes podem escrever diretamente em uma experiência de leitura calma e bonita, projetada exatamente para isso.