Inkrun: um MVP de SaaS para agentes de IA, construído de raiz e lançado em produção

Da ideia à plataforma em produção: extração de dados de PDFs, geração de documentos com a marca do cliente, servidor MCP para agentes de IA, API, faturação por créditos e documentação.

Cliente
Inkrun
Âmbito
Desenvolvimento de MVP · Produto SaaS de raiz · Servidor MCP e API REST · Planos, créditos e pagamentos · Site, documentação e lançamento
Tecnologia
Next.js · Model Context Protocol (MCP) · API REST · OAuth · Cloudflare
Página inicial da Inkrun, com o título “The document layer for AI agents” e um exemplo de chamadas às ferramentas extract e create_pdf
1.0
lançada em produção a 1 de julho de 2026
2
portas de entrada: servidor MCP para agentes e API REST
0 bytes
de documentos dos clientes guardados em disco

A Inkrun é uma plataforma de documentos pensada para agentes de IA. Um agente — no Claude, no ChatGPT ou num fluxo automático — recebe um PDF, retira-lhe os dados de forma estruturada e devolve um documento novo, com o aspeto da marca de quem o usa. Faturas de fornecedores, contratos, formulários oficiais, relatórios: documentos entram, dados estruturados saem, documentos com estilo voltam.

A Cottonhat desenvolveu o MVP inteiro, de raiz: do produto e da arquitetura ao site, à documentação, aos planos pagos e ao lançamento. A plataforma foi entregue em produção, a funcionar, com clientes a poder criar conta e usar a API no primeiro dia.

O desafio

  • Uma categoria nova. Os agentes de IA precisam de ler e produzir documentos, mas as ferramentas existentes foram feitas para pessoas, não para chamadas automáticas.
  • Extração que não inventa. Um modelo de linguagem devolve valores plausíveis; um processo de contas a pagar precisa de valores que estejam mesmo no documento.
  • PDFs sempre iguais. Pedir a um modelo que escreva HTML dá um documento diferente a cada vez. O milésimo PDF tem de sair igual ao primeiro.
  • Privacidade de documentos sensíveis — faturas, contratos e dados pessoais não podem ficar guardados nem servir para treinar modelos.
  • Um produto completo, não uma demonstração: contas, chaves de API, limites, planos pagos e documentação, prontos para clientes reais.

O que fizemos

Extração de dados ancorada no documento

O motor de extração lê um PDF e devolve os dados num formato estruturado — a partir de modelos prontos (fatura, recibo, termos de contrato, tabelas, texto integral) ou de um JSON Schema definido pelo cliente. Cada campo vem com grau de confiança e a página de onde saiu, para que nenhum valor seja uma adivinha. Há três níveis de extração — determinístico, com modelo e com OCR para documentos digitalizados — e uma inspeção gratuita que diz, antes de gastar créditos, quantas páginas tem o documento, se é digital ou digitalizado e quanto custará.

Geração de PDFs a partir de Markdown, sempre com a mesma marca

O agente escreve em Markdown; a Inkrun aplica um tema e um template e devolve um PDF. Os templates fixam a tipografia, as cores, o logótipo e o rodapé, e a renderização é determinística: o mesmo conteúdo produz sempre o mesmo documento, com tipos de letra incorporados e sem dependências externas. Criámos uma galeria de templates — relatórios trimestrais, propostas comerciais, atualizações para investidores, manuais técnicos, estudos de caso — e blocos próprios para faturas, orçamentos e recibos, com totais calculados automaticamente.

Servidor MCP e API REST

A plataforma tem duas portas de entrada. O servidor MCP liga-se diretamente ao Claude Desktop e ao claude.ai por OAuth, sem chaves para copiar, e a outros clientes como o Claude Code ou o ChatGPT. A API REST serve quem integra a partir do seu próprio código. Ambas partilham as mesmas ferramentas — extrair, inspecionar, extrair tabelas, preencher formulários PDF, gerar PDFs e combinar extração e geração numa só chamada — e o mesmo contador de créditos.

Um SaaS completo à volta do motor

  • Contas e autenticação, com registo por email ou GitHub e gestão de chaves de API.
  • Dashboard com editor de templates e temas e histórico de renderizações.
  • Planos e créditos — Free, Pro, Team e Enterprise — com limites por chave aplicados automaticamente.
  • Envio de PDFs por email, com links de descarga temporários.
  • Site de produto, casos de uso, blog e documentação com guia de início rápido, referência da API e guias de ligação para cada cliente MCP.

Privacidade desde a primeira linha

Os documentos são processados em memória e nunca escritos em disco, e não são usados para treinar modelos. O nível determinístico corre inteiramente nos servidores da Inkrun; quando o cliente escolhe o nível com modelo, segue apenas o texto e a estrutura extraídos, nunca o ficheiro original. A política de tratamento de dados está publicada na documentação, em linguagem clara.

O resultado

A Inkrun 1.0 foi lançada a 1 de julho de 2026 e continuou a crescer nas semanas seguintes: documentação completa e galeria de templates, histórico de renderizações e envio por email, a API de extração com o contador de créditos unificado e, em agosto, os blocos para faturas, orçamentos e recibos. Tudo sobre a mesma base construída no MVP, sem reescritas.

Um dos casos de uso publicados mostra o impacto: um gabinete de contabilidade que recebe milhares de faturas por mês em formatos diferentes passa a reemitir cada uma no seu próprio papel timbrado em segundos, em vez de minutos, sem voltar a escrever os dados à mão.

Imagens do projeto

A galeria de templates: cada PDF sai com a marca do cliente, do primeiro ao milésimo.
Casos de uso concretos, cada um resolvido com uma só chamada de ferramenta.
Documentação com início rápido, guias MCP por cliente e referência da API.
Planos pagos com créditos mensais e limites por chave aplicados automaticamente.
O site de produto no telemóvel.

Outros projetos

Painel da direcção da plataforma SMFOG, com os novos pedidos de sócio, a agenda da semana e o funil de sócios

Uma plataforma digital para uma filarmónica com mais de 110 anos

Site, plataforma de gestão e apoio informático para a filarmónica de Grândola — das quotas em papel e folhas de Excel a um só sistema, onde cada pessoa vê apenas o que lhe diz respeito.
SMFOG
Grândola · 2026