InvoiceParser Pro
Fatura para Excel com a matemática verificada: lê PDFs, digitalizações e fotos em campos e itens de linha, verifica linhas, impostos e total, retorna Excel, CSV ou JSON. Teste gratuito.
Servidor MCP hospedado
npx add-mcp 'https://api.invoiceparserpro.com/mcp'Instala no Claude Code, Codex, Cursor e outros
Documentação
Peça ao seu assistente para transformar uma fatura em uma planilha, verificar se os cálculos estão corretos ou extrair todos os campos e itens de linha. O InvoiceParser Pro lê o documento da mesma forma que faz no site, e a resposta volta no chat.
https://api.invoiceparserpro.com/mcp
As ferramentas
Quatro ferramentas, uma fatura por vez
Fatura para Excel
invoice_to_excel
Lê a fatura e retorna os campos de cabeçalho, todos os itens de linha e links de download para um arquivo Excel (.xlsx) e um arquivo CSV.
Verificar os cálculos
check_invoice
Verifica cada linha (quantidade vezes preço unitário), as linhas contra o subtotal, o imposto contra a alíquota impressa e o total. Retorna um veredito em uma linha e todos os problemas encontrados, com os números da própria fatura.
Extrair os dados
extract_invoice_data
Retorna toda a leitura como JSON: fornecedor e cliente, números e datas, número do pedido de compra, moeda, totais, linhas de imposto, todos os itens de linha e a confiança para o documento e para cada campo.
Buscar um resultado lento
get_result
Um documento que ainda está sendo lido quando uma chamada retorna vem com um job_id; o get_result o busca um pouco depois.
Configuração
Conecte seu assistente
Cada ferramenta aceita um arquivo: um link https que o servidor possa baixar (file_url), os bytes do arquivo em base64 (file_base64) ou, no ChatGPT, o arquivo anexado. PDFs e fotos de até 10 MB.
Claude (claude.ai e o aplicativo de desktop Claude)
- Abra Conectores (em Personalizar; Configurações em algumas versões) e escolha Adicionar conector personalizado.
- Dê o nome de InvoiceParser Pro, cole https://api.invoiceparserpro.com/mcp como URL e escolha Continuar. Para autenticação, mantenha “Usar a identidade publicada do Claude” (o padrão).
- Escolha entrar agora ou quando necessário. Entrar abre o InvoiceParser Pro: faça login, escolha o workspace e selecione Permitir.
- Em um chat, ative o conector no menu de ferramentas e pergunte, por exemplo: “Transforme esta fatura em uma planilha: <link>”.
Arquivos: Dê ao Claude um link https para o arquivo (um link público ou compartilhado do seu armazenamento de arquivos). O Claude pode não conseguir passar um arquivo anexado ao chat para um conector; um link sempre funciona.
Chave: Entre com sua conta do InvoiceParser Pro (OAuth). Ou, na mesma tela, em Cabeçalhos de solicitação, escolha Adicionar cabeçalho e envie Authorization com o valor Bearer ipp_mcp_… (sua chave de assistente). Sem login, o Claude usa a faixa de teste gratuito e, quando ela se esgota, mostra um botão Conectar para entrar.
Claude Code
- Adicione o servidor pelo seu terminal, com ou sem chave:
- Sem chave, execute /mcp no Claude Code e escolha entrar: seu navegador abre o InvoiceParser Pro para login e Permitir.
claude mcp add --transport http invoiceparser-pro https://api.invoiceparserpro.com/mcp
# with a key (documents go into your workspace):
claude mcp add --transport http invoiceparser-pro https://api.invoiceparserpro.com/mcp \
--header "Authorization: Bearer ipp_mcp_..."
Arquivos: O Claude Code pode ler um arquivo no seu computador e enviá-lo como base64 (file_base64) ou passar um link https (file_url).
Chave: Entre com /mcp ou envie uma chave com a linha --header acima.
ChatGPT
- Abra Configurações, depois Apps e Conectores, depois Configurações avançadas e ative o Modo de desenvolvedor (é necessário um plano pago do ChatGPT para conectores personalizados).
- Crie um conector com https://api.invoiceparserpro.com/mcp como URL e OAuth como autenticação. O ChatGPT encontra as configurações de login sozinho.
- Entre no InvoiceParser Pro quando o ChatGPT pedir, escolha o workspace e selecione Permitir.
- Em um chat, adicione o conector pelo menu +, anexe a fatura e peça a planilha ou a verificação de cálculos.
Arquivos: Anexe o arquivo no chat: as ferramentas declaram uma entrada de arquivo (os parâmetros de arquivo do Apps SDK), então o ChatGPT pode entregar à ferramenta um link de download temporário. Um link https para o arquivo também funciona.
Chave: Entre com sua conta do InvoiceParser Pro (OAuth). Sem entrar, a faixa de teste gratuito.
Cursor
- Adicione o servidor ao .cursor/mcp.json (ou às suas configurações globais de MCP):
{
"mcpServers": {
"invoiceparser-pro": {
"url": "https://api.invoiceparserpro.com/mcp",
"headers": { "Authorization": "Bearer ipp_mcp_..." }
}
}
}
Arquivos: O agente pode ler um arquivo no seu projeto e enviá-lo como base64, ou passar um link https.
Chave: Sim: a linha de cabeçalhos (deixe-a de fora para a faixa de teste gratuito).
VS Code e outros clientes MCP
- Adicione um servidor MCP remoto (HTTP) com a URL https://api.invoiceparserpro.com/mcp.. O transporte é Streamable HTTP.
{
"servers": {
"invoiceparser-pro": {
"type": "http",
"url": "https://api.invoiceparserpro.com/mcp",
"headers": { "Authorization": "Bearer ipp_mcp_..." }
}
}
}
Arquivos: file_url (um link https) ou file_base64 (os bytes do arquivo).
Chave: Qualquer cliente que possa enviar um cabeçalho HTTP pode usar uma chave.
Sem entrar
Um teste gratuito
- Até 3 documentos por dia por endereço de rede, dentro de um orçamento mensal compartilhado. Assistentes hospedados (Claude.ai, ChatGPT) compartilham seus endereços entre todos os usuários, então a cota pode já estar esgotada lá; a resposta avisa quando ela volta.
- O arquivo e seus resultados são excluídos 7 dias após o upload.
- Toda resposta termina com um link que salva os resultados em uma conta gratuita (25 faturas por mês, sem cartão).
- Links de planilha funcionam por 60 minutos, sem entrar.
Entrando ou com chave
Seu workspace, seu plano
- Entre com sua conta do InvoiceParser Pro e os documentos que você enviar vão para o workspace que você escolher e contam contra o plano desse workspace, exatamente como um upload no site: as 25 faturas por mês do plano gratuito, as faturas de um teste ou a cota de um plano pago.
- Claude, ChatGPT e Claude Code entram com OAuth: você faz login no InvoiceParser Pro, escolhe o workspace e seleciona Permitir. Os preços não mudam.
- Remova um assistente a qualquer momento em Conta, depois Sessões, depois Aplicativos conectados; ele perde o acesso na hora.
- Clientes que podem definir um cabeçalho podem usar uma chave de assistente de IA (Authorization: Bearer ipp_mcp_…), que todo plano pago cria na página de Acesso à API. Ela funciona apenas com assistentes; a API REST permanece no Scale.
Privacidade
Para onde sua fatura vai
O InvoiceParser Pro lê o documento exatamente como faz no site, com os mesmos provedores. Sem entrar ou sem chave, o arquivo e seus resultados são excluídos 7 dias após o upload, a menos que você os salve em uma conta; entrando ou com chave, o documento fica no seu workspace como qualquer upload. O teste gratuito conta os documentos de uma conexão sob um hash com chave do endereço IP, não o endereço em si. Consulte a política de privacidade e a segurança.
A empresa do seu assistente de IA vê o que você dá ao assistente (o arquivo ou o link) e o que as ferramentas retornam (campos, itens de linha, a verificação de cálculos, os links de download), sob os próprios termos dela.
Links: o servidor baixa apenas links https públicos. Endereços privados, internos e de http simples são recusados, inclusive por meio de redirecionamentos.
FAQ
Perguntas sobre o servidor MCP
Prefere usar o site?
A ferramenta gratuita transforma uma fatura em Excel no navegador, com os cálculos verificados. A API REST é documentada para desenvolvedores.