PDFMakerAPI

Gere PDFs como faturas, recibos, documentos, cartas e propostas usando linguagem natural e obtenha um link para visualizar, editar ou compartilhar seu PDF.

Documentação

Servidor MCP PDFMakerAPI

npm smithery badge Glama score Add to Cursor Install in VS Code

Um servidor MCP para PDFMakerAPI. Ele expõe uma única ferramenta create_document que transforma uma descrição de documento em inglês simples em um link compartilhável que abre no editor do PDFMakerAPI — visualize, edite qualquer campo e baixe o PDF.

Funciona com Claude Desktop, Claude.ai, Cursor, Windsurf, Cline, Zed, VS Code, ChatGPT e qualquer outro cliente MCP. É um cliente leve da API pública em https://api.pdfmakerapi.com, portanto não precisa de conta ou credenciais próprias.

O que é PDFMakerAPI?

PDFMakerAPI é um construtor de modelos de PDF e uma API de geração de PDF. Em vez de codificar documentos manualmente ou lidar com conversores de HTML para PDF que quebram quando o conteúdo muda, você cria um modelo reutilizável uma vez em um editor visual, sem código — posicionando texto, tabelas, imagens e campos dinâmicos exatamente onde deseja — e depois fornece dados para produzir um PDF final editável.

Gere um único documento ou milhares. Preencha um modelo você mesmo, compartilhe um link para que qualquer pessoa o complete no navegador como um formulário PDF preenchível, envie JSON para a API REST, acione a geração a partir de ferramentas sem código como Zapier, Make e n8n, ou crie documentos diretamente de agentes de IA como Claude e ChatGPT. Prefere começar a partir de um prompt? Descreva o que você precisa e deixe o Quill construir.

Equipes usam PDFMakerAPI para faturas, recibos, certificados, relatórios e contratos — qualquer coisa que você reconstruiria manualmente toda vez que os dados mudam. Comece a criar gratuitamente com 100 PDFs por mês.

Instalação rápida

Com um clique:

Add to Cursor Install in VS Code

Ou adicione a mesma configuração manualmente (funciona em todos os clientes desktop):

{
  "mcpServers": {
    "pdfmakerapi": {
      "command": "npx",
      "args": ["-y", "@pdfmakerapi/mcp"]
    }
  }
}

Configuração por cliente

Claude Desktop

Configurações → Desenvolvedor → Editar Config (claude_desktop_config.json), adicione o bloco mcpServers acima e reinicie o Claude.

Cursor

Use o botão Adicionar ao Cursor ou adicione o bloco a ~/.cursor/mcp.json (global) ou .cursor/mcp.json (por projeto).

Windsurf

Adicione o bloco a ~/.codeium/windsurf/mcp_config.json (ou via Configurações → Cascade → MCP).

Cline

Cline → Servidores MCP → Configurar e adicione o bloco mcpServers.

VS Code

Use o botão Instalar no VS Code ou adicione a .vscode/mcp.json (nota: o VS Code usa uma chave servers):

{
  "servers": {
    "pdfmakerapi": { "command": "npx", "args": ["-y", "@pdfmakerapi/mcp"] }
  }
}
Zed

Em settings.json:

{
  "context_servers": {
    "pdfmakerapi": { "command": { "path": "npx", "args": ["-y", "@pdfmakerapi/mcp"] } }
  }
}

Opção hospedada (remota) — sem instalação

Se o seu cliente suporta servidores MCP remotos, basta apontá-lo para o endpoint hospedado — sem npx, sem Node:

https://api.pdfmakerapi.com/mcp
  • Claude.ai (web): Configurações → Conectores → Adicionar conector personalizado → cole a URL.
  • ChatGPT (Plus/Pro/Enterprise): Configurações → Conectores → adicione a URL.
  • Cursor / outros: adicione { "url": "https://api.pdfmakerapi.com/mcp" } em vez de command/args.

Uso

Peça ao seu assistente um documento:

"Crie uma fatura profissional para a Acme com 3 itens de linha." "Crie um certificado de conclusão de curso." "Monte um currículo limpo de uma página."

Ele chama create_document e retorna um link como https://app.pdfmakerapi.com/d/<id> — abra-o para visualizar, editar qualquer campo e baixar o PDF.

Configuração

Variável de ambientePadrãoFinalidade
PDFMAKERAPI_BASE_URLhttps://api.pdfmakerapi.comAponte para uma API diferente (ex.: http://localhost:3001 para desenvolvimento local).

Desenvolvimento

git clone https://github.com/GerardoBarrera/pdfmakerapi-mcp.git
cd pdfmakerapi-mcp
npm install
npm run build   # compile to dist/
npm run dev     # run from source (tsx)

Solução de problemas

  • O servidor não aparece no seu cliente — reinicie o cliente após editar a configuração MCP e verifique se o JSON é válido (sem vírgulas finais). Para clientes remotos, confirme se a URL é exatamente https://api.pdfmakerapi.com/mcp.
  • npx falha ao iniciar — certifique-se de que o Node.js 18+ está instalado (node -v) e tente novamente npx -y @pdfmakerapi/mcp@latest.
  • Conexão / tempo limite no endpoint remoto — verifique se sua rede/proxy permite HTTPS para api.pdfmakerapi.com e se você está usando o transporte HTTP Streamable.
  • "Documento muito grande" — os documentos são limitados a ~1 MB de JSON; reduza tabelas grandes ou divida em vários documentos.
  • O link retornado não abre — copie o link completo (ele termina com um ID de documento); se der 404, gere o documento novamente.
  • Ainda com problemas? — abra uma issue no GitHub ou envie um e-mail para support@pdfmakerapi.com.

Licença

MIT