conv2pdf

Converta documentos do Office, imagens e e-books para PDF, converta PDFs para Word ou imagens, e mescle, comprima, proteja ou numere os PDFs do seu computador. Hospedado na França.

GitHub

Documentação

conv2pdf-mcp

Servidor oficial do Model Context Protocol da API conv2pdf. Seu assistente de IA converte arquivos Word, Excel, PowerPoint, Pages, imagens e e-books para PDF, converte PDFs para Word ou imagens, e mescla, compacta, protege, rotaciona ou numera os PDFs que estão no seu computador. O processamento é executado em servidores OVHcloud na França: sem transferência para fora da UE, nenhum serviço dos EUA na cadeia.

Instalação · Ferramentas · Como se comporta · Desenvolvimento

Instalação

Crie uma conta em conv2pdf.com. O plano Dev inclui 300 conversões gratuitas, válidas por 12 meses; veja preços para os planos pagos.
Crie uma chave de API, que começa com cpdf_live_, na aba Desenvolvedor do seu painel. A conv2pdf a mostra apenas uma vez, na criação.
Adicione o servidor ao seu cliente MCP, com a chave na variável de ambiente CONV2PDF_API_KEY. Ele precisa de Node.js 22 ou posterior.

No Claude Code:

claude mcp add --env CONV2PDF_API_KEY=cpdf_live_... --transport stdio conv2pdf -- npx -y conv2pdf-mcp

No Windows, coloque cmd /c antes de npx.

No Claude Desktop, Cursor e nos outros clientes configurados com um arquivo JSON:

{
  "mcpServers": {
    "conv2pdf": {
      "command": "npx",
      "args": ["-y", "conv2pdf-mcp"],
      "env": { "CONV2PDF_API_KEY": "cpdf_live_..." }
    }
  }
}

Ou, no Claude Code, instale o plugin: o mesmo servidor, com uma skill que informa ao assistente qual ferramenta chamar, em qual ordem, e quanto custa uma chamada.

/plugin marketplace add jamalofski/conv2pdf-mcp
/plugin install conv2pdf@conv2pdf

O Claude Code pede a chave de API quando o plugin é habilitado e a mantém no armazenamento de credenciais do sistema, não em um arquivo de configurações. Para defini-la depois, execute /plugin configure conv2pdf@conv2pdf, ou abra /plugin, aba Instalado, conv2pdf, Configurar opções. Um servidor adicionado manualmente com o comando npx -y conv2pdf-mcp tem precedência sobre o do plugin.

Para outro agente que carrega skills SKILL.md, adicione o servidor como acima e pegue apenas a skill: plugin/skills/conv2pdf/SKILL.md neste repositório, também listada na Agensi.

Depois, peça o que precisar: "converta report.docx para PDF", "mescle estes três PDFs", "compacte scan.pdf e proteja-o com uma senha".

Ferramentas

Ferramenta	O que faz
`convert_to_pdf`	Arquivo Word, Excel, PowerPoint, OpenDocument, Apple Pages, RTF, TXT, CSV, PNG, JPG, WebP, GIF, TIFF, HEIC ou EPUB para PDF, escolhido pela extensão
`convert_heic_to_jpg`	Foto HEIC ou HEIF do iPhone para JPG
`convert_pdf_to_word`	PDF com texto real para um documento DOCX editável
`convert_pdf_to_images`	Um PNG ou JPG por página, em um arquivo ZIP
`merge_pdfs`	Combinar vários PDFs em um só, na ordem fornecida
`extract_pdf_pages`	Manter as páginas que você listar, como `1-5,7,10-12`, em um novo PDF
`rotate_pdf`	Girar cada página em 90, 180 ou 270 graus
`add_page_numbers`	Numerar as páginas, como "3 / 12" ou "3", no rodapé central, à esquerda ou à direita
`add_watermark`	Carimbar um texto de até 50 caracteres em cada página
`compress_pdf`	Reduzir o tamanho, mantendo imagens em 72, 150 ou 300 DPI
`protect_pdf`	Definir uma senha e, opcionalmente, proibir impressão ou cópia
`unlock_pdf`	Remover uma senha que você conhece, ou as restrições de impressão e cópia
`get_quota`	Plano, uso e limites da chave de API

Como se comporta

