Primeiros passos com o pdfmcp

Três formas locais de usar o pdfmcp: ferramentas da web gratuitas no seu dispositivo, o servidor MCP local para agentes de IA e a API local a partir do seu próprio código, cada uma pronta em cerca de um minuto.

Três formas de usar o pdfmcp, todas locais

O pdfmcp é uma caixa de ferramentas com três portas, e as três estão do seu lado. As ferramentas da web deste site rodam no seu navegador, no seu dispositivo: seu arquivo nunca é enviado e você não precisa se cadastrar em nada. O servidor MCP local expõe as mesmas operações como ferramentas tipadas que agentes de IA como Claude e Cursor podem chamar diretamente, rodando na sua máquina. E a API local permite chamar as mesmas operações a partir do seu próprio código, também na sua máquina.

As três são gratuitas para sempre. Sem plano pago, sem marca d'água, sem relógio de teste, sem conta, sem chave e sem cota diária: seu dispositivo faz o trabalho, então seu dispositivo é o único limite prático.

Forma 1: Use uma ferramenta da web (sem cadastro)

Abra o índice de ferramentas e escolha o que você precisa: unir, dividir, comprimir, converter, OCR, assinar, redigir e mais. Ferramentas marcadas como «No seu dispositivo» processam seu arquivo por completo nesta aba do navegador: solte o arquivo, ajuste as opções e baixe o resultado. Nada é transmitido a nós, então não há nada para armazenar, registrar ou vazar.

Algumas operações precisam de maquinaria pesada (OCR completo, conversão de Office, criptografia). Essas páginas são marcadas como «Local · MCP» e explicam como executar o trabalho localmente com o pacote, na sua máquina, com a mesma privacidade.

Forma 2: Instale o pacote local

O pacote é instalado uma única vez com o comando de instalação da página MCP. Depois, roda por completo na sua máquina: sem conta para criar, sem chave para copiar e nada que expire.

Os mecanismos pesados (qpdf, dados de idioma de OCR) são baixados uma única vez, com verificação SHA-256, no primeiro uso e ficam na sua máquina para os usos seguintes.

Forma 3: Conecte o servidor MCP local ao seu agente de IA

O servidor MCP roda localmente (stdio) na mesma máquina que seu agente. A maioria dos clientes aceita esta forma de configuração, que faz o cliente iniciar o pacote por você:

{"mcpServers": {"pdfmcp": {"command": "uvx", "args": ["--from", "https://pdfmcp.org/downloads/pdfmcp-4.2.1-py3-none-any.whl", "pdfmcp"]}}}

Reinicie seu cliente depois de editar sua configuração; as ferramentas do pdfmcp aparecerão na lista dele. Há guias passo a passo para 13 clientes (Claude Desktop, Claude Code, ChatGPT, Cursor, VS Code, Windsurf, Codex, Gemini CLI, Zed, Cline, Continue, JetBrains e qualquer outro cliente MCP) linkados a partir da página MCP. O ChatGPT não pode iniciar processos locais, então dentro do ChatGPT não há porta local: use um dos clientes locais.

Sua primeira chamada local

A partir do seu próprio código ou do seu terminal, o fluxo é o mesmo de sempre, mas sem servidor remoto: instale o pacote, escolha uma operação e execute-a sobre um arquivo da sua máquina. A operação lê o arquivo localmente e escreve o resultado localmente.

O catálogo de operações deste site (cada operação, seus parâmetros e esquemas) também descreve o pacote local, porque é o mesmo catálogo: o que você vê nas páginas de ferramentas é o que seu agente e seu código podem chamar.

Limites e privacidade, a sério

Os únicos limites são os do seu dispositivo: memória, velocidade e, no navegador, arquivos de até cerca de 100 MB e 500 páginas. Não há cota para gastar nem fila para esperar.

A privacidade é arquitetural. Tudo roda localmente, então seus arquivos nunca saem da sua máquina, nunca são armazenados em nenhum servidor e nunca são usados para treinar IA. A única coisa que este site coleta é análise de páginas (visualizações e Google Analytics agregado), que nunca toca seus documentos.

Conecte seu agente de IA — servidor MCP local gratuito

Perguntas frequentes

O pdfmcp é realmente gratuito?

Sim, grátis para sempre. Todas as ferramentas rodam localmente, sem conta e sem marca d'água. Não há plano pago: uma caixa de doações opcional (atualmente desativada) é todo o modelo de negócio.

Preciso de uma conta?

Não. Não há contas no pdfmcp: nem para as ferramentas da web, nem para o servidor MCP local, nem para a API local.

Para onde vão meus arquivos?

Para lugar nenhum: o processamento acontece no seu dispositivo ou na sua máquina, e seus arquivos nunca são enviados nem usados para treinar IA.

Como meu agente chama o servidor MCP local?

Seu cliente inicia o pacote pdfmcp como um processo local (stdio) com a configuração dos guias. Não há nenhum cabeçalho secreto para configurar, porque não há nenhum servidor remoto.

Há algum limite diário?

Não. Sem cota diária, sem ritmo por hora e sem contador: seu dispositivo é o único limite prático.

Posso usar o pdfmcp off-line?

Em grande parte sim: depois que a página e suas bibliotecas carregam, as ferramentas da web funcionam no seu navegador, e o pacote local funciona na sua máquina. Apenas os downloads de mecanismos no primeiro uso precisam de conexão.

Publicado originalmente em https://pdfmcp.org/guides/getting-started/