Um agente de IA deve escolher qual arquivo converter e para qual formato, e um mecanismo de conversão deve fazer a conversão. Com o servidor GroupDocs.Conversion.Mcp, Claude, Cursor ou GitHub Copilot chamam esse mecanismo localmente, na sua máquina, a partir de uma frase:

Convert contract.docx to PDF

A versão passo a passo com configuração e solução de problemas está na documentação: How to convert documents with AI agents using MCP. Esta postagem explica por que a divisão é importante e onde o agente deve ficar fora do caminho.

O que dá errado quando um agente converte um arquivo por conta própria?

Um modelo de linguagem que “converte” um PDF para Word não converte nada. Ele lê o conteúdo que recebeu e escreve novo conteúdo no formato de destino. O que o modelo não viu, ele não pode reproduzir: a fonte exata, a geometria das colunas, a quebra de página antes de uma tabela, os nomes de estilos dos quais um modelo Word depende. O que volta parece uma conversão, mas é uma reescrita.

Esse é o modo de falha sobre o qual esta postagem trata. É silencioso: a saída abre sem erros, então ninguém a verifica até que uma tabela tenha sido deslocada ou um título tenha perdido seu estilo. A fidelidade de renderização é trabalho determinístico do mecanismo, não trabalho de geração.

O que o agente deve decidir e o que o mecanismo deve fazer?

Divida o trabalho ao longo da linha entre julgamento e execução.

Pergunta O agente decide O mecanismo faz
Quais arquivos estão no escopo? Lê seu prompt e a pasta de armazenamento Nada
Qual formato de destino? Mapeia “torne editável” para DOCX, “arquive” para PDF Nada
O arquivo é convertível? Chama get_supported_formats e lê a resposta Relata os formatos de destino válidos
Qual o tamanho do arquivo? Chama get_document_info e lê a contagem de páginas Lê tipo, contagem de páginas, propriedades
A própria conversão Chama convert Renderiza a saída com o mecanismo GroupDocs.Conversion
O que fazer em caso de falha Tenta novamente, pergunta a você ou ignora o arquivo Retorna o motivo como texto

O agente nunca toca nos bytes do seu documento. Ele passa um nome de arquivo e um formato, e o mecanismo devolve um arquivo.

Como conectar um agente ao mecanismo localmente?

Registre o servidor uma única vez no seu cliente. Claude Desktop usa claude_desktop_config.json, Claude Code usa claude mcp add, VS Code com GitHub Copilot usa mcp.json e Cursor usa ~/.cursor/mcp.json. O servidor também oferece suporte a Visual Studio 2022, Windsurf, Cline, Codex CLI e JetBrains Rider. Uma entrada do Claude Desktop se parece com isto:

{
  "mcpServers": {
    "groupdocs-conversion": {
      "type": "stdio",
      "command": "dnx",
      "args": ["GroupDocs.Conversion.Mcp", "--yes"],
      "env": { "GROUPDOCS_MCP_STORAGE_PATH": "/path/to/documents" }
    }
  }
}

dnx requer o SDK .NET 10. Se preferir Docker, a imagem autocontida é ghcr.io/groupdocs-conversion/conversion-net-mcp:latest, executada com docker run --rm -i -v $(pwd)/documents:/data na frente dela. O cliente se comunica com o servidor via stdio: o caminho é agente → servidor local → sistema de arquivos local. Reinicie o cliente após registrar.

Qual ferramenta cada solicitação aciona?

O servidor expõe quatro ferramentas. Seus nomes são literais; os agentes os procuram quando algo falha.

  • convert converte um documento para outro formato e salva o resultado no seu armazenamento ou pasta de saída. Recebe file, format (por exemplo pdf, docx, xlsx, pptx, html, png, jpg, csv, txt, rtf, md) e um password opcional.
  • get_supported_formats lista os formatos de destino que um determinado arquivo de origem pode assumir.
  • get_document_info devolve tipo de arquivo, contagem de páginas e propriedades básicas sem converter.
  • get_license_status informa se o servidor está em modo de avaliação, com arquivo de licença ou em modo medido.

Promptes abertos funcionam porque o agente os encadeia:

Quais formatos posso transformar este arquivo Visio? Então converta‑o para PDF.

Verifique a contagem de páginas de whitepaper.pdf primeiro, depois converta‑o para DOCX.

Arquivos existentes nunca são sobrescritos. Uma segunda conversão do mesmo arquivo recebe um nome distinto, como report (1).pdf.

Sessão de exemplo

Esta é uma sessão abreviada e ilustrativa construída a partir das descrições das ferramentas na documentação, não uma captura de tela.

You:    Convert contract-draft.pdf to DOCX so I can edit it.
Agent:  [calls convert with file.filePath = "contract-draft.pdf", format = "docx"]
Agent:  Done. The converted file is saved as contract-draft.docx in your output folder.

Para o fluxo completo, o n8n walkthrough mostra o mesmo mecanismo acionado por um workflow em vez de um chat, e o announcement cobre o servidor de forma geral.

Quais são os limites?

  • Modo de avaliação. Sem licença, o servidor adiciona uma marca d’água de avaliação ao output convertido e limita cada processo do servidor a 15 documentos abertos; reiniciar o servidor zera a contagem. Pergunte ao seu agente “qual é o status da licença do servidor de conversão?” primeiro; get_license_status responde sem processar um documento.
  • Sem OCR. O servidor converte documentos que possuem camada de texto. Uma digitalização salva como PDF somente de imagem não será convertida em texto editável.
  • Conversão, não extração. Este servidor transforma documentos inteiros. Para extração de dados a nível de campo, o servidor complementar GroupDocs.Parser.Mcp (disponível apenas como imagem Docker) é a escolha mais adequada, e muitos pipelines utilizam ambos.

FAQ

Claude pode converter um docx para pdf?
Sim, com um servidor de conversão conectado. Claude chama convert com format: "pdf", e o mecanismo GroupDocs produz o arquivo na sua máquina.

Meus arquivos são enviados quando um agente os converte?
Não com este servidor. Ele roda localmente via stdio, e os documentos permanecem na sua pasta de armazenamento. Seu arquivo de licença também é lido do disco local.

Quais formatos o servidor pode converter?
Mais de 100 formatos de documentos, planilhas, apresentações, imagens, e‑mails, CAD e web, o mesmo conjunto da biblioteca GroupDocs.Conversion .NET. Pergunte get_supported_formats para obter a lista exata para um arquivo específico.

Aprofunde