Converta Arquivos no Claude e no Cursor com o GuruPDF MCP

O seu agente de programação consegue montar uma app, desenredar um stack trace e discutir consigo sobre tabs versus espaços. Mas entregue-lhe um PDF e peça um documento Word editável, e trava. Os ficheiros vivem no seu disco; o modelo vive no chat. Nada liga os dois.

Essa lacuna é precisamente a razão pela qual criámos o GuruPDF MCP — um pequeno servidor que dá ao Claude, ao Cursor e a qualquer outro cliente MCP uma forma de converter ficheiros de verdade. Coloque um caminho no prompt, diga o que quer, e o ficheiro convertido aterra de volta no seu disco um instante depois. Sem ecrã de envio, sem "descarregue e depois volte a carregá-lo noutro sítio." Apenas "converta ~/contracts/lease.pdf para Word."

O que é realmente um MCP de conversão de ficheiros

MCP — o Model Context Protocol — é o conector que permite a um agente de IA usar ferramentas fora da sua própria cabeça. Um servidor expõe algumas ações; o agente invoca-as quando o seu prompt precisa delas. Existem servidores MCP para bases de dados, navegadores, GitHub.

Não havia nenhum bom para ficheiros. Assim, um PDF MCP — na verdade um MCP de conversão de ficheiros, já que vai muito além do PDF — é simplesmente um servidor que recebe um ficheiro num formato e devolve outro. PDF para Word. Uma pasta de imagens para um único PDF. Uma página digitalizada para texto pesquisável. O agente faz o pedido; o GuruPDF faz a conversão.

Por baixo é o mesmo motor por detrás de gurupdf.com: 126 ferramentas, mais de 100 formatos, agora acessíveis a partir do interior do seu editor.

Configure-o em cerca de dois minutos

Precisa de duas coisas: Node (para npx) e uma chave de API gratuita do GuruPDF. Obtenha uma chave em gurupdf.com/profile — as contas gratuitas vêm com créditos diários, por isso pode começar a converter de imediato.

O servidor instala-se e executa-se sozinho através de npx; não há nada para clonar:

bash

npx gurupdf-mcp

Mas não vai executar isso à mão — aponta o seu cliente MCP para ele. Para Cursor, Claude Desktop, VS Code ou Windsurf, acrescente isto à sua configuração MCP:

json

{
  "mcpServers": {
    "gurupdf": {
      "command": "npx",
      "args": ["-y", "gurupdf-mcp"],
      "env": { "GURUPDF_API_KEY": "your-token-here" }
    }
  }
}

Reinicie o cliente e o seu agente ganha, em silêncio, quatro ferramentas: converter um ficheiro, consultar uma tarefa, listar o que é suportado e verificar o saldo de créditos. É toda a configuração.

O que pode realmente fazer com ele

Esta é a parte divertida. Assim que estiver ligado, estes são prompts reais que simplesmente funcionam:

"Converta ~/Downloads/invoice.pdf para Word para eu poder editar os totais." — um .docx editável aparece ao lado do original.
"Transforme todas as capturas de ecrã em ~/shots num único PDF." — imagens unidas, por ordem, num só ficheiro.
"Este scan é só uma imagem. Faça OCR e dê-me o texto." — texto real extraído dos píxeis.
"Comprima report.pdf, tem 40 MB e preciso de o enviar por e-mail." — um ficheiro mais pequeno que continua legível.
"Faça um PDF de https://example.com/pricing." — a página ao vivo, renderizada para PDF.

Nunca memoriza nomes de ferramentas nem formatos. Diga o objetivo em linguagem simples e o servidor escolhe qual das 126 ferramentas se adequa, executa-a e escreve o resultado no disco. Unir, dividir, rodar, proteger com palavra-passe, marca de água, Excel ↔ PDF, HEIC → JPG — está tudo lá.

Responde quando algo não está bem

A maioria dos conversores falha com um código críptico. Este foi feito para se explicar através do seu agente, porque o agente é quem está a ler a resposta.

Se ficar sem créditos no plano gratuito, não recebe um mero 402. Recebe uma frase que o seu assistente lhe transmite: atingiu o limite gratuito (2 conversões por minuto, 10 por dia), reinicia amanhã, e aqui está um link se preferir não esperar. Passe a uma ferramenta o formato errado, ou um ficheiro demasiado grande, e diz-lhe exatamente isso — por palavras, não com um número de erro. Nunca tem de sair da conversa para perceber o que aconteceu.

Essa ideia de "explicar através do agente" é também a razão pela qual cuidamos tanto da redação. Uma mensagem de erro que nenhum humano chega a ler ainda tem de fazer sentido para o modelo que a retransmite.

O que está por baixo

126 ferramentas, mais de 100 formatos. PDF, Word, Excel, PowerPoint, imagens, e-books, até vídeo — o mesmo motor do website.
Um plano gratuito a sério. Cada conta recebe créditos diários. Existem planos pagos e pacotes de créditos para uso mais intensivo, e o seu agente aponta-os quando realmente faz sentido, não antes.
Os ficheiros não permanecem. Tudo transita por HTTPS e é eliminado no prazo de uma hora. O MCP escreve o resultado no seu disco; a cópia do nosso lado desaparece pouco depois.
Código aberto. O servidor tem licença MIT, está publicado no npm e consta do registo oficial de MCP, por isso pode ler cada linha antes de o executar.

Obtenha-o

Se passa o dia no Claude ou no Cursor e anda sempre a saltar para algum site conversor, isto elimina a ida e volta.

Instalação: npx gurupdf-mcp
Pacote: npmjs.com/package/gurupdf-mcp
Registo: pesquise "GuruPDF" no registo oficial de MCP
Chave de API: gurupdf.com/profile

Adicione-o uma vez e esqueça que está lá — até à próxima vez em que teria aberto um separador do browser para converter um ficheiro, e o seu agente simplesmente o faz por si.