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
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:
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 decommand/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 ambiente | Padrão | Finalidade |
|---|---|---|
PDFMAKERAPI_BASE_URL | https://api.pdfmakerapi.com | Aponte 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. npxfalha ao iniciar — certifique-se de que o Node.js 18+ está instalado (node -v) e tente novamentenpx -y @pdfmakerapi/mcp@latest.- Conexão / tempo limite no endpoint remoto — verifique se sua rede/proxy permite HTTPS para
api.pdfmakerapi.come 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