Converter Markdown em Word dentro do seu agente de IA

O servidor MCP do MD2Doc permite ao Claude Code, ao Cursor, ao Windsurf e a outros agentes de IA converter markdown em documentos Word direto — sem navegador, sem copiar e colar, sem trocar de contexto.

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

Endpoint: https://md2doc.com/mcp · Streamable HTTP · Free · No API key

Por que usar o MD2Doc via MCP?

A ferramenta no navegador é ótima para conversões avulsas. O servidor MCP é para desenvolvedores e usuários avançados que trabalham em ambientes de programação com IA todo dia.

⚡

Zero troca de contexto

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

🤖

Totalmente automatizado

Os agentes conseguem converter markdown em Word como parte de uma tarefa maior — escrever documentação, gerar relatórios, resumir pesquisas — sem nenhum passo 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 simplesmente funciona — em cada máquina que você usa.

Como funciona

1

Adicione o servidor uma vez

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

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

Fale com o seu agente com naturalidade

Sem sintaxe especial. É só descrever o que você quer e o agente chama o MD2Doc automaticamente.

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

Receba um link para baixar

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

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

Instalação pelo agente

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

Claude Code Recomendado

O Claude Code é a CLI oficial da Anthropic. Um comando instala o servidor de forma global.

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

That is Streamable HTTP — the current MCP remote transport. Verify with /mcp — md2doc should appear as connected.

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" } } }

Restart Claude Desktop after saving. Use "type": "http" — not SSE.

Cursor

Adicione o MD2Doc à 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 na pasta do projeto, para acesso só daquele projeto.

Windsurf

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

~/.codeium/windsurf/mcp_config.json

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

Reload Windsurf after saving the config. Point at /mcp, not /mcp/sse.

Hermes

Hermes and other HTTP-only agents should use the Streamable HTTP URL — this is the default, not a fallback:

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

POST JSON-RPC to that URL. Do not use /mcp/sse.

OpenClaw

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

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

Use Streamable HTTP at https://md2doc.com/mcp. Only use /mcp/sse if the client cannot speak HTTP.

Qualquer agente compatível com MCP

Use Streamable HTTP unless your client cannot. SSE is a deprecated fallback.

Recommended — Streamable HTTP:

https://md2doc.com/mcp

Legacy SSE (only if HTTP fails):

https://md2doc.com/mcp/sse

For JSON configs (Cline, Continue, Zed, etc.), add the server under "mcpServers" with "type": "http" and "url": "https://md2doc.com/mcp".

Arquivos Markdown grandes

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

# 1. Envio (os bytes do arquivo vão do disco para o 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 envio são de uso único, no máximo 5 MB, e expiram depois de 10 minutos.

Ferramentas disponíveis

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

convert_to_docx

Converte markdown em um arquivo Microsoft Word (.docx). Devolve uma URL temporária para baixar, válida por 10 minutos.

{ "name": "convert_to_docx", "arguments": { "markdown": "# Título\n\nConteúdo...", "filename": "meu-relatorio" } }

Retorna: URL para baixar + tamanho do arquivo

convert_to_pdf

Converte markdown em PDF, renderizado com o Chrome headless, para tabelas, blocos de código e tipografia baterem com a prévia do site. Devolve uma URL temporária para baixar, válida por 10 minutos. Ideal para documentos bem-acabados, só de leitura, para compartilhar, imprimir ou arquivar.

{ "name": "convert_to_pdf", "arguments": { "markdown": "# Título\n\nConteúdo...", "filename": "meu-relatorio" } }

Retorna: URL para baixar + tamanho do arquivo

convert_to_html

Converte markdown em um documento HTML independente e estilizado, com CSS embutido. Devolve uma URL temporária para baixar, 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": "# Título\n\nConteúdo...", "filename": "meu-relatorio" } }

Retorna: URL para baixar + tamanho do arquivo

preview_markdown

Converte markdown em uma prévia HTML que mostra exatamente como o documento Word vai ficar. Útil para agentes que precisam conferir o resultado antes de baixar.

{ "name": "preview_markdown", "arguments": { "markdown": "# Título\n\nConteúdo..." } }

Retorna: texto HTML

O que pedir ao seu agente

Com o MD2Doc conectado, você pede documentos Word com naturalidade. Eis pedidos que funcionam bem:

  • Converta este markdown em um arquivo Word e salve na minha Área de Trabalho
  • Pegue a saída do Claude e transforme num .docx que eu possa enviar para a 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 em um documento Word para a apresentação ao cliente
  • Gere notas de reunião a partir desta transcrição e baixe como .docx

Detalhes técnicos

Protocolo

MCP Streamable HTTP is the current remote transport. Point clients at https://md2doc.com/mcp (POST JSON-RPC). Legacy HTTP+SSE at /mcp/sse is kept for older clients only.

Rotas

# Streamable HTTP (recommended) POST /mcp # Legacy SSE connection GET /mcp/sse # Send JSON-RPC messages (SSE flow) POST /mcp/messages?sessionId=X # Out-of-band markdown upload POST /mcp/upload # Download generated file GET /mcp/download/{id}

Desempenho

O tempo típico de conversão fica abaixo de 2 segundos para documentos de até 100 KB de markdown. Os arquivos .docx gerados ficam armazenados por 10 minutos e depois são apagados automaticamente.

Privacidade

O conteúdo em markdown é enviado a md2doc.com para conversão e não é registrado nem retido. Os links para baixar são de uso único e expiram depois de 10 minutos.

Perguntas frequentes sobre MCP

O que é o MCP e por que isso importa?

O MCP (Model Context Protocol) é um padrão aberto da Anthropic que permite a agentes de IA se conectar a ferramentas e serviços externos. Em vez de descrever como usar uma ferramenta, os agentes a chamam direto — como uma chamada de função. Isso deixa os fluxos 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. É só adicionar a URL do servidor e começar a usar. Sem registro, sem cartão de crédito.

Which URL should I use?

Use https://md2doc.com/mcp (Streamable HTTP). That is the current MCP remote transport and the one HTTP-only connectors (Hermes, Estate, custom bots) can actually load. The old SSE URL at https://md2doc.com/mcp/sse still works for some Claude Code / Cursor setups, but it is deprecated — do not give it to a client that failed on SSE.

SSE isn't working. Now what?

Swap the URL to https://md2doc.com/mcp and set the transport to HTTP / Streamable HTTP. Do not GET that URL in a browser expecting JSON — the MCP protocol is POST. The website converter at md2doc.com still works if you skip MCP entirely.

Quais formatos de arquivo o MD2Doc produz?

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

Quais recursos de markdown são suportados?

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

Existe um limite de requisições?

No momento não há limite de requisições para um uso razoável. O serviço foi feito para fluxos de desenvolvimento e uso individual. Se você precisa de conversão em alto volume, fale com a gente.

Consigo 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 a documentação completa da API.

A outra metade da história do markdown dos agentes

FolderMD é o leitor para desktop que fizemos para o markdown longo que os agentes produzem. Chega de apertar os olhos em respostas de 400 linhas no terminal ou na janela do chat — os agentes escrevem direto numa experiência de leitura calma e bonita, feita exatamente para isso.

Visite foldermd.com →

Pronto para adicionar o MD2Doc ao seu agente?

Um comando. Grátis. Sem cadastro.

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

Ou use o conversor no navegador se você só precisa de uma conversão avulsa e rápida.

Precisa de mais conversões ao mesmo tempo ou está recebendo o erro "servidor ocupado"? Mande uma DM para @kirillzubovsky no X — montamos uma conta dedicada para você.