Os arquivos permanecem no seu computador, exceto pela conversão. Uma ferramenta recebe o caminho de um arquivo, envia o arquivo para a conv2pdf e grava o resultado no seu disco. A conv2pdf verifica o conteúdo do arquivo, não apenas o nome.
Nada é sobrescrito. O resultado vai para junto do arquivo de entrada: report.docx gera report.pdf, e uma ferramenta de PDF adiciona um sufixo, como report-compressed.pdf. Quando esse nome já existe, o servidor grava report (2).pdf. O assistente pode escolher o local com output_path; se um arquivo já estiver lá, a ferramenta recusa antes de converter qualquer coisa.
Excluído do servidor. Assim que o resultado está no seu disco, o servidor exclui o job da conv2pdf. Se isso falhar, a conv2pdf exclui os arquivos após uma hora.
Cota. Cada conversão conta como uma na cota do seu plano, incluindo uma que a conv2pdf recusa após ler o arquivo, como um PDF ilegível ou escaneado, ou um com páginas demais. Um arquivo recusado na chegada (tipo errado, grande demais, senha ausente), uma configuração recusada (um intervalo de páginas que não existe, uma senha curta demais) e uma falha do lado da conv2pdf não contam, e get_quota é gratuito. Os arquivos podem pesar até 10 MB no plano Dev e 200 MB nos planos pagos.
Limite de taxa. A API aceita 20 conversões por minuto por chave de API. Quando ela pede para desacelerar, ou quando a fila está cheia, o servidor aguarda o atraso que a API informa e tenta novamente, no máximo duas vezes e apenas para atrasos de 30 segundos ou menos; caso contrário, o assistente recebe o atraso para aguardar.
PDFs protegidos. As ferramentas que leem um PDF, exceto merge_pdfs, abrem um que pede senha quando o assistente a passa como password. O resultado não tem senha. Para uma mesclagem, desbloqueie os PDFs protegidos primeiro.
Pages e Numbers. Um documento Pages mantém sua extensão .pages: apenas o nome o distingue de uma planilha Numbers, que a conv2pdf não converte, assim como apresentações Keynote.
Erros. Uma recusa volta ao assistente como uma frase sobre a qual ele pode agir: a senha errada, o intervalo de páginas que não existe, o limite do plano, a chave a definir. Uma chamada cancelada interrompe a transferência e não deixa nenhum arquivo para trás.
Sem chave. O servidor inicia e lista suas ferramentas; uma chamada explica como definir CONV2PDF_API_KEY.

Cada solicitação carrega User-Agent: conv2pdf-mcp/<version>. Mencione-o ao contatar o suporte: ele distingue suas chamadas nos logs da API.

Desenvolvimento

O servidor não tem dependências: o Node.js executa os fontes como estão. Ele conversa com o cliente via stdio e atende às duas eras do protocolo no mesmo processo: revisão 2026-07-28, em que cada solicitação carrega sua versão de protocolo, e as revisões anteriores (2025-11-25 até 2024-11-05), que começam com um handshake initialize.

npm test

executa os testes contra uma API conv2pdf falsa em uma porta local: não são necessários chave nem rede.

npm run check-tools

compara as extensões que as rotas convert_to_pdf usam com o que a API ao vivo aceita (GET /v1/tools).

Plugin

plugin/ contém o plugin do Claude Code: seu manifesto, o .mcp.json que inicia o pacote publicado com npx, e a skill, plugin/skills/conv2pdf/SKILL.md. .claude-plugin/marketplace.json é o catálogo que permite ao Claude Code instalar o plugin deste repositório. Nenhum deles faz parte do pacote npm. npm test verifica se o plugin está na versão do pacote e se a skill nomeia as ferramentas que o servidor possui.

claude plugin validate . --strict
claude --plugin-dir ./plugin

verificam os manifestos e depois iniciam uma sessão com o plugin carregado da pasta, sem instalá-lo. Um usuário recebe uma alteração do plugin ou da skill quando a versão muda: ela acompanha um lançamento.

Lançamento

Defina a versão em package.json, server.json e plugin/.claude-plugin/plugin.json, e date sua seção em CHANGELOG.md.
Execute npm test e npm run check-tools.
Faça commit e depois envie uma tag nomeada conforme a versão: o fluxo de trabalho Publish publica o pacote no npm via Trusted Publishing, com uma declaração de procedência.
Publique a entrada do MCP Registry: mcp-publisher login http --domain conv2pdf.com, depois mcp-publisher publish. O nome com.conv2pdf/conv2pdf é comprovado pela chave pública servida em https://conv2pdf.com/.well-known/mcp-registry-auth.
Quando a skill mudar, envie-a novamente para sua listagem na Agensi, como uma nova versão: um ZIP de uma pasta conv2pdf/ que contém o SKILL.md. Nada atualiza a listagem a partir deste repositório.

Recursos

Suporte

Abra uma issue ou escreva para contact@conv2pdf.com.

Licença

MIT, veja LICENSE.